【PHP8.x】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）を返します。