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

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

作成日: 2025年09月11日更新日: 2025年10月28日

基本的な使い方

hasChildNodesメソッドは、PHPのDOMNodeクラスに属し、特定のノードが子ノードを持っているかどうかを判定するメソッドです。DOMNodeは、XMLやHTMLドキュメントの構造を表現する基本的な単位であり、要素、テキスト、属性など様々な種類のノードが含まれます。

このメソッドは、対象となるノードに1つでも子ノードが存在する場合にtrue（真）を返し、子ノードが全く存在しない場合にはfalse（偽）を返します。引数は一切必要ありません。

ウェブページのHTML構造やXMLデータなどをプログラムで解析・操作する際に非常に有用です。例えば、あるHTML要素にさらに子要素やテキストコンテンツが含まれているかどうかを効率的に確認したい場合や、DOMツリーを探索する際に、子ノードが存在しない枝に進む無駄な処理を避けたい場合などに活用されます。

子ノードの有無を事前に確認することで、存在しない子ノードに対して無理な操作を試みてエラーが発生するのを防ぎ、プログラムの堅牢性を高めることができます。また、子ノードの有無に応じて処理を分岐させることで、より効率的で適切なドキュメント処理を実現することが可能です。このように、DOMNode::hasChildNodesメソッドは、DOMツリーの構造を安全かつ効率的に探索・操作するための基本的なツールとして、システム開発において広く活用されています。

構文(syntax)


1<?php
2$dom = new DOMDocument();
3$dom->loadHTML('<div><p>Hello</p></div>');
4$node = $dom->getElementsByTagName('div')->item(0);
5
6$hasChildren = $node->hasChildNodes();
7?>

引数(parameters)

引数なし

引数はありません

戻り値(return)

bool

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

サンプルコード

DOMNode::hasChildNodes で子ノードの有無を確認する


1<?php
2
3// DOMNode::hasChildNodes() の使用例
4$dom = new DOMDocument();
5$dom->loadXML('<root><child1>Value 1</child1><child2>Value 2</child2></root>');
6
7$root = $dom->documentElement;
8
9// root ノードが子ノードを持つかどうかを確認
10if ($root->hasChildNodes()) {
11  echo "root ノードは子ノードを持っています。\n";
12
13  // 最初の子ノードを取得
14  $firstChild = $root->firstChild;
15
16  // 最初の子ノードが子ノードを持つかどうかを確認
17  if ($firstChild->hasChildNodes()) {
18    echo "最初の子ノードも子ノードを持っています。\n";
19  } else {
20    echo "最初の子ノードは子ノードを持っていません。\n";
21  }
22
23} else {
24  echo "root ノードは子ノードを持っていません。\n";
25}
26
27// 空のノードを作成
28$emptyNode = $dom->createElement('empty');
29
30// 空のノードが子ノードを持つかどうかを確認
31if ($emptyNode->hasChildNodes()) {
32  echo "空のノードは子ノードを持っています。\n";
33} else {
34  echo "空のノードは子ノードを持っていません。\n"; // こちらが出力される
35}
36?>

PHP 8 の DOMNode クラスにおける hasChildNodes メソッドは、ノードが子ノードを持っているかどうかを確認するために使用します。引数はなく、boolean 型の戻り値を返します。子ノードを1つ以上持っている場合は true、持っていない場合は false を返します。

上記のサンプルコードでは、まず DOMDocument を作成し、XML 形式の文字列を読み込んで DOM ツリーを構築しています。次に、ルート要素 (root) を取得し、hasChildNodes メソッドを使って、ルート要素が子ノードを持っているかどうかをチェックしています。この例では、ルート要素は child1 と child2 という2つの子ノードを持っているので、true が返り、「root ノードは子ノードを持っています。」というメッセージが出力されます。

さらに、最初の子ノード (child1) を取得し、同様に hasChildNodes メソッドを使って子ノードの有無を確認しています。child1 はテキストノードという値を持っているため、子ノードを持っておらず、false が返り、「最初の子ノードは子ノードを持っていません。」というメッセージが出力されます。

最後に、createElement メソッドを使って空のノード (empty) を作成し、hasChildNodes メソッドで子ノードの有無を調べます。空のノードは子ノードを持たないため、false が返り、「空のノードは子ノードを持っていません。」というメッセージが出力されます。hasChildNodes メソッドを使用することで、DOM ツリー内のノード構造をプログラムで確認し、処理を分岐させることが可能になります。

DOMNode::hasChildNodes()は、ノードが子ノードを持つかどうかをtrueまたはfalseで返します。このメソッドは、要素ノードだけでなく、テキストノードやコメントノードなど、あらゆる種類のノードに対して使用できます。XMLドキュメントを操作する際、特定のノードが子要素を持つかどうかを事前に確認することで、エラーを回避し、より安全な処理を実現できます。例えば、子ノードが存在しない場合に処理をスキップしたり、特定の条件を満たす子ノードのみを処理対象としたりできます。hasChildNodes()はノードが一つ以上の子ノードを持つ場合にtrueを返すため、子ノードの数を知りたい場合は、childNodesプロパティとlengthプロパティを組み合わせて使用する必要があります。