【PHP8.x】childElementCountプロパティの使い方

childElementCountプロパティの使い方について、初心者にもわかりやすく解説します。

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

基本的な使い方

childElementCountプロパティは、Dom\HTMLDocumentオブジェクトの子要素の数を整数で保持するプロパティです。Dom\HTMLDocumentは、HTMLドキュメント全体をオブジェクトとして表現し、PHPからその構造や内容を操作するためのクラスです。

このプロパティは、親要素直下にある子ノードのうち、テキストノードやコメントノードを除いた、純粋な要素ノード（<html>、<body>などのタグ）の数を取得します。これにより、ドキュメントの要素構造を正確に把握するのに役立ちます。

特にDom\HTMLDocumentオブジェクトの場合、このchildElementCountプロパティは通常、HTMLドキュメントのルートとなる<html>要素の数を指します。そのため、整形式のHTMLドキュメントであれば、このプロパティの値は一般的に「1」となります。

システムエンジニアがウェブコンテンツの構造を分析し、操作する際に、子要素の数を効率的かつ正確に知ることは重要です。このプロパティは読み取り専用で、ドキュメント構造の変更に応じて自動更新されます。

構文(syntax)


1<?php
2
3$document = new DOM\HTMLDocument();
4$document->loadHTML('<html><head></head><body><h1>Title</h1><p>Content</p></body></html>');
5
6echo $document->documentElement->childElementCount;

引数(parameters)

戻り値(return)

int

このプロパティは、要素の子要素の数を整数で返します。