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

appendメソッドは、Dom\Elementクラスのインスタンスに対して、一つまたは複数の新しい子ノードを追加するメソッドです。このメソッドは、HTMLやXMLなどの文書構造を表現するDOM（Document Object Model）において、特定の要素のコンテンツを動的に変更・拡張する際に使用されます。

appendメソッドは、引数としてDom\Nodeオブジェクト、または文字列を受け取ることができます。複数の引数を指定することも可能です。もし引数がDom\Nodeオブジェクトである場合、そのノードが現在の要素の最後の子ノードとして追加されます。これにより、既存の要素の中に別の要素やコメント、処理命令などを組み込むことが可能になります。

一方、引数が文字列として与えられた場合、その文字列は自動的にDom\Textノードとして解釈され、現在の要素の末尾に追加されます。これにより、要素のテキストコンテンツを直接追記することができます。

このメソッドを活用することで、例えばWebアプリケーションでユーザーの操作に応じてコンテンツを生成したり、テンプレートの一部をプログラム的に埋め込んだりするなど、柔軟なDOM操作を実現できます。appendメソッドは処理の成功に関わらず値を返しません。

Copy
1<?php
2
3$document = new Dom\Document();
4$parentElement = $document->createElement('container');
5$document->appendChild($parentElement);
6
7$textNodeContent = 'Some text content.';
8$childElement = $document->createElement('item');
9$childElement->textContent = 'An item element.';
10
11// Dom\Element::append メソッドの構文例
12$parentElement->append($textNodeContent, $childElement, 'More text here.');
13
14echo $document->saveXML();
15
16?>

Dom\Node|string ...$nodes

• Dom\Node|string ...$nodes: 追加したいDOMノードまたはHTML文字列を指定します。複数指定可能です。

void

このメソッドは、指定されたノードを現在の要素の末尾に追加します。戻り値はありません。