【PHP8.x】Dom\Document::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 を返します。

サンプルコード

PHP DOM firstElementChildで最初の要素を取得する


1<?php
2
3/**
4 * Dom\Document::firstElementChild プロパティの使用例をデモンストレーションします。
5 *
6 * このプロパティは、ドキュメントの最初の直接の子要素を返します。
7 * 子要素が存在しない場合は null を返します。
8 * システムエンジニアを目指す初心者にも理解しやすいように、具体的なHTMLコンテンツをロードして確認します。
9 */
10function demonstrateFirstElementChild(): void
11{
12    // 1. 新しい Dom\Document インスタンスを作成します。
13    $document = new Dom\Document();
14
15    // 2. ドキュメントにHTMLコンテンツをロードします。
16    // ここでは、<html>要素がドキュメントの最初の直接の子要素になります。
17    $htmlContent = <<<HTML
18<!DOCTYPE html>
19<html>
20<head>
21    <title>PHP DOM firstElementChildの例</title>
22</head>
23<body>
24    <h1>こんにちは、PHP DOM!</h1>
25    <p>これは firstElementChild プロパティのデモンストレーションです。</p>
26</body>
27</html>
28HTML;
29    $document->loadHTML($htmlContent);
30
31    // 3. Dom\Document の firstElementChild プロパティにアクセスします。
32    // これは Dom\Element のインスタンス、または子要素がない場合は null を返します。
33    $firstElement = $document->firstElementChild;
34
35    // 4. 最初の要素が存在するかどうかを確認し、その情報を表示します。
36    if ($firstElement instanceof Dom\Element) {
37        echo "ドキュメントの最初の直接の子要素が正常に取得されました。\n";
38        echo "タグ名: " . $firstElement->tagName . "\n"; // 例: "html"
39        echo "ノードタイプ (1 = 要素ノード): " . $firstElement->nodeType . "\n";
40        echo "クラス名: " . get_class($firstElement) . "\n"; // 例: "Dom\Element"
41    } else {
42        echo "ドキュメントに最初の直接の子要素が見つかりませんでした。\n";
43    }
44
45    echo "\n--- 子要素がない場合の例 ---\n";
46
47    // 5. 空のドキュメントを作成し、firstElementChild が null を返すことを確認します。
48    $emptyDocument = new Dom\Document();
49    $firstElementOfEmpty = $emptyDocument->firstElementChild;
50
51    if ($firstElementOfEmpty === null) {
52        echo "空のドキュメントには最初の直接の子要素がないため、nullが返されました (期待通り)。\n";
53    } else {
54        echo "予期せず、空のドキュメントに最初の直接の子要素が見つかりました: " . $firstElementOfEmpty->tagName . "\n";
55    }
56}
57
58// デモンストレーション関数を実行します。
59demonstrateFirstElementChild();
60

PHPのDom\Document::firstElementChildプロパティは、HTMLやXMLドキュメントのオブジェクトモデル（DOM）を操作する際に、ドキュメント自身の「最初の直接の子要素」を取得するために用いられます。このプロパティは引数を一切取らず、呼び出すだけで利用できます。戻り値は、ドキュメントに直接の子要素が存在すればDom\Elementクラスのインスタンスとしてその要素を返し、もし子要素が存在しない場合はnullを返します。

サンプルコードでは、具体的なHTMLコンテンツをロードしたDom\Documentオブジェクトを作成し、firstElementChildプロパティを呼び出して、ドキュメントの最初の直接の子要素（この場合は<html>要素）を取得する例を示しています。取得した要素のタグ名やノードタイプを表示することで、その機能を確認しています。これにより、ドキュメントの最上位要素に容易にアクセスできることが理解できます。

また、子要素が全く存在しない空のDom\Documentオブジェクトを作成し、同様にfirstElementChildプロパティにアクセスする例も含まれています。この場合、プロパティがnullを返すことで、子要素が存在しないときの挙動も明確に示されており、プロパティの利用方法を多角的に理解する助けとなります。このプロパティは、DOMツリーの探索や解析の開始点として非常に有用です。

Dom\Document::firstElementChild プロパティは、ドキュメントの最初の直接の子「要素」を返します。ここでいう「要素」とは、<html> や <body> のようなタグを持つノードのことで、テキストノードやコメントノードは対象外となる点にご注意ください。

最も重要な注意点は、子要素が存在しない場合に null を返すことです。サンプルコードのように if ($firstElement instanceof Dom\Element) といった形で、取得した値が実際に Dom\Element のインスタンスであるか、または null であるかを必ずチェックするようにしてください。このチェックを怠ると、null に対してプロパティ（例: tagName）にアクセスしようとして「Fatal error: Attempt to read property on null」のような実行時エラーが発生する可能性があります。常に null の可能性を考慮した安全なコード記述を心がけてください。

Dom\Document の firstElementChild と firstChild を理解する


1<?php
2
3/**
4 * Dom\Document の firstElementChild および firstChild プロパティの動作を実演します。
5 *
6 * システムエンジニアを目指す初心者向けに、これらのプロパティがドキュメントの
7 * 最初の「要素ノード」と最初の「任意のノード」をどのように区別して取得するかを示します。
8 */
9function demonstrateFirstChildProperties(): void
10{
11    // 1. Dom\Document オブジェクトを作成
12    $document = new Dom\Document();
13
14    // 2. HTMLコンテンツを読み込む
15    // ここでは、HTML要素の前にコメントノードを配置し、
16    // firstChild と firstElementChild の違いを明確にします。
17    // loadHTML は通常 <!DOCTYPE html> や <html><body> を自動生成しますが、
18    // 以下のように明示的に構造を定義することで、最上位ノードの比較がしやすくなります。
19    $htmlContent = <<<HTML
20        <!-- これはドキュメントの最初のノードとなるコメントです -->
21        <html>
22            <head>
23                <title>サンプルドキュメント</title>
24            </head>
25            <body>
26                <p>Hello, World!</p>
27            </body>
28        </html>
29    HTML;
30
31    $document->loadHTML($htmlContent);
32
33    echo "--- Dom\\Document の直接の子ノードと子要素 ---" . PHP_EOL;
34
35    // Dom\Document::firstChild の取得
36    // これはドキュメントの最初のノードを返します。
37    // コメントノード、テキストノード、DOCTYPEノード、またはHTML要素など、
38    // 何であれ最初に現れるノードを取得します。
39    $firstChild = $document->firstChild;
40
41    if ($firstChild) {
42        echo "document->firstChild (最初のノード):" . PHP_EOL;
43        echo "  ノードタイプ: " . $firstChild->nodeName . PHP_EOL; // 例: #comment, html, #doctype
44        echo "  ノード値 (一部): " . (
45            $firstChild->nodeValue ?
46            mb_substr(trim($firstChild->nodeValue), 0, 30) . (mb_strlen(trim($firstChild->nodeValue)) > 30 ? '...' : '') :
47            '[なし]'
48        ) . PHP_EOL;
49    } else {
50        echo "document->firstChild は存在しません。" . PHP_EOL;
51    }
52
53    echo PHP_EOL;
54
55    // Dom\Document::firstElementChild の取得
56    // これはドキュメントの最初の「要素ノード」を返します。
57    // コメントノードやテキストノードはスキップされ、最初に現れるHTMLタグ（例: <html>）を取得します。
58    $firstElementChild = $document->firstElementChild;
59
60    if ($firstElementChild) {
61        echo "document->firstElementChild (最初の要素ノード):" . PHP_EOL;
62        echo "  タグ名: " . $firstElementChild->tagName . PHP_EOL; // 例: html
63        echo "  内容 (一部): " . mb_substr(trim($firstElementChild->textContent), 0, 50) . '...' . PHP_EOL;
64    } else {
65        echo "document->firstElementChild は存在しません。" . PHP_EOL;
66    }
67
68    echo PHP_EOL;
69
70    // 別の例: 子要素を持たない Dom\Document の場合
71    $emptyDocument = new Dom\Document();
72    // 要素を含まないが、コメントノードを含むHTMLを読み込む
73    $emptyDocument->loadHTML("<!-- コメントのみ -->");
74
75    echo "--- 子要素を持たない Dom\\Document の例 ---" . PHP_EOL;
76
77    $emptyFirstChild = $emptyDocument->firstChild;
78    $emptyFirstElementChild = $emptyDocument->firstElementChild;
79
80    if ($emptyFirstChild) {
81        echo "emptyDocument->firstChild (最初のノード): " . $emptyFirstChild->nodeName . PHP_EOL;
82        echo "  ノード値 (一部): " . (
83            $emptyFirstChild->nodeValue ?
84            mb_substr(trim($emptyFirstChild->nodeValue), 0, 30) . (mb_strlen(trim($emptyFirstChild->nodeValue)) > 30 ? '...' : '') :
85            '[なし]'
86        ) . PHP_EOL;
87    } else {
88        echo "emptyDocument->firstChild は存在しません。" . PHP_EOL;
89    }
90
91    if ($emptyFirstElementChild === null) {
92        echo "emptyDocument->firstElementChild は null です (子要素がないため)。" . PHP_EOL;
93    } else {
94        echo "emptyDocument->firstElementChild (最初の要素ノード): " . $emptyFirstElementChild->tagName . PHP_EOL;
95    }
96}
97
98// 関数を実行して、Dom\Document の firstChild と firstElementChild の違いを確認
99demonstrateFirstChildProperties();

PHP 8のDom\Documentクラスは、HTMLやXMLドキュメントの構造をプログラムで操作するための機能を提供します。このクラスに備わるfirstElementChildプロパティは、ドキュメントの直接の子ノードの中から、最初に現れる「要素ノード」、つまりHTMLタグやXMLタグにあたる部分を取得するために利用されます。引数は不要で、もし最初の要素ノードが見つかればDom\Elementオブジェクトを返し、存在しない場合はnullを返します。

このプロパティは、Dom\Document::firstChildプロパティとよく比較されます。firstChildがドキュメントの直接の子ノードのうち、コメントやテキスト、HTML要素など、種類を問わず最初に現れるノードを返すのに対し、firstElementChildはコメントノードやテキストノードを無視し、純粋なHTMLタグのような要素ノードだけを対象とします。

サンプルコードでは、HTMLコンテンツの冒頭にコメントノードを配置することで、両者の違いを明確に示しています。この場合、firstChildは最初のコメントノードを返しますが、firstElementChildはそのコメントをスキップして、次に現れる<html>要素ノードを返します。これにより、ドキュメントツリーから特定のタグだけを効率的に探し出したい場合にfirstElementChildが非常に役立つことが理解できます。

firstElementChildは、ドキュメントの最初の子「要素ノード」を取得するプロパティです。コメントやテキストノードはスキップされ、最初のHTMLタグ（例: <html>）が返されます。一方、firstChildは、ドキュメントの最初の「任意のノード」を返します。これはコメント、テキスト、DOCTYPEノードなど、何であれ最初に現れるノードを指します。両プロパティは、該当する子ノードが存在しない場合、nullを返します。そのため、取得した値がnullでないかを必ず確認してから、そのプロパティ（tagNameやnodeNameなど）にアクセスするようにしてください。この確認を怠ると、予期せぬエラー（Attempt to read property ... on nullなど）が発生する可能性があります。