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

appendChildメソッドは、指定されたノードを既存のノードの子ノードリストの末尾に追加するメソッドです。このメソッドは、PHPのDOM拡張における基底クラスであるDom\Nodeから継承されており、Dom\TextクラスもDom\Nodeを継承しているため、このメソッドを持ちます。

Dom\Textクラスは、DOMツリー内のテキストデータを表すノードであり、具体的にはHTMLやXML文書の要素の内容（例えば、<p>これはテキストです</p>の「これはテキストです」の部分）を扱います。テキストノードは、通常、子ノードを持つことができません。テキストデータそのものが末端のノードとして機能するため、その内部に別の要素やテキストノードを追加するような階層構造は想定されていません。

そのため、Dom\Textオブジェクトに対してappendChildメソッドを呼び出し、子ノードを追加しようとすると、DOMの階層構造のルールに違反します。この操作は無効なものと見なされ、通常はDom\HierarchyRequestErrorというエラー（例外）を発生させます。これは、追加しようとしているノードの種類や、親となるDom\Textノードの性質上、その位置にノードを追加することができないことを示しています。

システムエンジニアを目指す初心者の方々にとっては、appendChildメソッドがDom\Textクラスに存在していても、実際にテキストノードに対して子ノードを追加する用途には使えず、むしろエラーの原因となる点を理解することが重要です。DOMツリーを操作する際は、ノードのタイプとそのノードが持ちうる子ノードのタイプを考慮し、適切な操作を行う必要があります。

Copy
1<?php
2
3$document = new DOMDocument();
4
5// Dom\Text クラスのインスタンス (親ノード)
6$textNode = $document->createTextNode('Original text.');
7
8// Dom\Node を継承する任意のクラスのインスタンス (子ノード)
9$childNode = $document->createElement('span', 'Appended content.');
10
11// Dom\Text::appendChild メソッドの構文
12// 親ノードとなる Dom\Text オブジェクトから呼び出し、引数に子ノードオブジェクトを渡します。
13// 戻り値は追加された子ノードオブジェクトです。
14$appendedNode = $textNode->appendChild($childNode);
15
16?>

Dom\Node $node

• Dom\Node $node: 追加する子ノードを指定するDom\Nodeオブジェクト

Dom\Node

このメソッドは、新しく追加された子ノードである Dom\Node オブジェクトを返します。