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

parentNodeプロパティは、DOMCdataSectionオブジェクトの親ノードを保持するプロパティです。PHPのDOM拡張機能は、XMLやHTMLドキュメントをプログラムから操作するために、ドキュメントの構造をツリー状のオブジェクト（DOMツリー）として表現します。このツリー構造において、ドキュメント内の各要素、属性、テキストなどは「ノード」として扱われ、ノード間には親子関係が定義されます。

DOMCdataSectionクラスは、XMLドキュメント内で特殊文字をエスケープせずにそのままの形で記述するための「CDATAセクション」を表します。これは、XMLパーサーがその内部のデータをXMLマークアップとして解釈しないようにするために使用され、例えば、XMLタグと混同される可能性のあるスクリプトや他のマークアップの断片を記述する際に非常に有用です。

このparentNodeプロパティを利用することで、現在のDOMCdataSectionノードがDOMツリーのどのノードの子であるか、すなわち「親」にあたるノードが何かをプログラム的に特定できます。例えば、あるXML要素の中にCDATAセクションが記述されている場合、parentNodeプロパティは、その外側のXML要素に対応するDOMElementオブジェクトを返します。親ノードが存在しない場合、例えばノードがまだドキュメントツリーに追加されていない場合や、ノードがドキュメントそのものである場合には、nullを返します。このプロパティは、ドキュメントの構造を理解し、CDATAセクションを含むコンテキストを探索するために役立ちます。

Copy
1<?php
2// DOMCdataSection オブジェクトを初期化する例
3$dom = new DOMDocument();
4$element = $dom->createElement('example');
5$dom->appendChild($element);
6$cdataSection = $dom->createCDATASection('This is CDATA content.');
7$element->appendChild($cdataSection);
8
9// DOMCdataSection オブジェクトの parentNode プロパティにアクセスする構文
10$parent = $cdataSection->parentNode;
11?>

引数なし

引数はありません

DOMNode|null

このプロパティは、このCDataセクションノードの親ノードであるDOMNodeオブジェクト、または親ノードが存在しない場合はnullを返します。