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

Copy
1<?php
2
3/**
4 * DOMAttr::lastChild プロパティの使用例
5 *
6 * この関数は、DOMDocumentを作成し、要素に属性を設定した後、
7 * その属性ノード (DOMAttr) の最後の子ノードを取得する方法を示します。
8 * 属性ノードは通常、その値を表す単一のテキストノードを子に持つため、
9 * lastChild プロパティはそのテキストノードを返します。
10 * 戻り値は ?DOMNode であり、子ノードが存在しない場合は null を返します。
11 */
12function demonstrateDomAttrLastChild(): void
13{
14    // 新しいDOMドキュメントを作成 (XML宣言とエンコーディングを指定)
15    $doc = new DOMDocument('1.0', 'UTF-8');
16    $doc->formatOutput = true; // 出力整形を有効にする
17
18    // ルート要素 'root' を作成し、ドキュメントに追加
19    $root = $doc->createElement('root');
20    $doc->appendChild($root);
21
22    // 'item' 要素を作成し、テキストコンテンツを設定
23    $item = $doc->createElement('item', 'Example text content.');
24    $root->appendChild($item);
25
26    // 'data-id' 属性を 'item' 要素に追加
27    // この属性値 '12345' が DOMAttr の唯一の子ノード (テキストノード) となります
28    $attributeName = 'data-id';
29    $attributeValue = '12345';
30    $item->setAttribute($attributeName, $attributeValue);
31
32    echo "--- 生成されたXMLドキュメント ---\n";
33    echo $doc->saveXML();
34    echo "-------------------------------\n\n";
35
36    // 'item' 要素から 'data-id' 属性ノード (DOMAttr) を取得
37    $domAttr = $item->getAttributeNode($attributeName);
38
39    if ($domAttr) {
40        echo "取得した属性名: " . $domAttr->name . "\n";
41        echo "取得した属性値 (DOMAttr::nodeValue): " . $domAttr->nodeValue . "\n\n";
42
43        // DOMAttr::lastChild プロパティにアクセス
44        // 属性ノードは通常、その値を保持するテキストノードのみを子に持ちます。
45        // lastChild プロパティはこのテキストノードを返します。
46        $lastChild = $domAttr->lastChild;
47
48        if ($lastChild instanceof DOMText) {
49            echo "DOMAttr::lastChild は DOMText ノードです。\n";
50            echo "lastChild の nodeValue: " . $lastChild->nodeValue . "\n";
51            echo "lastChild の nodeType: " . $lastChild->nodeType . " (DOM_TEXT_NODE)\n";
52
53            // lastChild の値が、属性ノード自体の nodeValue と一致することを確認
54            if ($lastChild->nodeValue === $domAttr->nodeValue) {
55                echo "lastChild の値は属性の nodeValue と一致します。\n";
56            }
57        } elseif ($lastChild === null) {
58            // 子ノードが存在しない場合 (例: 空の属性値)
59            echo "DOMAttr には子ノードがありません。\n";
60        } else {
61            // 稀なケースだが、テキストノード以外のノードが子になる可能性も考慮
62            echo "DOMAttr::lastChild は予期しないタイプのノードです: " . get_class($lastChild) . "\n";
63        }
64    } else {
65        echo "要素 'item' に属性 '{$attributeName}' が見つかりませんでした。\n";
66    }
67}
68
69// 関数を実行してDOMAttr::lastChildの動作を示す
70demonstrateDomAttrLastChild();
71
72?>

PHP 8のDOMAttr::lastChildプロパティは、XMLやHTMLの属性ノード（DOMAttrオブジェクト）が持つ最後の子ノードを取得するために使用されます。DOMAttrオブジェクトは、通常、その属性値を表現する単一のテキストノードを子として保持しています。そのため、このlastChildプロパティにアクセスすると、ほとんどの場合、属性値に相当するDOMTextノードが返されます。

このプロパティは引数を持ちません。戻り値は?DOMNode型で、子ノードが存在すればDOMNodeオブジェクト（通常はDOMTextノード）、子ノードが存在しない場合はnullを返します。

サンプルコードでは、DOMDocumentを作成し、item要素にdata-id="12345"という属性を設定しています。その後、getAttributeNodeメソッドでdata-id属性を表すDOMAttrオブジェクトを取得し、そのlastChildプロパティにアクセスしています。ここでは、DOMAttrのlastChildプロパティが、属性値である「12345」を含むDOMTextノードを返していることが示されます。このDOMTextノードのnodeValueは、属性自身のnodeValueと一致し、属性が子ノードとしてその値を保持していることを確認できます。これにより、属性値をプログラムで詳細に操作したり、その存在を確認したりすることが可能になります。

Copy
1<?php
2
3/**
4 * DOMAttr::lastChild プロパティの動作を示すサンプルコードです。
5 * DOMAttr の lastChild プロパティは、その属性ノードの最後の子ノードを返します。
6 * 通常、DOMAttr はテキストノード（DOMText）しか子ノードとして持たないため、
7 * lastChild は属性の値を表す DOMText ノードを返します。
8 *
9 * キーワード「php last()」に関連し、コレクション（この場合は属性の子ノードリスト）の
10 * 最後の要素（lastChild）を取得する方法を示します。
11 */
12function demonstrateDomAttrLastChild(): void
13{
14    // 1. 新しい DOMDocument オブジェクトを作成します。
15    // XMLのバージョンとエンコーディングを指定します。
16    $dom = new DOMDocument('1.0', 'UTF-8');
17    $dom->formatOutput = true; // 出力を整形して見やすくします
18
19    // 2. ルート要素 'root' を作成し、ドキュメントに追加します。
20    $rootElement = $dom->createElement('root');
21    $dom->appendChild($rootElement);
22
23    // 3. 子要素 'item' を作成し、ルート要素に追加します。
24    $itemElement = $dom->createElement('item');
25    $rootElement->appendChild($itemElement);
26
27    // 4. DOMAttr オブジェクト（属性ノード）を作成します。
28    // 属性名 'data-value' を持つ属性を作成します。
29    $dataAttr = $dom->createAttribute('data-value');
30
31    // 5. 属性の値を設定します。
32    // この値は内部的に DOMAttr の子ノードとして DOMText ノードになります。
33    $dataAttr->value = 'sample-data-123';
34
35    // 6. 作成した属性を 'item' 要素に追加します。
36    $itemElement->setAttributeNode($dataAttr);
37
38    echo "--- DOMAttr::lastChild プロパティのデモンストレーション ---\n\n";
39
40    echo "対象の属性名: " . $dataAttr->name . "\n";
41    echo "対象の属性値: '" . $dataAttr->value . "'\n\n";
42
43    // 7. DOMAttr オブジェクトの lastChild プロパティにアクセスします。
44    // このプロパティは、属性の値を保持する DOMText ノードを返します。
45    // 戻り値の型は ?DOMNode です (DOMNode オブジェクトか null)。
46    $lastChildOfAttr = $dataAttr->lastChild;
47
48    // 取得した子ノードが存在するか確認します。
49    if ($lastChildOfAttr instanceof DOMNode) {
50        echo "属性の最後の子ノードが見つかりました。\n";
51        echo "  ノード名 (nodeName): " . $lastChildOfAttr->nodeName . "\n";
52        echo "  ノードタイプ (nodeType): " . $lastChildOfAttr->nodeType . " (3はテキストノードを表します)\n";
53
54        // DOMText ノードであれば、その値を出力します。
55        if ($lastChildOfAttr instanceof DOMText) {
56            echo "  ノード値 (nodeValue): '" . $lastChildOfAttr->nodeValue . "'\n";
57        } else {
58            echo "  (この子ノードは DOMText ではありません。)\n";
59        }
60    } else {
61        echo "属性に子ノードはありませんでした。\n";
62    }
63
64    echo "\n\n--- 生成されたXML (参考) ---\n";
65    echo $dom->saveXML();
66}
67
68// 上記の関数を実行して、DOMAttr::lastChild の動作を確認します。
69demonstrateDomAttrLastChild();

PHP 8のDOMAttrクラスが持つlastChildプロパティは、XMLやHTMLドキュメントの属性ノードに含まれる最後の子ノードを取得するために使用されます。このプロパティは引数を取りません。戻り値は?DOMNode型で、対象の属性ノードに子ノードが存在すればDOMNodeオブジェクトを、存在しなければnullを返します。

通常、DOMAttrオブジェクトは、属性の値を表現するDOMTextノードを唯一の子ノードとして持ちます。そのため、lastChildプロパティにアクセスすると、その属性が持つ値を保持するDOMTextノードが返されることが一般的です。

このサンプルコードでは、DOMDocumentを作成し、item要素にdata-value="sample-data-123"という属性を設定しています。この設定された属性値「sample-data-123」が、内部的にDOMAttrオブジェクトの子ノードであるDOMTextノードとして表現されます。その後、$dataAttr->lastChildを通じてこのDOMTextノードを取得し、そのノードが属性の値を正確に保持していることを確認しています。これは「php last()」というキーワードが示すように、コレクション（この場合は属性の子ノードリスト）の最後の要素を取得する一般的な考え方に関連しており、属性の子ノードの最後の要素（つまり属性値）を効率的に取得する方法を示しています。