【PHP8.x】hasChildNodesメソッドの使い方

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

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

基本的な使い方

hasChildNodesメソッドは、現在のDOMDocumentオブジェクトが子ノードを持っているかどうかを確認するメソッドです。

DOMDocumentクラスは、HTMLやXMLといったドキュメント全体を表現し、その構造をプログラムで操作するための機能を提供します。このhasChildNodesメソッドは、そのDOMDocumentオブジェクトが、自身の直下に何らかの子ノード（例えば、HTMLドキュメントの<html>要素やXMLのルート要素、DOCTYPE宣言など）を保持しているかを調べます。

このメソッドを呼び出すと、子ノードが存在する場合はブール値のtrueを、子ノードが存在しない場合はfalseを返します。これにより、ドキュメントが完全に空であるか、あるいは特定の要素で構成されているかをプログラム上で判別することができます。

プログラミングにおいては、ドキュメントツリーをたどって特定の処理を行う前に、そのノードに子要素が存在するかどうかを事前に確認する際などに利用されます。例えば、XMLドキュメントのパース処理において、ルート要素が存在しないドキュメントを識別し、エラー処理を行うといったケースで役立ちます。ドキュメントの構造に応じた適切な処理を実装するための基本的なチェック機能として、幅広く活用されます。

構文(syntax)


1<?php
2$dom = new DOMDocument();
3$dom->loadXML('<root><item/></root>');
4
5// DOMDocumentオブジェクトが子ノードを持つか確認する構文です。
6// ロードされたXMLのルート要素（<root>）が子ノードとして存在するため、trueを返します。
7var_dump($dom->hasChildNodes());
8?>

引数(parameters)

引数なし

引数はありません

戻り値(return)

bool

このメソッドは、要素ノードに子ノードが存在するかどうかを示す真偽値（boolean）を返します。子ノードがあれば true、なければ false となります。