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

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

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

基本的な使い方

hasChildNodesメソッドは、DOMAttrオブジェクトが子ノードを持っているかどうかを判定するメソッドです。DOMAttrは、XMLやHTMLドキュメント内で要素に付加される属性（attribute）を表すクラスです。例えば、<div id="main">というHTML要素におけるid="main"の部分がDOMAttrオブジェクトとして扱われます。

このhasChildNodesメソッドは、呼び出されたDOMAttrオブジェクトが1つ以上の子ノードを持っている場合にtrue（真）を返し、子ノードを全く持たない場合にfalse（偽）を返します。DOMAttrオブジェクトの場合、その子ノードは通常、属性の値を表すDOMTextノードのみとなります。つまり、このメソッドは、対象の属性が空ではないテキスト値を持っているかどうかを確認する際に役立ちます。

システムエンジニアを目指す初心者の方にとって、このメソッドは、XMLやHTMLドキュメントをPHPで解析・操作する際に、特定の属性に値が設定されているか、あるいはその値が空ではないかといった条件分岐を行う場面で非常に有用です。例えば、特定の属性に値が存在する場合のみ処理を実行するといったロジックを実装する際に活用できます。戻り値は真偽値（bool型）であるため、条件式に直接使用できます。

構文(syntax)


1<?php
2$dom = new DOMDocument();
3$element = $dom->createElement('node');
4$attribute = $dom->createAttribute('id');
5$attribute->value = 'some_id';
6$element->appendChild($attribute);
7
8// DOMAttr オブジェクトを取得
9$domAttr = $element->attributes->getNamedItem('id');
10
11// hasChildNodes メソッドを呼び出す
12$domAttr->hasChildNodes();

引数(parameters)

引数なし

引数はありません

戻り値(return)

bool

このメソッドは、DOMAttrオブジェクトに子ノードが存在するかどうかを示すブール値（trueまたはfalse）を返します。

サンプルコード

DOMAttr::hasChildNodes() が false を返す例


1<?php
2
3/**
4 * DOMAttr::hasChildNodes() メソッドのサンプル
5 *
6 * DOMAttr オブジェクトが子ノードを持つかどうかを確認します。
7 * PHP の DOMAttr オブジェクトは、常に子ノードを持たないため、
8 * このメソッドは常に false を返します。
9 */
10
11// DOMDocument インスタンスを作成
12$dom = new DOMDocument('1.0', 'UTF-8');
13$dom->formatOutput = true; // 出力を見やすく整形
14
15// ルート要素を作成し、ドキュメントに追加
16$rootElement = $dom->createElement('exampleRoot');
17$dom->appendChild($rootElement);
18
19// 属性を作成
20$attribute = $dom->createAttribute('data-id');
21// 属性値を設定 (これはDOMAttrのnodeValueであり、子ノードではありません)
22$attribute->nodeValue = '12345';
23
24// ルート要素に属性を追加
25$rootElement->setAttributeNode($attribute);
26
27// DOMAttr::hasChildNodes() メソッドを呼び出し、子ノードがあるか確認
28// このメソッドは常に false を返します。
29$hasChildren = $attribute->hasChildNodes();
30
31// 結果を出力
32echo "属性名: " . $attribute->name . "\n";
33echo "属性値: " . $attribute->nodeValue . "\n";
34echo "この属性に子ノードがあるか？: ";
35var_dump($hasChildren); // 結果は常に bool(false) となります
36
37// 参考として、生成されたXMLを表示
38// echo "\n生成されたXML:\n";
39// echo $dom->saveXML();
40
41?>

PHPのDOMAttr::hasChildNodes()メソッドは、XMLやHTMLの要素に付与される「属性」を表すDOMAttrオブジェクトが、子ノードを持っているかどうかを確認するためのものです。このメソッドは引数を取らず、子ノードが存在すればtrueを、存在しなければfalseを真偽値（bool）で返します。

しかし、PHPにおけるDOMAttrオブジェクトは、その性質上、子ノードを持つことはありません。属性の値（例えば、<div data-id="12345">における12345の部分）は、属性自体の値であり、「子ノード」とは異なる概念です。そのため、DOMAttrオブジェクトに対してhasChildNodes()メソッドを呼び出すと、常にfalseが返されるという特徴があります。

提供されたサンプルコードでは、まずDOMDocumentを作成し、data-idという属性を持つ要素を生成しています。次に、このdata-id属性を表すDOMAttrオブジェクトを取得し、それに対してhasChildNodes()メソッドを呼び出しています。結果として、出力ではbool(false)が表示され、属性が子ノードを持たないことが明確に示されています。この挙動は、DOMにおける属性と子ノードの概念を理解する上で重要な点となります。

DOMAttr::hasChildNodes()メソッドは、属性に値が設定されていても常にfalseを返しますので注意が必要です。これは、PHPのDOMにおいて、属性に設定される値は子ノードではなく、属性自身の値（nodeValue）として扱われるためです。初心者は、属性値があると子ノードとして認識されると誤解しやすい点に特に注意してください。

このメソッドは、DOMAttrオブジェクトがDOMの構造上、子ノードを持つことがないという仕様を理解するために用いられます。属性が何らかの値を持っているかを確認したい場合は、nodeValueプロパティが空でないかなどを直接確認する方法が適切です。常にfalseが返ることを前提に利用してください。

PHP DOMAttr hasChildNodes() の挙動


1<?php
2
3/**
4 * DOMAttrオブジェクトの子ノードの有無をチェックするPHPのサンプルコード。
5 *
6 * この関数は、PHPのDOM拡張機能におけるDOMAttrクラスのhasChildNodes()メソッドの
7 * 使用方法と挙動をシステムエンジニアを目指す初心者向けに示します。
8 *
9 * DOMAttr::hasChildNodes() は、属性がその値（テキストノード）を子ノードとして
10 * 持っているかどうかを返します。
11 * 属性値が設定されていれば（空文字列を含む）、通常 true を返します。
12 * 属性値がまだ設定されていない場合にのみ false を返します。
13 *
14 * jQueryなどのクライアントサイドJavaScriptで要素の子ノード有無をチェックする
15 * 概念に似ていますが、PHPのDOMAttrは「属性自体」が「その値」をテキストノードとして
16 * 持っているか、という点に注目する点が異なります。
17 *
18 * @return void
19 */
20function checkDomAttrChildNodesExample(): void
21{
22    echo "--- DOMAttr::hasChildNodes() の挙動 ---" . PHP_EOL . PHP_EOL;
23
24    // 1. DOMAttrオブジェクトを新しく作成した場合の挙動
25    //    属性値がまだ設定されていない状態。
26    $dom = new DOMDocument();
27    $newAttr = $dom->createAttribute('testAttr');
28
29    echo "--- 新規DOMAttrオブジェクトのテスト ---" . PHP_EOL;
30    echo "1. 'testAttr' 属性 (値未設定): ";
31    // この時点では属性値のテキストノードがないため、falseを返す
32    echo $newAttr->hasChildNodes() ? "子ノードあり (true)" : "子ノードなし (false)";
33    echo PHP_EOL;
34
35    $newAttr->nodeValue = 'hello'; // 属性値を設定
36    echo "2. 'testAttr' 属性 (値: '" . $newAttr->nodeValue . "'): ";
37    // 属性値 'hello' がテキストノードとして設定されたため、trueを返す
38    echo $newAttr->hasChildNodes() ? "子ノードあり (true)" : "子ノードなし (false)";
39    echo PHP_EOL . PHP_EOL;
40
41    // 2. 既存のHTMLからパースしたDOMAttrオブジェクトの挙動
42    //    通常、パースされた属性には値（空文字列を含む）が設定されています。
43    libxml_use_internal_errors(true); // HTMLパース時の警告を抑制
44    $html = <<<HTML
45<!DOCTYPE html>
46<html>
47<body>
48    <button id="submitBtn" data-status="active"></button>
49    <input type="text" value="" disabled>
50</body>
51</html>
52HTML;
53    $dom->loadHTML($html);
54    libxml_clear_errors(); // 警告抑制を解除
55
56    echo "--- 既存HTML要素から取得したDOMAttrオブジェクトのテスト ---" . PHP_EOL;
57
58    // id属性を持つボタン要素を取得し、そのid属性をチェック
59    $button = $dom->getElementById('submitBtn');
60    if ($button) {
61        $idAttr = $button->getAttributeNode('id');
62        if ($idAttr) {
63            echo "3. 'id' 属性 (値: '" . $idAttr->nodeValue . "'): ";
64            // 属性値 'submitBtn' はテキストノードとして存在するため、trueを返す
65            echo $idAttr->hasChildNodes() ? "子ノードあり (true)" : "子ノードなし (false)";
66            echo PHP_EOL;
67        }
68
69        $dataStatusAttr = $button->getAttributeNode('data-status');
70        if ($dataStatusAttr) {
71            echo "4. 'data-status' 属性 (値: '" . $dataStatusAttr->nodeValue . "'): ";
72            // 属性値 'active' はテキストノードとして存在するため、trueを返す
73            echo $dataStatusAttr->hasChildNodes() ? "子ノードあり (true)" : "子ノードなし (false)";
74            echo PHP_EOL;
75        }
76    }
77
78    // value属性が空のinput要素とdisabled属性をチェック
79    $input = $dom->getElementsByTagName('input')->item(0);
80    if ($input) {
81        $valueAttr = $input->getAttributeNode('value');
82        if ($valueAttr) {
83            echo "5. 'value' 属性 (値: '" . $valueAttr->nodeValue . "'): ";
84            // 属性値 '' (空文字列) もテキストノードとして存在するため、trueを返す
85            echo $valueAttr->hasChildNodes() ? "子ノードあり (true)" : "子ノードなし (false)";
86            echo PHP_EOL;
87        }
88
89        $disabledAttr = $input->getAttributeNode('disabled');
90        if ($disabledAttr) {
91            echo "6. 'disabled' 属性 (値: '" . $disabledAttr->nodeValue . "'): ";
92            // HTMLのdisabled属性は値がないブール属性ですが、PHPのDOMパースでは
93            // 空文字列が値として設定されます。そのため、テキストノードとして存在し、trueを返す
94            echo $disabledAttr->hasChildNodes() ? "子ノードあり (true)" : "子ノードなし (false)";
95            echo PHP_EOL;
96        }
97    }
98}
99
100// 関数を実行します
101checkDomAttrChildNodesExample();

PHPのDOMAttrクラスに属するhasChildNodes()メソッドは、特定の属性が子ノードを持っているかをチェックする機能を提供します。このメソッドは引数を受け取らず、真偽値（bool）を戻り値として返します。具体的には、対象のDOMAttrオブジェクトがその属性値をテキストノードとして持っている場合にtrueを、全く持っていない場合にfalseを返します。

サンプルコードは、このメソッドの挙動を明確に示しています。新しく作成した属性に値が設定されていない初期状態ではfalseを返しますが、例えば'hello'といった属性値を設定するとtrueに変わります。これは、属性値がテキストノードとして属性に追加されたためです。

既存のHTMLからパースされた属性の場合、属性値が空文字列（例: <input value="">）であっても、その空文字列がテキストノードとして存在するため、hasChildNodes()はtrueを返します。同様に、HTMLのブール属性（例: <input disabled>）も、PHPのDOM処理では空文字列が値として扱われるため、trueを返します。

このメソッドは、jQueryなどのJavaScriptにおける要素の子ノード有無チェックと似た名前ですが、PHPのDOMAttrにおけるhasChildNodes()は、「属性自体が、その属性値を子ノードとして持つか」という点に注目しているのが特徴です。属性値の有無を判定したい場合に役立ちます。

PHPのDOMAttr::hasChildNodes()は、対象の属性がその値（テキストノード）を持っているかを判定します。HTML要素が子ノードを持つかとは異なり、属性そのものに着目する点に注意してください。新規作成した属性で値が未設定の場合のみfalseを返し、一度値が設定されれば空文字列であってもtrueを返します。HTMLからパースされたブール属性（例: disabled）も、値として空文字列が設定されるためtrueを返します。jQueryなどのクライアントサイドの挙動とは概念が異なるため、混同しないよう理解することが重要です。