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

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

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

基本的な使い方

firstChildプロパティは、指定されたHTMLドキュメントの最初の子ノードを保持するプロパティです。Dom\HTMLDocumentクラスにおいてこのプロパティを使用すると、解析されたHTMLドキュメントツリーの最も上位にある子ノード、具体的にはドキュメント型宣言（<!DOCTYPE html>）またはHTMLのルート要素である<html>タグのいずれかを表すDom\Nodeオブジェクトを取得できます。

このプロパティは、HTMLドキュメントの構造をプログラムで探索したり、特定の部分にアクセスしたりする際の出発点として非常に役立ちます。例えば、Webページのコンテンツを動的に解析・操作する際に、ドキュメント全体の要素にアクセスする前に、まずこのプロパティを使ってドキュメントの最上位の子ノードを取得し、そこからさらに子の要素へとたどっていくことで、必要な情報に効率的にアクセスすることが可能になります。

もしHTMLドキュメントが空であるか、または子ノードを一つも持たない場合は、このプロパティはnullを返します。返される値はDom\Node型のオブジェクト、または子ノードが存在しない場合はnullとなります。システムエンジニアを目指す方にとって、Webページのコンテンツを動的に解析・操作する基礎となるDOM（Document Object Model）の理解において、このfirstChildプロパティは不可欠な要素の一つです。

構文(syntax)


1<?php
2$htmlDocument = new Dom\HTMLDocument();
3$htmlDocument->loadHTML('<!DOCTYPE html><html><head><title>Test</title></head><body>Hello</body></html>');
4
5$firstNode = $htmlDocument->firstChild;
6
7if ($firstNode) {
8    echo "ドキュメントの最初の子ノード名: " . $firstNode->nodeName;
9} else {
10    echo "ドキュメントに最初の子ノードはありません。";
11}
12?>

引数(parameters)

戻り値(return)

?Dom\Node

firstChild プロパティは、現在のHTML要素の最初の子ノード、または null を返します。