【PHP8.x】childNodesプロパティの使い方

childNodesプロパティは、DOMNodeListオブジェクトを保持するプロパティです。このプロパティは、PHPのDOM拡張機能において、XMLドキュメントの構造を操作する際に使用されるDOMEntityクラスに属しています。

DOMEntityクラスは、XMLドキュメントのエンティティ（実体）の定義を表します。エンティティとは、XMLドキュメント内で再利用可能なデータの塊に名前を付けて定義する仕組みです。例えば、&のような文字参照や、DTD（Document Type Definition）内で定義される複雑な構造を持つ外部エンティティなどがこれにあたります。

DOMEntityオブジェクトのchildNodesプロパティは、そのエンティティの定義内に含まれる全ての子ノードのリストをDOMNodeListとして返します。このDOMNodeListは、子ノードの集合を読み取り専用で扱うためのインターフェースを提供します。具体的には、エンティティ定義が例えば <p>Hello, <strong>World!</strong></p> のような構造を持つ場合、childNodesプロパティは<p>要素ノードをリストとして提供します。このプロパティは、XMLドキュメントの型定義（DTDなど）に記述されたエンティティの内部構造をプログラム的に解析したい場合に特に有用です。

しかし、DOMEntityオブジェクト自体は、XMLドキュメントの実際のDOMツリー内に直接挿入されるノードではありません。これはあくまで「エンティティの定義そのもの」を表すものです。実際のドキュメントコンテンツでエンティティが参照された場合（例: &myEntity;）、その場所にはエンティティ参照を表すDOMEntityReferenceノード、またはパーサーによって展開されたエンティティの実際のコンテンツが配置されます。したがって、DOMEntity::childNodesプロパティは、エンティティ参照が展開された結果のノードではなく、エンティティの「定義」が持つ子ノードをリストアップする目的で使用されます。このプロパティを通じて、XMLドキュメントの構造やその型定義におけるエンティティの構成を詳細に分析することが可能になります。

Copy
1<?php
2$dom = new DOMDocument();
3$dom->loadXML('<!DOCTYPE root [<!ENTITY example "Hello <b>World</b>!">]><root/>');
4
5// "example" という名前のエンティティを取得
6$entity = $dom->doctype->entities->getNamedItem('example');
7
8if ($entity) {
9    // DOMEntity::childNodes プロパティにアクセス
10    $nodes = $entity->childNodes;
11
12    // 子ノードを順に表示
13    foreach ($nodes as $node) {
14        echo $node->nodeName . ": " . $node->nodeValue . "\n";
15    }
16}
17?>

引数なし

引数はありません

DOMNodeList

DOMEntityオブジェクトの子ノードをDOMNodeListオブジェクトとして取得します。このリストには、エンティティのすべての子ノードが含まれます。