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

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

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

基本的な使い方

childNodesプロパティは、Dom\HTMLDocumentオブジェクトが持つ、そのドキュメントの直下の子ノードのリストを保持するプロパティです。具体的には、HTMLドキュメントの最上位レベルに存在する子ノードの集合を提供します。これには、通常、HTMLドキュメントのルート要素である<html>要素や、場合によってはドキュメントタイプ定義（DTD）を表すノードなどが含まれます。

このプロパティが返す値はDOMNodeList型のオブジェクトです。DOMNodeListは、順序付けられたノードのコレクションであり、各ノードにインデックス（添字）を用いてアクセスすることができます。重要な点として、このDOMNodeListは「ライブコレクション」として機能します。これは、一度取得された後でも、元のHTMLドキュメントの構造がプログラムによって変更されると、このリストの内容も自動的に、そしてリアルタイムに更新されることを意味します。

システムエンジニアを目指す初心者の方々にとって、このchildNodesプロパティは、Webページの内容をPHPで解析し、操作する上での出発点となります。例えば、Dom\HTMLDocumentオブジェクトからHTMLドキュメント全体の構造をたどり始めるために、まずこのプロパティを使ってドキュメントのルート要素を取得し、そこからさらに個々の要素を深く探索していくといった形で利用できます。ドキュメントの階層構造を理解し、プログラムでアクセスするための基礎となる非常に重要なプロパティです。

構文(syntax)


1<?php
2
3$document = new \Dom\HTMLDocument();
4// HTMLコンテンツを読み込む例
5$document->loadHTML('<html><body><p>Example Content</p></body></html>');
6
7$nodeList = $document->childNodes;
8
9?>

引数(parameters)

戻り値(return)

Dom\NodeList

Dom\HTMLDocument クラスの childNodes プロパティは、その要素の直下にあるすべてのノードを Dom\NodeList オブジェクトとして返します。このリストには、要素ノード、テキストノード、コメントノードなどが含まれます。