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

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

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

基本的な使い方

firstElementChildプロパティは、DOMDocumentオブジェクトが保持する、文書ツリーの最初の子要素ノードを指すプロパティです。

このプロパティは、ウェブページやXMLデータなどの文書構造をプログラムで操作するための仕組みであるDOM（Document Object Model）において、PHPのDOM拡張機能の一部として提供されています。DOMDocumentオブジェクトは、HTMLドキュメントやXMLドキュメント全体を表します。firstElementChildプロパティを使用すると、そのDOMDocumentオブジェクトが表現する文書の直下にある、最初の要素ノード（いわゆるHTMLの<html>タグやXMLのルート要素のような、タグで囲まれた構造を持つ部分）を簡単に取得できます。

具体的には、DOMDocumentの直接の子ノードには、要素ノードの他にもコメントノードや処理命令ノードなどが存在し得ますが、firstElementChildはそれらの中から要素ノードのみを対象とし、最初に見つかる要素ノードをDOMElementオブジェクトとして返します。

例えば、読み込んだHTMLドキュメント全体を表すDOMDocumentオブジェクトから、そのドキュメントのルート要素である<html>要素を直接取得したい場合にこのプロパティが非常に役立ちます。取得したDOMElementオブジェクトを通じて、さらにその内部の要素や属性にアクセスし、操作を進めることが可能になります。もしDOMDocumentオブジェクトが子要素ノードを全く持たない場合、このプロパティはnullを返します。これにより、対象の要素が存在しない場合の処理を適切に記述できます。

構文(syntax)


1<?php
2$dom = new DOMDocument();
3$dom->loadHTML('<html><body><p>Hello</p></body></html>');
4
5$firstElement = $dom->firstElementChild;
6?>

引数(parameters)

戻り値(return)

戻り値なし

戻り値はありません