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

firstChildプロパティは、PHPのDOM拡張機能が提供するDom\HTMLElementオブジェクトの最初の子ノードを保持するプロパティです。このプロパティは、WebページのHTML要素の階層構造、すなわちDOMツリーをプログラムから操作する際に利用されます。特定のHTML要素が持つすべての子ノードの中から、最も先頭に位置するノードを取得する目的で使用されます。

例えば、ある<div>要素内に複数の子要素やテキストが存在する場合、firstChildプロパティにアクセスすることで、その<div>要素直下の最初の子ノード（例：<p>タグの要素ノードや、空白・改行などのテキストノード）に直接アクセスできます。このプロパティはDom\Node型のオブジェクトを返しますが、対象のHTMLElementに子ノードが一つも存在しない場合はnullが返されます。

Webコンテンツの解析や動的な操作を行うWebアプリケーション開発において、DOMツリーの探索や処理の起点として非常に有用です。子ノードには要素ノードの他にテキストノードやコメントノードなど多様な種類が含まれるため、取得したノードのタイプを確認し、目的に応じた適切な処理を実装することが必要です。

Copy
1<?php
2
3// HTML文字列を準備
4$html_string = '<div id="parent"><p>First Paragraph</p><p>Second Paragraph</p></div>';
5
6// DOMDocumentオブジェクトを作成し、HTMLを読み込む
7$doc = new DOMDocument();
8$doc->loadHTML($html_string);
9
10// idが 'parent' の要素 (HTMLElement) を取得
11$element = $doc->getElementById('parent');
12
13// firstChildプロパティで、要素の最初の子ノードを取得する
14$firstChild = $element->firstChild;
15
16// 取得したノード（最初の<p>要素）のタグ名を出力する
17// 出力: p
18echo $firstChild->nodeName;
19
20?>

引数なし

引数はありません

Dom\Node|null

この firstChild プロパティは、対象となるHTMLElementの最初の子ノードを返します。子ノードが存在しない場合は null を返します。