【PHP8.x】Dom\Text::parentNodeプロパティの使い方

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

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

基本的な使い方

parentNodeプロパティは、Dom\Textクラスに所属するプロパティで、テキストノードの親ノードを保持します。具体的には、そのテキストノードが属する要素ノードやドキュメントノードへの参照を保持します。

Dom\Textオブジェクトは、XMLドキュメントやHTMLドキュメント内のテキストを表します。parentNodeプロパティを通じて、そのテキストノードがドキュメント構造上のどこに位置しているかを特定できます。

例えば、HTMLドキュメントにおいて、<p>This is some text.</p>という要素がある場合、"This is some text."というテキストノードのparentNodeプロパティは、<p>要素ノードを指します。

parentNodeプロパティの値は、Dom\Nodeオブジェクトまたはnullのいずれかになります。親ノードが存在しない場合（例えば、ドキュメントノード自体の場合）、parentNodeプロパティはnullを返します。

parentNodeプロパティは読み取り専用のプロパティであり、値を変更することはできません。テキストノードの親ノードを変更するには、Dom\Node::appendChild()、Dom\Node::insertBefore()、Dom\Node::removeChild()などのメソッドを使用する必要があります。

このプロパティを使用することで、テキストノードを基準としたドキュメント構造のナビゲーションや、テキストノードのコンテキストに応じた処理を行うことが可能になります。DOMツリーを操作する上で、非常に重要な役割を担うプロパティの一つと言えます。

構文(syntax)


1Dom\Text::$parentNode;

引数(parameters)

引数なし

引数はありません

戻り値(return)

Dom\Node|null

このプロパティは、このテキストノードが属する親ノードを返します。親ノードが存在しない場合は null を返します。

サンプルコード

PHP DOM Textノードの親ノードを取得する


1<?php
2
3// Dom\Text クラスの parentNode プロパティの利用例
4
5// ドキュメントを作成
6$dom = new DOMDocument();
7
8// ルート要素を作成
9$root = $dom->createElement('root');
10$dom->appendChild($root);
11
12// テキストノードを作成
13$text = $dom->createTextNode('Hello, world!');
14
15// ルート要素にテキストノードを追加
16$root->appendChild($text);
17
18// テキストノードの親ノードを取得
19$parentNode = $text->parentNode;
20
21// 親ノードがルート要素であることを確認
22if ($parentNode === $root) {
23  echo "テキストノードの親ノードはルート要素です。\n";
24}
25
26// 親ノードの名前を表示
27echo "親ノードの名前: " . $parentNode->nodeName . "\n";
28
29// テキストノードを削除
30$root->removeChild($text);
31
32// 削除後のparentNodeはnullになる
33$parentNodeAfterRemove = $text->parentNode;
34
35// parentNodeがnullであることを確認
36if ($parentNodeAfterRemove === null) {
37    echo "テキストノード削除後、親ノードはnullです。\n";
38}

このサンプルコードは、PHPのDOM拡張における Dom\Text クラスの parentNode プロパティの使い方を示しています。parentNode プロパティは、テキストノードの親ノードを Dom\Node 型のオブジェクトとして返します。もし親ノードが存在しない場合は、null を返します。

まず、DOMDocument オブジェクトを作成し、ルート要素となる <root> 要素を追加します。次に、createTextNode() メソッドで "Hello, world!" というテキストノードを作成し、これを <root> 要素の子ノードとして追加します。

$text->parentNode を実行することで、テキストノードの親ノード（この場合は <root> 要素）を取得できます。サンプルコードでは、取得した親ノードが <root> 要素と同一であることを確認し、そのノード名を表示しています。

さらに、removeChild() メソッドを使ってテキストノードを削除すると、削除されたテキストノードの parentNode プロパティは null になります。サンプルコードでは、テキストノード削除後に parentNode プロパティが null であることを確認しています。

parentNode プロパティを使うことで、DOMツリー構造をたどって親要素にアクセスしたり、要素の削除後に親要素との関係がどう変化するかを確認したりできます。これは、XMLやHTMLドキュメントをPHPで操作する際に非常に重要な概念です。

Dom\TextクラスのparentNodeプロパティ利用時の注意点です。parentNodeは、テキストノードの親ノードを返しますが、ノードがドキュメントに属していない場合や、削除された後はnullを返すことがあります。サンプルコードでは、テキストノード削除後にparentNodeがnullになることを確認しています。parentNodeを利用する際は、nullチェックを行うことで、予期せぬエラーを回避できます。また、parentNodeは読み取り専用のプロパティなので、直接値を設定することはできません。親ノードを変更するには、appendChildやremoveChildなどのメソッドを使用する必要があります。