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

appendメソッドは、PHP 8のDOMDocumentクラスにおいて、ドキュメントのDOMツリーに新しいノードを追加する操作を実行するメソッドです。厳密には、DOMDocumentクラス自体に「append」という名前のメソッドは直接提供されていませんが、DOMDocumentクラスがDOMNodeクラスを継承しており、そのDOMNodeクラスが持つappendChildメソッドがこの「追加」の役割を担います。

このメソッドは、指定されたDOMNodeオブジェクトを、現在のノードの子ノードリストの末尾に挿入することで、DOMツリーの構造を構築または変更します。例えば、新しいXMLドキュメントを作成し、そのルート要素となるDOMElementノードをドキュメントに追加したり、既存の要素ノードに対して子要素やテキストノードを組み込んだりする際に利用されます。

重要な点として、追加されるノードが既に他の親ノードの子である場合、この追加処理はそのノードを既存の親ノードから自動的に切り離し、新しい親ノードの子として移動させます。これにより、ノードが複数の親を持つことはなく、常に一貫したツリー構造が保たれます。DOMツリーを動的に操作し、XMLやHTMLなどの構造化された文書をプログラムで生成したり、修正したりするための基本的な機能として、システム開発において幅広く活用されます。

Copy
1<?php
2$dom = new DOMDocument();
3
4// ドキュメントのルート要素として機能するDOMElementを作成します
5$rootElement = $dom->createElement('html');
6
7// DOMDocument::append() メソッドを使用して、DOMDocumentの直下にノードを追加します
8// この例では、$rootElement がドキュメントのルート要素として追加されます
9$dom->append($rootElement);

DOMNode|string ...$nodes

• DOMNode|string $nodes: 追加するDOMNodeオブジェクトまたはXML文字列。複数指定可能

void

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