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

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

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

基本的な使い方

firstElementChildプロパティは、Dom\Documentオブジェクトが表現するドキュメントの直下にある最初の子要素ノードを保持するプロパティです。このプロパティは、PHP 8で提供されるDOM拡張機能の一部であり、HTMLやXMLドキュメントをプログラムから操作する際に利用されます。

Dom\Documentクラスは、ウェブページ全体やXMLデータなどのドキュメント構造全体を表します。このプロパティを使用すると、ドキュメントのルートに位置する最初の要素ノードに簡単にアクセスすることができます。例えば、標準的なHTMLドキュメントであれば通常<html>要素が、XMLドキュメントであれば定義されたルート要素がこれに該当します。

特筆すべきは、このfirstElementChildプロパティがテキストノードやコメントノードといった要素ではないノードを自動的に無視し、純粋な要素ノードのみを対象とする点です。これにより、ドキュメントの整形のために挿入された空白文字やコメントなどを気にすることなく、直接コンテンツを構成する要素にアクセスできるため、DOMツリーの走査が非常に効率的になります。

戻り値は、該当する最初の子要素が存在すればDom\Elementオブジェクトとなり、それに対してさらに属性や子要素を操作することができます。もし最初の子要素ノードが存在しない場合はnullが返されます。このプロパティは、特にドキュメントの構造の最上位要素を特定し、そこからDOM操作を開始する際に非常に役立ちます。

構文(syntax)


1<?php
2
3$document = new Dom\Document();
4$document->loadHTML('<!DOCTYPE html><html><body><h1>Hello</h1></body></html>');
5
6$firstElement = $document->firstElementChild;
7
8?>

引数(parameters)

戻り値(return)

Dom\Element|null

このプロパティは、現在のDOM要素の最初の子要素を表します。子要素が存在しない場合は null を返します。