【PHP8.x】Dom\HTMLDocument::hasChildNodes()メソッドの使い方

hasChildNodesメソッドの使い方について、初心者にもわかりやすく解説します。

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

基本的な使い方

hasChildNodesメソッドは、Dom\HTMLDocumentオブジェクトが子ノードを保持しているかを確認するメソッドです。PHP 8のDOM拡張機能の一部として提供されており、ウェブページなどのHTMLドキュメントの構造をプログラムで操作する際に利用されます。このメソッドは、呼び出されたDom\HTMLDocumentのインスタンスに、要素、テキストノード、コメント、処理命令などの子ノードが一つでも存在するかどうかを検査し、その結果を真偽値で返します。具体的には、子ノードが一つでも存在すればtrueを返し、子ノードが一つも存在しなければfalseを返します。

システムエンジニアを目指す初心者の方にとって、このメソッドはHTMLドキュメントのツリー構造を安全かつ効率的に扱う上で非常に重要です。例えば、HTMLドキュメント全体が空であるかどうかを最初にチェックしたり、特定のHTML要素にさらに内部のコンテンツや子要素が含まれているかを判断したりする際に役立ちます。子ノードの有無を事前に確認することで、存在しない子ノードに対してアクセスしようとした際に発生する可能性のあるエラーや例外を防ぎ、プログラムの安定性を高めることができます。このメソッドを活用することで、HTMLドキュメントの解析や修正処理を、より堅牢で信頼性の高い方法で進めることが可能になります。

構文(syntax)


1<?php
2
3$html_string = '<html><body><p>Hello</p></body></html>';
4
5// Dom\HTMLDocument オブジェクトを作成
6$doc = new Dom\HTMLDocument();
7
8// HTML文字列を読み込む
9$doc->loadHTML($html_string);
10
11// body要素が子ノードを持つか確認
12// hasChildNodes() は Dom\Node クラスのメソッドであり、
13// Dom\HTMLDocument やその中の要素 (Dom\Element) で使用できます。
14if ($doc->documentElement->hasChildNodes()) {
15    var_dump(true); // => bool(true) body要素が存在するため
16} else {
17    var_dump(false);
18}
19
20?>

引数(parameters)

引数なし

引数はありません

戻り値(return)

bool

このメソッドは、対象のDOM要素に子ノードが存在するかどうかを示す真偽値（trueまたはfalse）を返します。

サンプルコード

Dom\HTMLDocumentのhasChildNodes()で子ノードを確認する


1<?php
2
3// Dom\HTMLDocument クラスを使用するためには、PHPの Dom エクステンションが有効になっている必要があります。
4
5/**
6 * Dom\HTMLDocument クラスを使用して、特定のHTML要素が子ノードを持っているかを
7 * hasChildNodes() メソッドで確認するサンプルです。
8 * hasChildNodes() メソッドは、引数なしで呼び出され、ノードが子ノードを持っていれば true、そうでなければ false を返します。
9 */
10function demonstrateHasChildNodes(): void
11{
12    // --- ケース1: 子ノードを持つHTMLドキュメントの例 ---
13    $htmlWithChildren = '
14        <!DOCTYPE html>
15        <html>
16        <head>
17            <title>ドキュメント1</title>
18        </head>
19        <body>
20            <p>これは子ノードです。</p>
21            <div>別の要素も子ノードです。</div>
22        </body>
23        </html>
24    ';
25
26    $docWithChildren = new Dom\HTMLDocument();
27    // HTML文字列をロードしてDOMツリーを構築します
28    $docWithChildren->loadHTML($htmlWithChildren);
29
30    // body要素を取得します。body要素は通常、多くのHTMLコンテンツの子ノードを持ちます。
31    $bodyElementWithChildren = $docWithChildren->getElementsByTagName('body')->item(0);
32
33    if ($bodyElementWithChildren !== null) {
34        echo "--- ケース1: body要素が子ノードを持つ場合 ---\n";
35        // body要素が子ノードを持っているかを確認します
36        if ($bodyElementWithChildren->hasChildNodes()) {
37            echo "結果: body要素は子ノードを持っています。\n";
38        } else {
39            echo "結果: body要素は子ノードを持っていません。\n";
40        }
41        echo "\n";
42    }
43
44    // --- ケース2: 子ノードを持たないHTMLドキュメントの例 ---
45    $htmlWithoutChildren = '
46        <!DOCTYPE html>
47        <html>
48        <head>
49            <title>ドキュメント2</title>
50        </head>
51        <body>
52        </body>
53        </html>
54    ';
55
56    $docWithoutChildren = new Dom\HTMLDocument();
57    // HTML文字列をロードしてDOMツリーを構築します
58    $docWithoutChildren->loadHTML($htmlWithoutChildren);
59
60    // body要素を取得します。この例ではbody要素は子ノードを持たないはずです。
61    $bodyElementWithoutChildren = $docWithoutChildren->getElementsByTagName('body')->item(0);
62
63    if ($bodyElementWithoutChildren !== null) {
64        echo "--- ケース2: body要素が子ノードを持たない場合 ---\n";
65        // body要素が子ノードを持っているかを確認します
66        if ($bodyElementWithoutChildren->hasChildNodes()) {
67            echo "結果: body要素は子ノードを持っています。\n";
68        } else {
69            echo "結果: body要素は子ノードを持っていません。\n";
70        }
71    }
72}
73
74// 上記の関数を実行して、hasChildNodes() メソッドの動作を確認します。
75demonstrateHasChildNodes();

PHPのDom\HTMLDocumentクラスに属するhasChildNodes()メソッドは、特定のHTML要素が子ノードを持っているかを確認するための機能を提供します。このメソッドは、ウェブページの内容をPHPで解析し、特定の要素の下にさらに要素やテキストが存在するかをプログラム的に判断したい場合に非常に便利です。

hasChildNodes()メソッドは引数を一切取りません。呼び出すと、対象の要素が一つでも子ノード（テキストノードや他のHTML要素など）を持っていればtrueを、子ノードが全く存在しない場合はfalseをブール値として返します。

提供されたサンプルコードでは、まず子ノードを持つ<body>要素を含むHTMLドキュメントと、子ノードを持たない空の<body>要素を含むHTMLドキュメントの二つのケースを扱っています。最初のケースでは、<body>要素内に<p>タグや<div>タグといった子ノードが含まれているため、hasChildNodes()メソッドはtrueを返します。一方、二つ目のケースでは<body>要素が空であり、子ノードが一つも存在しないため、このメソッドはfalseを返します。このように、hasChildNodes()を使用することで、HTML構造を動的に解析し、条件に応じた処理を行うことが可能になります。

PHPのDomエクステンションが有効であることを確認してください。hasChildNodes()は、対象のHTML要素が存在しない（nullである）場合、エラーの原因となるため、呼び出す前に必ず要素のnullチェックを行ってください。また、このメソッドは、HTML要素だけでなく、要素間の改行やスペースといったテキストノードも子ノードとして扱います。そのため、見た目上は子要素がないように見えても、実は空白文字などがテキストノードとして存在し、trueを返す場合があります。この挙動を理解して利用することが、意図しない結果を防ぐ上で非常に重要です。

PHP Dom\HTMLDocument::hasChildNodes()で子ノードを判定する


1<?php
2
3/**
4 * Dom\HTMLDocument::hasChildNodes() メソッドの使用例を示します。
5 * このメソッドは、指定されたノードが子ノードを持っているかどうかを判定します。
6 *
7 * システムエンジニアを目指す初心者の方へ:
8 * Webページ（HTML）の構造をプログラムで操作する際に、
9 * ある要素の中にさらに別の要素（子要素）があるかどうかを
10 * 簡単な真偽値（true/false）で確認したい場合に非常に便利です。
11 * jQueryなどのライブラリにおける `hasChildNodes()` の概念と似ています。
12 */
13function demonstrateHasChildNodes(): void
14{
15    // 1. サンプルとなるHTMLコンテンツを定義します。
16    //    - <body> 要素には、<h1> と <p> という子ノードがあります。
17    //    - <div id="empty-container"> 要素は、子ノードを持っていません。
18    $htmlContent = <<<HTML
19<!DOCTYPE html>
20<html>
21<head>
22    <title>hasChildNodes() サンプル</title>
23</head>
24<body>
25    <h1>ようこそ</h1>
26    <p>PHPのDOM操作の例です。</p>
27    <div id="empty-container"></div>
28</body>
29</html>
30HTML;
31
32    // 2. Dom\HTMLDocument オブジェクトをインスタンス化します。
33    //    これはHTMLドキュメント全体を表現するオブジェクトです。
34    $document = new Dom\HTMLDocument();
35
36    // 3. 定義したHTMLコンテンツをドキュメントにロードします。
37    //    これで、PHPでHTMLの構造をプログラム的に操作できるようになります。
38    $document->loadHTML($htmlContent);
39
40    echo "--- Dom\\HTMLDocument::hasChildNodes() デモンストレーション ---\n\n";
41
42    // 4. ドキュメント自体の子ノードの有無をチェックします。
43    //    HTMLドキュメントは通常、<!DOCTYPE html> や <html> といった子ノードを持ちます。
44    echo "ドキュメント全体の子ノードチェック:\n";
45    if ($document->hasChildNodes()) {
46        echo "  - ドキュメントは子ノードを持っています。\n";
47    } else {
48        echo "  - ドキュメントは子ノードを持っていません。\n";
49    }
50    echo "\n";
51
52    // 5. <body> 要素を取得し、子ノードの有無をチェックします。
53    //    getElementsByTagName() は、タグ名で要素を検索し、Dom\HTMLCollection を返します。
54    //    item(0) で最初に見つかった <body> 要素を取得します。
55    $bodyElement = $document->getElementsByTagName('body')->item(0);
56
57    if ($bodyElement) {
58        echo "<body> 要素の子ノードチェック:\n";
59        if ($bodyElement->hasChildNodes()) {
60            echo "  - <body> 要素は子ノードを持っています。(<h1>, <p>など)\n";
61        } else {
62            echo "  - <body> 要素は子ノードを持っていません。\n";
63        }
64    } else {
65        echo "  - <body> 要素が見つかりませんでした。\n";
66    }
67    echo "\n";
68
69    // 6. IDが "empty-container" の <div> 要素を取得し、子ノードの有無をチェックします。
70    //    getElementById() は、指定されたIDを持つ要素を直接取得します。
71    $emptyContainer = $document->getElementById('empty-container');
72
73    if ($emptyContainer) {
74        echo "<div id=\"empty-container\"> 要素の子ノードチェック:\n";
75        if ($emptyContainer->hasChildNodes()) {
76            echo "  - <div id=\"empty-container\"> 要素は子ノードを持っています。\n";
77        } else {
78            echo "  - <div id=\"empty-container\"> 要素は子ノードを持っていません。\n";
79        }
80    } else {
81        echo "  - <div id=\"empty-container\"> 要素が見つかりませんでした。\n";
82    }
83    echo "\n";
84}
85
86// 上記のデモンストレーション関数を実行します。
87demonstrateHasChildNodes();
88
89?>

Dom\HTMLDocument::hasChildNodes()は、特定のHTML要素（ノード）が子ノードを持っているかどうかを判定するPHPのメソッドです。このメソッドは引数を取らず、子ノードが存在すれば真偽値のtrueを、存在しなければfalseを戻り値として返します。

システムエンジニアを目指す初心者の方にとって、Webページ（HTML）の構造をプログラムで操作する際に、ある要素の中にさらに別の要素（子要素）があるかどうかを手軽に確認できる点が非常に便利です。これは、jQueryなどのライブラリにおいて、要素の子ノードの有無を調べる概念と似ています。

サンプルコードでは、まずHTMLコンテンツをDom\HTMLDocumentオブジェクトに読み込み、このメソッドの具体的な使い方を示しています。例として、HTMLドキュメント全体、子要素を持つ<body>要素、そして子要素を持たない<div id="empty-container">要素の三つのケースでhasChildNodes()を実行しています。ドキュメント全体や<body>要素は内部に他の要素を持つためtrueが返され、コンテンツを持つことを示します。一方、<div id="empty-container">要素は空であるため、falseが返される結果となります。このように、このメソッドを使用することで、HTML要素の子要素の有無をプログラムで簡単に判断し、その結果に基づいて処理を分岐させることが可能です。

Dom\HTMLDocument::hasChildNodes()メソッドは、特定のHTML要素が子ノードを持っているかを真偽値で判定します。このメソッドを使用する際は、PHPのDOM拡張機能がサーバー環境で有効になっているか確認してください。HTMLドキュメントをロードした後、getElementByIdなどで取得した要素が実際に存在するかを必ずチェックしてからメソッドを呼び出しましょう。存在しない要素に対して呼び出すとエラーが発生する可能性があります。また、DOMにおける子ノードには、HTMLタグで囲まれた要素だけでなく、要素間の改行や空白、テキストなどもテキストノードとして含まれることに注意が必要です。これにより、見た目上は空に見えても、改行などのテキストノードが存在してtrueを返す場合があります。jQueryの同名機能と概念は似ていますが、厳密な挙動は異なる可能性がある点も覚えておくと良いでしょう。