【PHP8.x】hasAttributesメソッドの使い方

Copy
1<?php
2
3/**
4 * DOMAttr::hasAttributes() メソッドの動作を示すサンプル関数。
5 *
6 * この関数は、DOMAttr::hasAttributes() メソッドが常に false を返すことを実演します。
7 * DOMAttr オブジェクトは属性ノード自体であり、通常はそれ自身がさらに「属性」を持つことはありません。
8 * 要素が属性を持っているかを確認する場合は、DOMElement::hasAttributes() を使用します。
9 */
10function demonstrateDomAttrHasAttributes(): void
11{
12    // 1. HTMLコンテンツを含むDOMDocumentオブジェクトを作成します。
13    $dom = new DOMDocument('1.0', 'UTF-8');
14    // loadHTMLはHTML5のタグをサポートしていないため、@で警告を抑制しています。
15    // 実際のアプリケーションでは、エラーハンドリングを適切に行うべきです。
16    @$dom->loadHTML('<div id="myDiv" class="example" data-info="test">Hello, World!</div>');
17
18    // 2. id="myDiv" の要素を取得します。
19    $divElement = $dom->getElementById('myDiv');
20
21    if ($divElement) {
22        echo "div要素が見つかりました。\n";
23
24        // 3. div要素から "id" 属性のDOMAttrノードを取得します。
25        $idAttr = $divElement->getAttributeNode('id');
26
27        if ($idAttr) {
28            echo "id属性ノードが見つかりました。\n";
29            echo "属性ノードの名前: " . $idAttr->name . "\n";  // 例: "id"
30            echo "属性ノードの値: " . $idAttr->value . "\n";   // 例: "myDiv"
31
32            // 4. DOMAttr::hasAttributes() メソッドを呼び出します。
33            // DOMAttr ノード自体は属性リストを持たないため、このメソッドは常に false を返します。
34            $hasAttributesOnAttr = $idAttr->hasAttributes();
35            echo "DOMAttr::hasAttributes() の結果 (id属性ノード): " . ($hasAttributesOnAttr ? 'true' : 'false') . "\n";
36
37            // 参考として、DOMElement::hasAttributes() の結果も表示します。
38            // div要素は 'id', 'class', 'data-info' などの属性を持っています。
39            $hasAttributesOnElement = $divElement->hasAttributes();
40            echo "DOMElement::hasAttributes() の結果 (div要素): " . ($hasAttributesOnElement ? 'true' : 'false') . "\n";
41
42        } else {
43            echo "指定された属性ノード (id) が見つかりませんでした。\n";
44        }
45    } else {
46        echo "指定された要素 (id='myDiv') が見つかりませんでした。\n";
47    }
48}
49
50// 関数を実行して、DOMAttr::hasAttributes() の動作を確認します。
51demonstrateDomAttrHasAttributes();
52
53?>

PHP 8のDOMAttr::hasAttributes()メソッドは、DOMAttrクラスに属し、属性ノード自体がさらに属性を持つかを判定します。このメソッドは引数を取らず、結果を真偽値（bool）で返します。

しかし、DOMAttrオブジェクトはHTMLやXML要素の「属性そのもの」を表しており、それ自身がさらに属性を持つことは通常ありません。そのため、このDOMAttr::hasAttributes()メソッドは常にfalseを返します。要素が属性を持っているかを確認したい場合は、DOMElement::hasAttributes()メソッドを使用します。この違いは、初心者にとって重要なポイントです。

サンプルコードは、div要素から取得したid属性ノードに対しDOMAttr::hasAttributes()を呼び出すとfalseが返ることを示します。一方、div要素自体にDOMElement::hasAttributes()を適用するとtrueが返される様子も確認でき、DOMAttrとDOMElementにおけるこのメソッドの動作の違いが明確に理解できます。