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

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

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

基本的な使い方

parentNodeプロパティは、Webページの構造を表すDOM（Document Object Model）ツリーにおいて、現在のノードの親ノードを保持するプロパティです。

Dom\HTMLDocumentクラスは、HTMLドキュメント全体、つまりWebページそのものをオブジェクトとして表現するクラスです。このオブジェクトは、DOMツリーの階層構造において、すべての要素やテキストノードを包含する最上位の「ルート」にあたるノードとして機能します。

DOMツリーは、親子関係を持つノードで構成される階層構造をしています。例えば、<body>要素の親は<html>要素、<h1>要素の親は<body>要素といった具合です。しかし、Dom\HTMLDocumentオブジェクト自体は、DOMツリーの始まりであり、それよりも上位に位置するノードは存在しません。

このため、Dom\HTMLDocumentオブジェクトのparentNodeプロパティにアクセスした場合、親ノードが存在しないことを示す特殊な値であるnullが常に返されます。このプロパティは、通常、特定のHTML要素やテキストノードの親要素を特定したり、DOMツリーを親方向へさかのぼって処理を行ったりする際に利用されるものですが、Dom\HTMLDocumentクラスにおいてはnullが返されるという特性を理解しておくことが重要ですし、他のDOMノードの親を辿る場合とは異なる振る舞いを示します。

構文(syntax)


1<?php
2$htmlDocument = new Dom\HTMLDocument();
3$parent = $htmlDocument->parentNode;
4?>

引数(parameters)

引数なし

引数はありません

戻り値(return)

?Dom\Node

Dom\HTMLDocument クラスの parentNode プロパティは、この HTML ドキュメントノードの親ノードを返します。親ノードが存在しない場合は null を返します。

サンプルコード

PHP Dom\HTMLDocument の parentNode を確認する


1<?php
2
3// Dom\HTMLDocument::parentNode プロパティの動作を示すサンプルコード
4
5// Dom\HTMLDocument の新しいインスタンスを作成します。
6// これはHTMLドキュメント全体のルートノードを表します。
7$htmlDocument = new Dom\HTMLDocument();
8
9// Dom\HTMLDocument はDOMツリーの最上位ノード（ルートノード）であるため、
10// 通常は親ノードを持ちません。parentNode プロパティは null を返します。
11$parentNode = $htmlDocument->parentNode;
12
13// parentNode の値を確認し、結果を出力します。
14if ($parentNode === null) {
15    echo "Dom\\HTMLDocument の parentNode プロパティは null です。\n";
16    echo "これは、HTMLドキュメント自体がDOMツリーのルートノードであり、親を持たないためです。\n";
17} else {
18    // このブロックは通常実行されませんが、万一のために含めます。
19    echo "Dom\\HTMLDocument の parentNode は予期せず存在します。型: " . get_class($parentNode) . "\n";
20}
21
22?>

PHP 8のDom\HTMLDocument::parentNodeプロパティは、DOMツリーにおける現在のノードの親ノードを取得するために使用されます。このプロパティは引数を持ちません。

戻り値は?Dom\Node型です。これは、親ノードが存在すればDom\Nodeオブジェクトを返し、存在しない場合はnullを返すことを意味します。

サンプルコードでは、Dom\HTMLDocumentのインスタンスを作成しています。Dom\HTMLDocumentはHTMLドキュメント全体のルートノードを表します。

DOMツリーのルートノードであるDom\HTMLDocumentは、それ自体が最上位のため、親ノードを持ちません。そのため、$htmlDocument->parentNodeはnullを返します。サンプルコードはこの挙動を確認し、parentNodeがnullであることを出力しており、DOMツリーの基本的な構造を理解する上で重要です。

このサンプルコードでは、Dom\HTMLDocumentのparentNodeプロパティがnullを返す点に注目してください。Dom\HTMLDocumentはHTMLドキュメント全体のルートノードであり、DOMツリーの最上位に位置するため、親ノードを持ちません。そのため、常にnullが返されることを理解しておくことが重要です。他のHTML要素（例: <div>や<p>)のparentNodeは通常、親要素のDom\Nodeオブジェクトを返しますが、HTMLDocumentではこの挙動が異なります。安全にコードを利用するためには、parentNodeプロパティの戻り値がnullである可能性を常に考慮し、適切にnullチェックを行うようにしましょう。