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

namespaceURIプロパティは、所属するDOMEntityノードのXML名前空間URIを保持するプロパティです。このプロパティは、PHPのDOM拡張機能において、XML文書の構造をプログラムから操作する際に使用されるDOMEntityクラスに属しています。

DOMEntityクラスは、XML文書内で定義されるエンティティ（実体）ノード、例えば<!ENTITY ...>で宣言される実体を参照するノードを表します。XML名前空間は、異なるXML語彙の要素や属性の名前が衝突するのを防ぐために使用される仕組みであり、一意なURI（Uniform Resource Identifier）で識別されます。

しかし、XMLの仕様上、エンティティノード自体は通常、直接名前空間に属しません。そのため、DOMEntityオブジェクトのnamespaceURIプロパティの値は、常にnullとなります。

このプロパティは、DOMElement（要素ノード）やDOMAttr（属性ノード）など、名前空間を持つことができるノードタイプで真価を発揮します。これらのノードでは、所属する名前空間のURIを文字列として返しますが、DOMEntityノードに関してはその性質上、nullが返されるという挙動を理解しておくことが重要です。XML文書の構造を解析したり、操作したりする際に、各ノードがどの名前空間に属しているかを確認するために利用されるプロパティの一つですが、DOMEntityの場合はその用途が限定されることを認識しておいてください。

Copy
1<?php
2$dom = new DOMDocument();
3// XMLドキュメントと内部エンティティを含むDTDを読み込む
4$dom->loadXML('<!DOCTYPE root [<!ENTITY example "Hello, PHP!">]><root/>');
5
6// ドキュメントタイプ定義 (DTD) ノードを取得
7$doctype = $dom->doctype;
8
9// DTDが存在し、エンティティを持っているか確認
10if ($doctype && $doctype->entities) {
11    // 'example'という名前のDOMEntityを取得
12    $entity = $doctype->entities->getNamedItem('example');
13
14    // エンティティが存在し、DOMEntityのインスタンスである場合
15    if ($entity instanceof DOMEntity) {
16        // namespaceURIプロパティにアクセスし、その値を出力
17        echo $entity->namespaceURI;
18    }
19}
20?>

引数なし

引数はありません

string|null

DOMEntity要素が定義されている名前空間のURIを返します。要素に名前空間が関連付けられていない場合はnullを返します。