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

Copy
1<?php
2
3// ドキュメントを新規作成
4$dom = new DOMDocument('1.0', 'UTF-8');
5
6// ルート要素を作成
7$root = $dom->createElement('root');
8$dom->appendChild($root);
9
10// 新しい子要素を作成
11$child = $dom->createElement('child');
12
13// テキストノードを作成し、子要素に追加
14$text = $dom->createTextNode('Hello, world!');
15$child->appendChild($text);
16
17// ルート要素に子要素を追加
18$root->appendChild($child);
19
20// 結果を出力
21echo $dom->saveXML();
22
23?>

このPHPのサンプルコードは、DOMDocumentオブジェクトを使ってXMLドキュメントを操作し、appendChildメソッドを使って要素を追加する方法を示しています。

まず、DOMDocumentクラスのインスタンスを作成し、XMLドキュメントのルート要素となる<root>要素を作成します。appendChildメソッドは、DOMNodeクラスのメソッドで、指定されたノードを、現在のノードの子ノードとして追加します。ここでは、$dom->appendChild($root)によって、<root>要素がドキュメントのルート要素として追加されます。

次に、<child>要素を作成し、その中にテキストノード "Hello, world!" を追加しています。ここでもappendChildメソッドが使われており、$child->appendChild($text)によってテキストノードが<child>要素の子ノードとして追加されます。

最後に、$root->appendChild($child)によって、<child>要素が<root>要素の子ノードとして追加されます。appendChildメソッドは、引数に指定されたDOMNodeオブジェクト（この場合は<child>要素）を、メソッドを呼び出したオブジェクト（この場合は<root>要素）の子ノードとして追加し、追加されたノード（この場合は<child>要素）を返します。

$dom->saveXML()は、作成されたXMLドキュメントを文字列として出力します。このコードを実行すると、<root>要素の中に<child>要素が含まれ、さらに<child>要素の中に "Hello, world!" というテキストノードが含まれたXMLドキュメントが出力されます。この例を通して、appendChildメソッドがDOMツリーを構築する上で重要な役割を果たすことがわかります。

Copy
1<?php
2
3// 新しい要素を既存の要素の子として追加する例
4$dom = new DOMDocument();
5$dom->loadXML('<root><parent><child1>value1</child1></parent></root>');
6
7// 追加したい要素を作成
8$newChild = $dom->createElement('child2', 'value2');
9
10// 追加先の親要素を取得
11$parent = $dom->getElementsByTagName('parent')->item(0);
12
13// 親要素に新しい子要素を追加
14if ($parent) {
15    $newNode = $parent->appendChild($newChild);
16
17    // 結果を出力
18    echo $dom->saveXML();
19} else {
20    echo "Parent element not found.\n";
21}
22
23?>

PHPのDOMDocumentクラスにおけるappendChildメソッドは、既存のノード（要素）に新しい子ノードを追加するために使用します。このメソッドは、Dom\Nodeクラスに所属しており、DOM操作の中核を担います。

具体的には、appendChild(DOMNode $node)という形式で呼び出されます。引数$nodeには、追加したいDOMNodeオブジェクトを指定します。これは、createElementメソッドなどで事前に作成された要素である必要があります。

サンプルコードでは、まずDOMDocumentオブジェクトを作成し、XML文字列を読み込んでDOM構造を構築しています。その後、createElementメソッドを用いて新しい要素child2を作成し、値を設定しています。

次に、getElementsByTagNameメソッドを使って、XMLドキュメント内のparent要素を取得しています。この要素が、新しい子要素を追加する対象となります。

appendChildメソッドの重要な点は、指定された親ノード（ここではparent要素）に、引数で渡された$newChildノードを子要素として追加するということです。appendChildメソッドは、追加された新しいノード（$newNode）を返します。

もし、指定された親要素が見つからない場合は、エラーメッセージを出力するようにしています。最後に、saveXMLメソッドを使って、変更が加えられたXMLドキュメント全体を文字列として出力しています。この出力結果から、child2要素がparent要素の子要素として正しく追加されたことが確認できます。appendChildメソッドは、XMLドキュメントの構造を動的に変更する際に非常に便利なメソッドです。