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

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

作成日: 更新日:

基本的な使い方

parentNodeプロパティは、PHPのDOMDocumentクラスに属し、特定のノードの親ノードを保持するプロパティです。DOM(Document Object Model)は、HTMLやXMLドキュメントの構造を木(ツリー)のような階層で表現します。この階層において、あるノードの直接の親となるノードが「親ノード」と呼ばれます。

DOMDocumentクラスは、PHPのDOM拡張機能において、HTMLやXMLドキュメント全体を表すルートノードです。ドキュメントツリーの最上位に位置するため、DOMDocumentオブジェクト自体は、それより上位に親ノードを持つことはありません。そのため、DOMDocumentオブジェクトのparentNodeプロパティにアクセスした場合、その値は常にnullとなります。

このプロパティは、DOMDocumentクラスが基底となるDOMNodeクラスを継承しているため存在しますが、DOMDocumentの性質上、親を持たないという特性を示します。他のDOMElementやDOMTextなどのノードでは、parentNodeプロパティはそれぞれの親ノード(DOMElement、DOMDocument、またはnull)を返しますが、DOMDocumentに限っては常にnullを返します。DOMツリーを走査するプログラムを作成する際には、このDOMDocument特有の挙動を理解しておくことが、意図しないエラーを防ぎ、堅牢なコードを書く上で役立ちます。

構文(syntax)

1<?php
2$document = new DOMDocument();
3$parentNode = $document->parentNode;
4?>

引数(parameters)

戻り値(return)

null

parentNode プロパティは、そのノードの親ノードを表す DOMNode オブジェクトを返します。ただし、ルートノードの場合は null が返されます。