【PHP8.x】appendChildメソッドの使い方

appendChildメソッドは、DOMDocumentFragmentオブジェクトに新しい子ノードを追加する処理を実行するメソッドです。このメソッドは、引数として渡されたDOMNodeオブジェクトを、呼び出し元のドキュメントフラグメントが持つ子ノードリストの末尾に追加します。追加できるノードには、DOMElement（要素ノード）やDOMText（テキストノード）など、DOMNodeを継承するすべてのオブジェクトが含まれます。もし追加しようとするノードが、既にドキュメントツリー内の別の場所に存在している場合、そのノードは元の場所から自動的に削除され、新しい親であるこのフラグメントの末尾へ移動します。つまり、この操作は単なる追加ではなく、ノードの「移動」としても機能します。処理が成功した場合、戻り値として追加されたノードオブジェクトそのものを返します。何らかの理由でノードの追加に失敗した場合はfalseを返します。このメソッドは、複数のノードを一度にまとめて構築し、後からドキュメントの特定の位置へ一括で挿入する、といった効率的なDOM操作で役立ちます。

Copy
1<?php
2// DOMDocumentオブジェクトを作成します
3$doc = new DOMDocument();
4
5// ドキュメントフラグメントを作成します
6$fragment = $doc->createDocumentFragment();
7
8// 新しい要素ノードを作成します
9$element = $doc->createElement('p', 'This is a paragraph.');
10
11// ドキュメントフラグメントの末尾に要素ノードを追加します
12// bool(true)が返ります (成功した場合)
13$result = $fragment->appendChild($element);
14
15// 確認のため、フラグメントをドキュメントに追加してHTMLとして出力します
16$doc->appendChild($fragment);
17echo $doc->saveHTML();
18?>

DOMNode $node

• DOMNode $node: 追加したいDOMNodeオブジェクト

DOMNode

DOMDocumentFragmentに子ノードを追加した結果として、追加された子ノード（DOMNodeオブジェクト）が返されます。