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

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

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

基本的な使い方

childNodesプロパティは、Dom\Documentクラスに所属する、ドキュメントの直下の子ノードを保持するプロパティです。具体的には、DOMNodeListオブジェクトとして、ドキュメントのルートノードの全ての子ノードを順番に格納したリストを返します。

このプロパティは、DOM（Document Object Model）構造を操作する上で非常に重要です。例えば、HTML文書であれば、通常、ルートノードは<html>要素を表し、そのchildNodesプロパティは、<head>要素、<body>要素、コメントノード、テキストノードなど、<html>要素直下にある全てのノードを保持するリストとなります。

DOMNodeListオブジェクトは、配列のようにアクセスできるため、ループ処理を用いて各子ノードにアクセスし、それぞれのノードのタイプや属性、内容などを調べることができます。また、ノードの追加、削除、置換などの操作を行うことで、DOM構造を動的に変更することも可能です。

childNodesプロパティは読み取り専用であり、直接値を設定することはできません。ドキュメントの子ノードを変更するには、DOMDocumentクラスの他のメソッド（appendChild, removeChild, insertBeforeなど）を使用する必要があります。このプロパティを利用することで、ドキュメントの構造を解析し、必要な情報を抽出したり、特定のノードを操作したりすることが可能になります。Webスクレイピングや、動的なコンテンツ生成など、様々な場面で活用できる、重要なプロパティです。

構文(syntax)


1<?php
2$dom = new DomDocument();
3$dom->loadHTML('<html><body><div>Example</div></body></html>');
4$childNodes = $dom->childNodes;
5?>

引数(parameters)

引数なし

引数はありません

戻り値(return)

DOMNodeList

Dom\Document::childNodes プロパティは、現在の Dom\Document オブジェクトの子ノードをすべて含む DOMNodeList オブジェクトを返します。このリストには、要素ノード、テキストノード、コメントノードなどが含まれます。

サンプルコード

PHP DOM ChildNodesで子ノード一覧を取得する


1<?php
2
3/**
4 * Dom\Document::childNodes プロパティの動作を実演します。
5 *
6 * 指定されたHTML文字列をパースし、ドキュメントの直接の子ノード（DOMNodeList）を
7 * 取得して、その内容を標準出力に列挙します。
8 *
9 * 注: PHP 8の標準DOM拡張では `DOMDocument` クラスを使用します。
10 * リファレンスの `Dom\Document` は概念的または将来の拡張を指しますが、
11 * このコードは現在のPHP環境で動作するよう `DOMDocument` を使用しています。
12 * `childNodes` プロパティの機能は両者で共通です。
13 *
14 * @param string $html 解析対象のHTML文字列。
15 * @return void
16 */
17function demonstrateDomDocumentChildNodes(string $html): void
18{
19    $document = new DOMDocument();
20
21    // HTMLパース中の警告を抑制し、後でエラー状態をクリアします。
22    libxml_use_internal_errors(true);
23    $document->loadHTML($html);
24    libxml_clear_errors();
25
26    echo "--- Dom\\Document::childNodes プロパティの使用例 ---" . PHP_EOL;
27    echo "ドキュメントのトップレベル子ノード:" . PHP_EOL;
28
29    // `childNodes` プロパティは、ドキュメントオブジェクトの直接の子ノード全てを含む
30    // DOMNodeList オブジェクトを返します。
31    // 通常、これにはDOCTYPE宣言とルートの`<html>`要素が含まれます。
32    $childNodes = $document->childNodes;
33
34    if ($childNodes->length === 0) {
35        echo "子ノードは見つかりませんでした。" . PHP_EOL;
36        return;
37    }
38
39    // 取得した DOMNodeList を反復処理し、各子ノードの情報を表示します。
40    foreach ($childNodes as $index => $node) {
41        echo "ノード " . ($index + 1) . ":" . PHP_EOL;
42        echo "  名前: " . $node->nodeName . PHP_EOL;
43        echo "  タイプ: " . $node->nodeType . " (";
44
45        // ノードタイプを示す定数を、より分かりやすい文字列に変換して表示します。
46        switch ($node->nodeType) {
47            case XML_ELEMENT_NODE: echo "要素"; break;
48            case XML_TEXT_NODE: echo "テキスト"; break;
49            case XML_COMMENT_NODE: echo "コメント"; break;
50            case XML_DOCUMENT_TYPE_NODE: echo "DOCTYPE"; break;
51            default: echo "その他(" . $node->nodeType . ")"; break;
52        }
53        echo ")" . PHP_EOL;
54        // ノード値が長い場合は短縮して表示します。
55        echo "  値: " . ($node->nodeValue ? mb_substr($node->nodeValue, 0, 50) . (mb_strlen($node->nodeValue) > 50 ? '...' : '') : '[なし]') . PHP_EOL;
56        echo PHP_EOL;
57    }
58}
59
60// Dom\Document::childNodes の動作確認のためのサンプルHTML文字列。
61// 標準的なHTML構造には、DOCTYPE宣言とルートの<html>要素が含まれます。
62$sampleHtml = <<<HTML
63<!DOCTYPE html>
64<html>
65<head>
66    <title>PHP DOM ChildNodesの例</title>
67</head>
68<body>
69    <h1>こんにちは、DOM!</h1>
70    <p>これは、<code>Dom\\Document::childNodes</code> プロパティの動作を示すための簡単なHTMLです。</p>
71    <!-- これはHTMLコメントです -->
72</body>
73</html>
74HTML;
75
76// デモンストレーション関数を実行します。
77demonstrateDomDocumentChildNodes($sampleHtml);
78

このPHPサンプルコードは、指定されたHTML文字列を解析し、ドキュメントの最も上位に位置する直接の子ノードの情報を取得して表示します。

Dom\Document::childNodesプロパティは、文書オブジェクトの直下にある全ての子ノードを取得するために使用されます。このプロパティは引数を取らず、結果としてDOMNodeListオブジェクトを返します。DOMNodeListは、複数のノードを順番に格納するリストであり、これを使って個々のノードにアクセスできます。

PHP 8でHTMLやXMLを処理する際にはDOMDocumentクラスが主に使われますが、そのchildNodesプロパティは、リファレンスで示されるDom\Documentと同様の機能を提供します。通常、HTMLドキュメントのトップレベルの子ノードには、<!DOCTYPE html>のようなDOCTYPE宣言や、ルート要素である<html>が含まれます。

コードでは、取得したDOMNodeListを繰り返し処理し、各子ノードの名前、タイプ、値を表示することで、文書の最上位構造を具体的に確認できるようにしています。このプロパティを利用することで、HTMLやXML文書のトップレベルの要素を簡単に把握し、その構造を調査・操作することが可能になります。

このサンプルコードは、HTMLドキュメントのトップレベルの子ノードを取得する方法を示しています。リファレンスのDom\Documentは概念的ですが、現在のPHP 8ではDOMDocumentクラスを使用します。機能は共通ですのでご安心ください。childNodesプロパティは、ドキュメントの直接の子ノード全てを含むDOMNodeListオブジェクトを返します。これには通常、DOCTYPE宣言やルートの<html>要素が含まれます。HTMLパース中の警告をlibxml_use_internal_errors(true)で抑制し、処理後にlibxml_clear_errors()でクリアすることは、堅牢なエラーハンドリングの基本的な手法です。取得したDOMNodeListはforeach文で簡単に反復処理でき、各ノードのnodeNameやnodeTypeプロパティで詳細な情報を確認できます。特にnodeTypeは数値で表現されるため、コード中の定数（例: XML_ELEMENT_NODE）との対応を理解することが重要です。

PHP Dom\Document::childNodesで直接の子ノードを取得する


1<?php
2
3/**
4 * Dom\Document::childNodes プロパティと XPath を使用して、
5 * ドキュメントの直接の子ノードを走査する方法を示す関数。
6 *
7 * システムエンジニアを目指す初心者が理解しやすいように、
8 * PHP DOMの基本的な使い方と、childNodesが何であるかを簡潔に示します。
9 */
10function demonstrateDomChildNodesAndXPath(): void
11{
12    // 1. Dom\Documentの作成とHTMLの読み込み
13    // Dom\Documentクラスは、HTMLやXMLドキュメントをオブジェクトとして表現し、
14    // ドキュメント構造をプログラムから操作できるようにします。
15    $dom = new Dom\Document();
16
17    // 解析するシンプルなHTML文字列を定義します。
18    // DOCTYPE宣言、HTMLルート要素、その中の要素が含まれています。
19    $html = <<<HTML
20<!DOCTYPE html>
21<html>
22<head>
23    <title>Sample Page</title>
24</head>
25<body>
26    <h1>Hello, PHP DOM!</h1>
27    <!-- This is a comment node -->
28    <p>This is a paragraph.</p>
29</body>
30</html>
31HTML;
32
33    // HTML文字列をDom\Documentオブジェクトにロードします。
34    // PHP 8では、loadHTMLが失敗した場合にDom\Exceptionをスローする可能性があります。
35    try {
36        $dom->loadHTML($html);
37    } catch (Dom\Exception $e) {
38        echo "HTMLの読み込み中にエラーが発生しました: " . $e->getMessage() . "\n";
39        return;
40    }
41
42    echo "--- Dom\\Document::childNodes のデモンストレーション ---\n";
43    echo "このプロパティは、ドキュメントの直接の子ノードのリストを返します。\n";
44
45    // 2. Dom\Document::childNodes プロパティの使用
46    // childNodesは、ドキュメント自体の直接の子ノード（例：DOCTYPE宣言、<html>要素）を
47    // DOMNodeListオブジェクトとして返します。
48    // DOMNodeListは、foreachループで反復処理できるコレクションです。
49    $childNodes = $dom->childNodes;
50
51    foreach ($childNodes as $node) {
52        echo "  ノード名: " . $node->nodeName;
53        echo ", ノードタイプ: " . $node->nodeType; // XML_DOCUMENT_TYPE_NODE, XML_ELEMENT_NODEなど
54        // テキストノードやコメントノードの値は長くなることがあるため、表示を短縮します。
55        $nodeValue = trim($node->nodeValue);
56        echo ", 値 (抜粋): '" . (strlen($nodeValue) > 30 ? substr($nodeValue, 0, 27) . "..." : $nodeValue) . "'\n";
57    }
58
59    echo "\n--- XPathを使った直接の子ノードの取得 (類似の機能) ---\n";
60    echo "XPathもドキュメントの直接の子ノードを選択するために使用できます。\n";
61
62    // 3. Dom\XPath を使用して同様のノードを選択する
63    // Dom\XPathクラスは、Dom\Documentに対してXPathクエリを実行するために使用します。
64    $xpath = new Dom\XPath($dom);
65
66    // XPathクエリ '/node()' は、ドキュメントのすべての直接の子ノードを選択します。
67    // これは Dom\Document::childNodes プロパティが返す結果と非常に似ています。
68    $xpathChildNodes = $xpath->query('/node()');
69
70    if ($xpathChildNodes === false) {
71        echo "XPathクエリの実行中にエラーが発生しました。\n";
72        return;
73    }
74
75    foreach ($xpathChildNodes as $node) {
76        echo "  ノード名: " . $node->nodeName;
77        echo ", ノードタイプ: " . $node->nodeType;
78        $nodeValue = trim($node->nodeValue);
79        echo ", 値 (抜粋): '" . (strlen($nodeValue) > 30 ? substr($nodeValue, 0, 27) . "..." : $nodeValue) . "'\n";
80    }
81
82    echo "\n--- ドキュメントのルート要素の子ノードにアクセス ---\n";
83    echo "Dom\\Document::childNodesだけでなく、任意の要素のchildNodesも取得できます。\n";
84
85    // ドキュメントのルート要素（HTMLの場合、通常は<html>タグ）を取得します。
86    $documentElement = $dom->documentElement;
87    if ($documentElement) {
88        echo "ルート要素名: " . $documentElement->nodeName . "\n";
89        echo "ルート要素の直接の子ノード:\n";
90
91        // ルート要素（<html>）のchildNodesを反復処理します。
92        // ここには <head>、<body>、そしてそれらの間の改行などのテキストノードが含まれます。
93        foreach ($documentElement->childNodes as $childNode) {
94            // ノードタイプをチェックして、より意味のある情報を表示します。
95            if ($childNode->nodeType === XML_ELEMENT_NODE) { // 要素ノード (<head>, <body>など)
96                echo "  要素の子: " . $childNode->nodeName . "\n";
97            } elseif ($childNode->nodeType === XML_TEXT_NODE && trim($childNode->nodeValue) !== '') { // テキストノード (改行など)
98                echo "  テキストの子: '" . substr(trim($childNode->nodeValue), 0, 30) . "...'\n";
99            } elseif ($childNode->nodeType === XML_COMMENT_NODE) { // コメントノード
100                echo "  コメントの子: '" . substr(trim($childNode->nodeValue), 0, 30) . "...'\n";
101            }
102        }
103    } else {
104        echo "ドキュメント要素が見つかりませんでした。\n";
105    }
106}
107
108// 定義した関数を実行します。
109demonstrateDomChildNodesAndXPath();

Dom\Document::childNodesプロパティは、PHPでHTMLやXMLドキュメントを操作する際に、そのDom\Documentオブジェクトの「直接の子ノード」を取得するために使われます。これは引数を取らず、ドキュメントの最上位ノード（例：<!DOCTYPE html>、<html>要素）などをDOMNodeListというオブジェクトで返します。

DOMNodeListは、取得されたノードを順序付けて含むコレクションです。foreachループで各ノードを簡単に取り出して処理できます。

サンプルコードでは、HTML文字列をDom\Documentに読み込み、childNodesプロパティでドキュメント直下のノード（DOCTYPEと<html>要素）の情報を表示しています。さらに、Dom\XPathクラスの/node()クエリでも同様に直接の子ノードを選択できることを示し、類似機能を確認できます。このプロパティは、HTMLやXMLの構造をプログラムから探索・操作するための基本的な出発点となります。

Dom\Document::childNodesプロパティは、ドキュメントや特定の要素の直接の子ノードをすべて取得します。これにはHTML要素だけでなく、DOCTYPE宣言、コメント、さらには改行や空白文字のみのテキストノードも含まれることに注意してください。ノードの種類はnodeTypeプロパティで識別し、XML_ELEMENT_NODEやXML_TEXT_NODEなどを適切に判別して処理することが重要です。特にテキストノードは、trim()などで前後の空白を除去してから利用すると良いでしょう。また、Dom\Document::loadHTMLはPHP 8で例外をスローする可能性があるため、try-catchブロックでエラーを捕捉し、Dom\XPath::queryも失敗時にfalseを返すため、必ず戻り値を確認してエラーハンドリングを行うことで、安全にコードを利用できます。XPathは、より複雑な条件でノードを選択できるため、childNodesと状況に応じて使い分けると効果的です。