【PHP8.x】DOMEntityReference::hasAttributes()メソッドの使い方

Copy
1<?php
2
3/**
4 * DOMEntityReference::hasAttributes() の使用例を示します。
5 * このメソッドは、ノードが属性を持っているかどうかを bool 値で返します。
6 * 比較のために、属性を持つ DOMElement と持たない DOMElement もチェックします。
7 */
8function checkNodeAttributes(): void
9{
10    // DOMDocumentオブジェクトを生成
11    $dom = new DOMDocument();
12
13    // --- 例1: 属性を持つ要素ノード ---
14    // <product id="101"></product> のような要素を作成
15    $elementWithAttr = $dom->createElement('product');
16    $elementWithAttr->setAttribute('id', '101');
17
18    // hasAttributes() は属性が存在するため true を返す
19    echo "属性を持つ要素ノードの場合: ";
20    var_dump($elementWithAttr->hasAttributes()); // bool(true)
21
22    // --- 例2: 属性を持たない要素ノード ---
23    // <name></name> のような要素を作成
24    $elementWithoutAttr = $dom->createElement('name');
25
26    // hasAttributes() は属性が存在しないため false を返す
27    echo "属性を持たない要素ノードの場合: ";
28    var_dump($elementWithoutAttr->hasAttributes()); // bool(false)
29
30    // --- 例3: エンティティ参照ノード (DOMEntityReference) ---
31    // &copy; のようなエンティティ参照を作成
32    // DOMEntityReference ノードは、通常、属性を持つことができません。
33    $entityRef = $dom->createEntityReference('copy');
34
35    // したがって、hasAttributes() は常に false を返す
36    echo "エンティティ参照ノードの場合: ";
37    var_dump($entityRef->hasAttributes()); // bool(false)
38}
39
40// 関数を実行して結果を表示
41checkNodeAttributes();

DOMEntityReference::hasAttributes()は、エンティティ参照ノードが属性を持っているかどうかを調べるためのメソッドです。このメソッドは引数を取らず、戻り値として真偽値（bool型）を返します。ノードに属性が一つでも存在すればtrueを、一つもなければfalseを返します。

サンプルコードでは、まず比較対象として、属性を持つ要素ノード（<product id="101">）と持たない要素ノード（<name>）でhasAttributes()を試しています。その結果、属性を持つ要素ではtrueが、持たない要素ではfalseが返されることが確認できます。

続いて、本題であるエンティティ参照ノード（©）に対して同じメソッドを実行しています。XMLやHTMLの仕様上、エンティティ参照ノード自体は属性を持つことができません。したがって、DOMEntityReferenceオブジェクトに対してhasAttributes()を実行した場合、このコードに示されているように常にfalseが返されます。このメソッドは、ノードの種類を問わず属性の有無を統一的に確認する際に役立ちますが、DOMEntityReferenceでは必ずfalseになるという特性を理解しておくことが重要です。