【PHP8.x】DOMDocumentType::lastChildプロパティの使い方

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

作成日: 2025年09月11日更新日: 2025年12月01日

基本的な使い方

『lastChildプロパティは、DOMDocumentTypeオブジェクトの最後の子ノードを保持するプロパティです。このプロパティは、親クラスであるDOMNodeから継承されており、読み取り専用です。DOMDocumentTypeはXMLやHTML文書における文書型宣言（DTD）を表すオブジェクトです。DTDの内部には、エンティティ宣言（<!ENTITY>）や記法宣言（<!NOTATION>）などが子ノードとして定義されることがあります。lastChildプロパティにアクセスすると、これらの子ノードの中で最後に追加されたものがDOMNodeオブジェクトとして返されます。もし対象となるDOMDocumentTypeオブジェクトに子ノードが一つも存在しない場合には、このプロパティはnullを返します。そのため、このプロパティを利用する際は、返り値がnullでないことを確認してから操作を行うのが一般的です。このプロパティは値を参照するだけで、直接値を代入してノードツリーを操作することはできません。最初の子ノードを取得するfirstChildプロパティと対になる関係にあり、文書構造の末尾からノードを探索する際に役立ちます。

構文(syntax)


1<?php
2
3$html = '<!DOCTYPE html><html><body></body></html>';
4
5$doc = new DOMDocument();
6$doc->loadHTML($html);
7
8// DOMDocumentType オブジェクトを取得し、lastChild プロパティにアクセスします。
9// DOCTYPE ノードは子を持つことができないため、このプロパティは常に null を返します。
10$last_child_node = $doc->doctype->lastChild;
11
12var_dump($last_child_node);
13
14?>

引数(parameters)

引数なし

引数はありません

戻り値(return)

?DOMNode

DOMDocumentTypeオブジェクトの最後の子ノードを返します。最後の子ノードがない場合はnullを返します。

サンプルコード

PHP: DOMDocumentType::lastChild で最後の子ノードを取得する


1<?php
2
3/**
4 * DOMDocumentType::lastChild プロパティの動作を示すサンプルコードです。
5 *
6 * DOMDocumentType は、HTMLやXML文書のDOCTYPE宣言に関する情報を持つオブジェクトです。
7 * lastChild プロパティは、DOMノードの最後の子ノードを返しますが、
8 * 一般的なDOCTYPE宣言はDOMツリー上で子ノードを持たないため、通常は null を返します。
9 */
10function demonstrateDomDocumentTypeLastChild(): void
11{
12    // 1. DOMDocument オブジェクトを作成します。
13    //    これは、HTMLやXML文書を扱うためのPHPのクラスです。
14    $dom = new DOMDocument();
15
16    // 2. HTML5 の DOCTYPE 宣言を含む簡単なHTML文字列をロードします。
17    //    loadHTML() メソッドは、指定されたHTML文字列をパースし、DOMツリーを構築します。
18    $htmlString = '<!DOCTYPE html><html><head><title>サンプル</title></head><body><h1>こんにちは！</h1></body></html>';
19    $dom->loadHTML($htmlString);
20
21    // 3. ドキュメントの DOMDocumentType オブジェクトを取得します。
22    //    これは $dom->doctype プロパティを通じてアクセスできます。
23    $doctype = $dom->doctype;
24
25    // 4. DOCTYPE オブジェクトが存在するか確認します。
26    if ($doctype instanceof DOMDocumentType) {
27        echo "DOCTYPE の名前: " . $doctype->name . "\n"; // 例: html
28
29        // 5. DOMDocumentType の lastChild プロパティにアクセスします。
30        //    DOCTYPE 宣言は通常、DOMツリー上の「子ノード」という概念を持たないため、
31        //    lastChild は null を返すことがほとんどです。
32        $lastChild = $doctype->lastChild;
33
34        if ($lastChild === null) {
35            echo "DOCTYPE には最後の子ノードがありません (lastChild は null です)。\n";
36        } else {
37            // もし何らかの子ノードが存在する場合（非常に稀なケース）、その情報を表示します。
38            echo "DOCTYPE の最後の子ノードのタイプ: " . $lastChild->nodeName . "\n";
39            echo "DOCTYPE の最後の子ノードの値: " . $lastChild->nodeValue . "\n";
40        }
41    } else {
42        echo "このドキュメントには DOCTYPE が見つかりませんでした。\n";
43    }
44}
45
46// 上記の関数を実行して、DOMDocumentType::lastChild の動作を確認します。
47demonstrateDomDocumentTypeLastChild();
48

このサンプルコードは、PHPのDOMDocumentTypeクラスが持つlastChildプロパティの動作を説明しています。DOMDocumentTypeは、HTMLやXML文書の先頭にある<!DOCTYPE html>のような「DOCTYPE宣言」に関する情報を持つオブジェクトです。

lastChildプロパティは、あるDOMノードが持つ子ノードの中で、一番最後の子ノードを返すために使われます。しかし、DOCTYPE宣言自体は、通常のHTML要素のように具体的な子ノードを持つ構造ではありません。そのため、DOMDocumentTypeオブジェクトに対してlastChildプロパティにアクセスしても、ほとんどの場合は子ノードが存在しないことを示すnullが戻り値として返されます。

サンプルコードでは、まずDOMDocumentオブジェクトを作成し、シンプルなHTML5文書をロードしています。次に、$dom->doctypeプロパティを使って、この文書のDOMDocumentTypeオブジェクトを取得します。取得した$doctypeオブジェクトが存在する場合、そのnameプロパティでDOCTYPEの名前（例: "html"）を表示しています。そして、$doctype->lastChildにアクセスし、その結果がnullであるかを確認します。この例では、DOCTYPE宣言に子ノードがないため、「DOCTYPEには最後の子ノードがありません」と表示されることを確認できます。lastChildプロパティの戻り値は?DOMNodeであり、子ノードが存在しない場合はnull、存在する場合はDOMNodeオブジェクトを返します。

DOMDocumentType::lastChildプロパティは、DOCTYPE宣言がDOMツリー上で子ノードを持たないため、通常はnullを返します。したがって、戻り値がnullであるかを常に確認し、適切な処理を行うことが非常に重要です。このプロパティの戻り値の型が?DOMNodeと示されているのは、DOMNodeオブジェクトの可能性とnullの可能性の両方があることを意味します。また、対象のHTMLやXML文書にDOCTYPE宣言自体が含まれていない場合、DOMDocument::$doctypeプロパティがnullになることがあります。そのため、$doctypeがDOMDocumentTypeオブジェクトであることをinstanceofで確認するチェックも必ず実施し、予期せぬエラーを防ぎ、コードの安全性を高めてください。

PHP DOMDocumentType::lastChild プロパティの挙動


1<?php
2
3/**
4 * DOMDocumentType::lastChild プロパティの使用例を示します。
5 *
6 * この関数は、指定されたHTML/XML文字列からDOMDocumentTypeノードを抽出し、
7 * その lastChild プロパティの値を出力します。
8 *
9 * DOMDocumentType は文書型定義 (<!DOCTYPE ...>) を表すノードです。
10 * DOMツリーの文脈では、このノードは通常子ノードを持ちません。
11 * そのため、`lastChild` プロパティは常に `null` を返します。
12 *
13 * キーワード「php last()」に関連して:
14 * DOM構造において、親ノードの最後の子ノードを取得する際に `lastChild` プロパティが使用されます。
15 * しかし、`DOMDocumentType` クラスの場合、このプロパティは常に `null` を返します。
16 *
17 * @param string $htmlString 処理対象のHTMLまたはXML文字列。
18 * @return void
19 */
20function demonstrateDomDocumentTypeLastChild(string $htmlString): void
21{
22    // DOMDocument オブジェクトを作成
23    $dom = new DOMDocument();
24
25    // HTML/XML文字列をDOMDocumentに読み込む
26    // @ 演算子を使用して、不正な形式による警告を抑制していますが、
27    // 実際のアプリケーションでは適切なエラーハンドリングを推奨します。
28    @$dom->loadHTML($htmlString);
29
30    // ドキュメントタイプノードを取得
31    // DOMDocument の `doctype` プロパティは、DOMDocumentType オブジェクトを返します。
32    // 文書に <!DOCTYPE ...> 宣言がない場合は null を返します。
33    $docType = $dom->doctype;
34
35    echo "--- 入力HTML/XML文字列 ---\n";
36    echo htmlspecialchars($htmlString) . "\n\n";
37
38    if ($docType instanceof DOMDocumentType) {
39        echo "DOMDocumentType ノードが見つかりました。\n";
40        echo "  ノード名: " . $docType->nodeName . "\n";
41        echo "  パブリックID: " . ($docType->publicId ?: "なし") . "\n";
42        echo "  システムID: " . ($docType->systemId ?: "なし") . "\n\n";
43
44        // lastChild プロパティにアクセス
45        // DOMDocumentType ノードはDOMツリー上で子ノードを持たないため、
46        // このプロパティは常に null を返します。
47        $lastChild = $docType->lastChild;
48
49        if ($lastChild instanceof DOMNode) {
50            // このブロックが実行されることはありませんが、一般的なDOMノードのチェックとして記述
51            echo "  lastChild プロパティ: 子ノードが見つかりました。\n";
52            echo "    子ノードのタイプ: " . $lastChild->nodeType . " (" . $lastChild->nodeName . ")\n";
53            echo "    子ノードの値: " . htmlspecialchars($lastChild->nodeValue) . "\n";
54        } else {
55            echo "  lastChild プロパティ: 子ノードは見つかりませんでした (null が返されました)。\n";
56            echo "  これは DOMDocumentType ノードの標準的な挙動です。\n";
57        }
58    } else {
59        echo "DOMDocumentType ノードが見つかりませんでした。\n";
60        echo "  (入力HTML/XMLに <!DOCTYPE ...> 宣言が含まれていない可能性があります。)\n";
61    }
62
63    echo "\n========================================\n\n";
64}
65
66// --- サンプル実行 ---
67
68// 1. HTML5 の DOCTYPE
69// <!DOCTYPE html> はDOMツリー上で子ノードを持たないため、lastChild は null を返します。
70demonstrateDomDocumentTypeLastChild('<!DOCTYPE html><html><head><title>Sample</title></head><body>Hello</body></html>');
71
72// 2. XHTML 1.0 Strict の DOCTYPE
73// Public ID と System ID を持つDOCTYPEの場合でも、lastChild は null を返します。
74demonstrateDomDocumentTypeLastChild('<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"><html><head><title>Sample</title></head><body>World</body></html>');
75
76// 3. DOCTYPE 宣言がないHTML
77// この場合、$dom->doctype 自体が null になるため、DOMDocumentType ノードは見つかりません。
78demonstrateDomDocumentTypeLastChild('<html><head><title>No DocType</title></head><body>No Doctype Here</body></html>');
79
80// 4. 内部サブセットを持つXMLのDOCTYPE
81// DTDの内部サブセット（ENTITY宣言など）はDOMDocumentTypeの子ノードとして扱われず、
82// `entities`プロパティなどでアクセスされるため、lastChild は null を返します。
83$xmlWithInternalSubset = '<!DOCTYPE root [
84<!ELEMENT root (#PCDATA)>
85<!ENTITY example "Hello from entity.">
86]><root>This is an &example; document.</root>';
87demonstrateDomDocumentTypeLastChild($xmlWithInternalSubset);
88

DOMDocumentType::lastChildプロパティは、DOMツリーにおいて特定のノードの最後の子ノードを取得するために使用されます。このプロパティは、PHPのDOM拡張機能におけるDOMDocumentTypeクラスに属しており、HTMLやXMLの文書型定義（<!DOCTYPE ...>）を表すノードから最後の子ノードを得ることを目的としています。しかし、DOMDocumentTypeノードはDOMツリーの文脈において、通常の要素やテキストノードのように子ノードを持つ構造ではありません。このため、lastChildプロパティは常にnullを返します。

引数は必要なく、戻り値の型は?DOMNodeと定義されていますが、前述の理由により、実際にはDOMNodeのインスタンスが返されることはなく、常にnullが返される挙動を示します。これは、文書型定義が宣言であり、DOM構造内で子要素を持つ概念ではないためです。

サンプルコードでは、様々な形式のHTML/XML文字列を解析し、DOMDocumentTypeノードが存在する場合にそのlastChildプロパティの挙動を実演しています。HTML5のシンプルな<!DOCTYPE html>から、パブリックIDやシステムIDを持つより複雑なDTD、さらには内部サブセットを持つXMLのDOCTYPEまでを扱っていますが、どのケースでもlastChildはnullを返していることが確認できます。これは、一般的なDOM操作で「php last()」のように最後の子ノードを取得する際とは異なり、DOMDocumentTypeにおけるlastChildプロパティが持つ、常にnullを返すという特殊な性質を示しています。

DOMDocumentType::lastChildプロパティは、文書型定義を表すDOMDocumentTypeノードがDOMツリー上で子ノードを持たないため、常にnullを返します。したがって、このプロパティから子ノードを取得できることを期待してはいけません。また、DOMDocumentTypeノード自体も、HTML/XML文字列に<!DOCTYPE ...>宣言がない場合はnullになりますので、アクセス前にその存在を必ず確認してください。サンプルコード中の@演算子によるエラー抑制は、開発時の簡易的な使用にとどめ、実際のアプリケーションでは例外処理など適切なエラーハンドリングを実装してください。一般的なDOM要素のlastChildプロパティとは異なり、DOMDocumentTypeに子ノードは存在しないという特性を理解することが重要です。