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

ownerDocumentプロパティは、XMLやHTMLなどのDOMツリーを構成するノードが属する、最上位のDom\Documentオブジェクトを保持するプロパティです。このプロパティは、Dom\Entityクラスに属しており、XML文書内で定義される実体（エンティティ）を表すノードに対して利用されます。

DOM（Document Object Model）では、すべてのノードは必ず一つのドキュメントに属しており、その所属を明確にすることは重要です。ownerDocumentプロパティは、現在操作しているエンティティノードがどのドキュメントの一部であるかを明確に示します。例えば、複数のXMLドキュメントを扱うアプリケーション内で、あるエンティティノードが作成された場合、このプロパティを参照することで、そのエンティティが具体的にどのドキュメントのコンテキストに属しているかを簡単に識別できます。

このプロパティにアクセスすることで、該当のエンティティノードが属するDom\Documentオブジェクト全体への参照を取得できます。これにより、そのドキュメントに対して、新たな要素の追加、他のノードの検索、ドキュメント全体の保存といった操作を行う際に、適切なドキュメントオブジェクトを迅速に利用することが可能になります。ownerDocumentプロパティは、常にそのノードが直接的に属する最上位のドキュメントオブジェクトを返します。

Copy
1<?php
2$doc = new Dom\Document();
3$doc->loadXML('<!DOCTYPE root [<!ENTITY example "value">]><root/>');
4
5$entity = $doc->doctype->entities->getNamedItem('example');
6
7$ownerDocument = $entity->ownerDocument;

引数なし

引数はありません

?Dom\Document

このプロパティは、この要素が属する Dom\Document オブジェクトを返します。要素がまだドキュメントにアタッチされていない場合、null を返します。