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

appendChildメソッドはDOMTextクラスが継承するメソッドで、ノードに新しい子ノードを追加する役割を実行するメソッドです。DOMTextクラスはPHPのDOM拡張機能において、HTMLやXMLドキュメント内の純粋なテキストコンテンツを表すノードです。このappendChildメソッド自体は、DOMTextクラスがDOMNodeクラスを継承しているため、DOMTextオブジェクトから利用できます。このメソッドは、引数として渡されたDOMNodeオブジェクトを、現在のノードの子ノードリストの末尾に追加します。正常にノードが追加された場合、その追加されたノード自身がメソッドの戻り値として返されます。

しかし、DOMの厳格なルールにより、テキストノード（DOMText）は子ノードを持つことが許可されていません。そのため、DOMTextのインスタンスに対してappendChildメソッドを呼び出すと、通常は「HierarchyRequestError」という種類のDOMExceptionが発生し、予期せぬエラーとなるでしょう。このメソッドの主な利用目的は、HTMLのタグに対応するDOMElementのような要素ノードに対して、他の要素やテキストノードなどを構造的に追加し、ドキュメントツリーを構築・変更することにあります。PHPのDOM操作において、このappendChildはドキュメントの構造を操作する上で最も基本的なメソッドの一つであり、特に要素ノードに対する利用が中心となることを理解しておくことが、システムエンジニアを目指す初心者にとって非常に重要です。

Copy
1<?php
2$dom = new DOMDocument();
3$textNode = $dom->createTextNode("既存のテキストコンテンツ");
4$childNode = $dom->createElement("span", "追加する要素");
5$textNode->appendChild($childNode);
6?>

DOMNode $node

• DOMNode $node: 追加したい子ノードを指定します

DOMNode

appendChild メソッドは、指定された DOMNode をこの DOMText ノードの末尾に追加します。追加された DOMNode オブジェクトを返します。