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

childNodesプロパティは、Dom\Entityオブジェクトが持つ子ノードのリストを保持するプロパティです。Dom\Entityは、XMLやHTMLドキュメント内で定義された実体（エンティティ）を表す特殊なノードです。例えば、XMLドキュメントのDTD（Document Type Definition）で定義されたエンティティがドキュメント内で参照された場合、そのエンティティの実体の内容がパースされ、その結果として生じる子ノード群がこのchildNodesプロパティによって提供されます。

このプロパティが保持する値は、Dom\NodeListオブジェクトです。Dom\NodeListは、読み取り専用のノードのコレクションであり、エンティティの実体に含まれるすべての子要素やテキストノードなどを、定義された順序で参照することを可能にします。これにより、エンティティが実際に展開されたときにどのような構造や内容を持つのかをプログラムから詳細に調べることができます。

具体的には、ドキュメント内でエンティティ参照を見つけ、その実体がどのような構成になっているかを解析したい場合に、このchildNodesプロパティを利用します。例えば、エンティティが複数のテキストノードや要素ノードから構成されている場合、それらのノードにアクセスして内容を抽出したり、特定の条件に基づいて処理を行ったりする際に非常に有用です。このプロパティは、複雑なXMLドキュメントの構造を理解し、その中から特定の情報を抽出する作業において、重要な役割を果たします。

Copy
1<?php
2$document = new Dom\Document();
3$document->loadXML('<!DOCTYPE root [<!ENTITY myentity "entity content">]><root/>');
4$entity = $document->doctype->entities->item(0);
5
6$childNodesList = $entity->childNodes;

引数なし

引数はありません

Dom\NodeList

Dom\Entity オブジェクトの子ノードのリストを Dom\NodeList オブジェクトとして返します。