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

Copy
1<?php
2
3/**
4 * Dom\Document::parentNode プロパティの使用例。
5 * Dom\Document オブジェクトはドキュメントツリーのルートノードであるため、
6 * その parentNode プロパティは常に null を返します。
7 */
8function demonstrateDomDocumentParentNode(): void
9{
10    // 新しい Dom\Document オブジェクトを作成します。
11    // これは、XMLやHTMLドキュメント全体のルートノードとして機能します。
12    $document = new Dom\Document();
13
14    // Dom\Document の parentNode プロパティにアクセスします。
15    // ドキュメントノードはツリーの最上位にあるため、親ノードは存在しません。
16    $parentNode = $document->parentNode;
17
18    echo "Dom\\Document::parentNode の結果:\n";
19
20    // parentNode が null であることを確認し、その理由を説明します。
21    if ($parentNode === null) {
22        echo "親ノードは null です。\n";
23        echo "これは、Dom\\Document がドキュメントツリーのルートノードであり、\n";
24        echo "それ自体に親がないためです。\n";
25    } else {
26        // 通常、このブロックは実行されません。
27        echo "親ノードの型: " . get_class($parentNode) . "\n";
28    }
29}
30
31// 関数を実行して、Dom\Document::parentNode の動作を確認します。
32demonstrateDomDocumentParentNode();
33
34?>

PHP 8のDom\Document::parentNodeプロパティは、DOMツリーにおいて、あるノードの親ノードを取得するために使用されるプロパティです。Dom\Documentクラスは、XMLやHTMLドキュメント全体の「ルートノード（根元）」を表し、ドキュメントの最上位に位置する特別なノードです。

このプロパティは引数を必要とせず、親ノードが存在する場合はDom\Nodeオブジェクトを返します。しかし、親ノードが存在しない場合はnullを返します。

サンプルコードは、新しいDom\Documentオブジェクトを作成し、このparentNodeプロパティにアクセスした際にnullが返されることを示しています。これは、Dom\Documentがドキュメントツリーのルートノードであるため、親を持たないことが理由です。したがって、Dom\DocumentのparentNodeプロパティは常にnullとなります。このparentNodeプロパティは、通常のHTML要素ノードなどで親要素をたどる際に利用されますが、Dom\Documentにおいては常にnullとなる点を理解することが、DOM操作の基礎として重要です。