【PHP8.x】Dom\Text::childNodesプロパティの使い方

childNodesプロパティの使い方について、初心者にもわかりやすく解説します。

作成日: 2025年09月11日更新日: 2025年11月25日

基本的な使い方

childNodesプロパティは、Dom\Textクラスに所属する、テキストノードの子ノードリストを保持するプロパティです。具体的には、テキストノードには子ノードが存在しないため、このプロパティは常に空のDOMNodeListオブジェクトを返します。

Dom\Textクラスは、XMLドキュメントまたはHTMLドキュメント内のテキストコンテンツを表すノードです。テキストノードは、属性を持つことができず、要素ノードのように他のノードを子として持つこともできません。そのため、childNodesプロパティが返すDOMNodeListは常に空になります。

このプロパティは、主にDOM（Document Object Model）を操作する際に利用されます。DOMは、XMLやHTMLドキュメントをツリー構造として表現し、プログラムからドキュメントの構造や内容を操作するためのインターフェースを提供します。childNodesプロパティを通じて、テキストノードの子ノードにアクセスしようとしても、実際には何も取得できないということを理解しておく必要があります。

例えば、ある要素ノードのfirstChildプロパティがテキストノードを指している場合、そのテキストノードのchildNodesプロパティを参照しても、空のリストが返されるだけです。テキストノードは、それ自体がコンテンツの終端であり、子ノードを持つことが許されないからです。

したがって、childNodesプロパティは、Dom\Textクラスのインスタンスに対しては、常に空のDOMNodeListを返すという特性を理解し、DOM操作を行う際に誤った処理を行わないように注意する必要があります。このプロパティは、他のノードタイプ（要素ノードなど）において、実際に子ノードリストを取得するために使用される場面とは異なり、特殊な意味合いを持つことを意識しておくことが重要です。

構文(syntax)


1readonly public DOMNodeList $childNodes;

引数(parameters)

引数なし

引数はありません

戻り値(return)

DOMNodeList

Dom\Text クラスの childNodes プロパティは、そのテキストノード内の子ノードを保持する DOMNodeList オブジェクトを返します。

サンプルコード

PHP DOM childNodes プロパティを理解する


1<?php
2
3// Dom\Text クラスの childNodes プロパティのサンプルコード
4// テキストノードの子ノードは常に空の DOMNodeList を返します。
5
6$dom = new DOMDocument();
7$dom->loadXML('<root><element>Text Content</element></root>');
8
9$element = $dom->getElementsByTagName('element')->item(0);
10$textNode = $element->firstChild; // テキストノードを取得
11
12if ($textNode instanceof DOMText) {
13    $childNodes = $textNode->childNodes;
14
15    echo "Number of child nodes: " . $childNodes->length . PHP_EOL; // 常に 0 を出力
16}

PHPのDom\TextクラスにおけるchildNodesプロパティについて解説します。このプロパティは、テキストノードが持つ子ノードのリストをDOMNodeListオブジェクトとして返します。

Dom\Textクラスはテキストノードを表すクラスであり、テキストノードは要素ノードなどの子として存在します。しかし、テキストノード自体は子ノードを持つことができません。そのため、childNodesプロパティにアクセスすると、常に空のDOMNodeListが返されます。

サンプルコードでは、まずDOMDocumentオブジェクトを作成し、XML文字列を読み込んでいます。次に、getElementsByTagNameメソッドで'element'タグを取得し、そのfirstChildプロパティでテキストノードを取得しています。

取得したテキストノードがDOMTextクラスのインスタンスであることを確認した後、childNodesプロパティにアクセスしています。childNodesプロパティから返されたDOMNodeListオブジェクトのlengthプロパティを出力することで、子ノードの数が0であることを確認できます。

この例からわかるように、テキストノードはそれ以上の子ノードを持つことができないため、childNodesプロパティは常に空のリストを返すという特性があります。この挙動を理解しておくことで、DOMを操作する際に予期せぬエラーを防ぐことができます。

Dom\Text クラスの childNodes プロパティは、テキストノードの子ノードを取得するものですが、テキストノードは子ノードを持たないため、常に空の DOMNodeList を返します。サンプルコードでは、テキストノードを取得後に childNodes プロパティへアクセスしていますが、返されるリストは常に空である点に注意してください。childNodes->length は常に 0 を出力します。テキストノードのテキスト内容を操作したい場合は、nodeValue プロパティを使用します。DOMText オブジェクトに対して子ノードの追加や操作を行っても効果がないため、ご注意ください。

PHP XPath で p 要素の子ノードを取得する


1<?php
2
3// DOMDocument を作成
4$dom = new DOMDocument();
5
6// HTML をロード
7$dom->loadHTML('<!DOCTYPE html><html><body><p>This is a <b>bold</b> text.</p></body></html>');
8
9// XPath を使用して p 要素を取得
10$xpath = new DOMXPath($dom);
11$elements = $xpath->query('//p');
12
13// p 要素が存在する場合
14if ($elements->length > 0) {
15  // 最初の p 要素を取得
16  $p_element = $elements->item(0);
17
18  // p 要素の子ノードリストを取得
19  $childNodes = $p_element->childNodes;
20
21  // 子ノードを順番に処理
22  foreach ($childNodes as $node) {
23    // ノードタイプに応じて処理を分岐
24    switch ($node->nodeType) {
25      case XML_TEXT_NODE:
26        echo "Text Node: " . $node->textContent . "\n";
27        break;
28      case XML_ELEMENT_NODE:
29        echo "Element Node: " . $node->nodeName . "\n";
30        break;
31    }
32  }
33}
34
35?>

このPHPのサンプルコードは、Dom\TextクラスのchildNodesプロパティを使用して、HTMLドキュメント内の要素の子ノードを取得し、それらを処理する方法を示しています。

まず、DOMDocumentクラスのインスタンスを作成し、loadHTML()メソッドでHTMLドキュメントを読み込みます。次に、DOMXPathクラスを使用してXPathクエリを実行し、//pというXPath式で<p>要素を検索します。

もし<p>要素が見つかった場合、childNodesプロパティを使用して、その要素の子ノードのリスト(DOMNodeListオブジェクト)を取得します。childNodesプロパティは引数を取りません。

取得したDOMNodeListをforeachループで処理し、各ノードのタイプ (nodeTypeプロパティ) を調べて、テキストノード (XML_TEXT_NODE) か要素ノード (XML_ELEMENT_NODE) かを判断します。テキストノードの場合、textContentプロパティを使用してテキスト内容を表示し、要素ノードの場合、nodeNameプロパティを使用して要素名を表示します。

このコードは、XPathを使って特定の要素を見つけ、その要素の子ノードを順番に処理する基本的な流れを理解するのに役立ちます。childNodesプロパティは、要素の構造を解析し、その内容を操作する際に非常に便利です。戻り値のDOMNodeListは、要素の子ノードを順番にアクセスできるリストを提供します。

childNodesは、指定した要素の全ての子ノードをDOMNodeListとして返します。これは要素ノードだけでなく、テキストノード（空白や改行も含む）も含まれる点に注意が必要です。ループ処理で各ノードのタイプをnodeTypeで確認し、適切な処理を行う必要があります。特に、HTML構造によっては予期せぬテキストノードが現れることがあるため、textContentプロパティを利用する際は内容が空でないか確認すると良いでしょう。また、DOMNodeListはライブリストであるため、ループ中にノードを追加・削除すると予期せぬ動作になる可能性があります。必要であれば、配列にコピーしてから処理することを検討してください。