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

Copy
1<?php
2
3/**
4 * DOMText::hasAttributes() メソッドの動作をデモンストレーションする関数。
5 * DOMTextノードが属性を持つことができないため、このメソッドは常に false を返します。
6 */
7function demonstrateDomTextHasAttributes(): void
8{
9    // 1. DOMDocument のインスタンスを作成
10    // XML または HTML ドキュメントを操作するための基盤となります。
11    $dom = new DOMDocument('1.0', 'UTF-8');
12
13    // 2. テキストコンテンツを含む要素（DOMElement）を作成し、ドキュメントに追加
14    // この要素内に DOMText ノードが自動的に生成されます。
15    $element = $dom->createElement('p', 'これはサンプルテキストです。');
16    $dom->appendChild($element);
17
18    // 3. 作成した要素から DOMText ノードを取得
19    // 'p'要素の最初の子ノードは、通常そのテキストコンテンツを表す DOMText ノードです。
20    $textNode = $element->firstChild;
21
22    // 4. 取得したノードが DOMText のインスタンスであるか確認
23    if ($textNode instanceof DOMText) {
24        echo "ノードの種類: DOMText\n";
25
26        // 5. DOMText::hasAttributes() メソッドを呼び出し、結果を出力
27        // DOMText ノードは属性を持たないため、常に false が返されます。
28        $hasAttrs = $textNode->hasAttributes();
29        echo "DOMTextノードは属性を持っていますか？: " . ($hasAttrs ? 'はい' : 'いいえ') . "\n";
30    } else {
31        // 予期しないノードタイプの場合のエラーハンドリング
32        echo "エラー: 期待されたDOMTextノードが見つかりませんでした。実際のノードタイプ: " . get_class($textNode) . "\n";
33    }
34}
35
36// 関数を実行してデモンストレーションを開始
37demonstrateDomTextHasAttributes();

PHP 8のDOMText::hasAttributes()メソッドは、XMLやHTMLドキュメントを操作する際に、特定のテキストノードが属性を持っているかどうかを判別するために使用されます。このメソッドは引数を一切取らず、ノードが属性を持っていればtrue、持っていなければfalseという真偽値（bool）を戻り値として返します。しかし、DOMTextノードは要素の純粋なテキストコンテンツを表すため、本来的に属性を持つことはありません。

サンプルコードでは、まずDOMDocumentのインスタンスを作成し、ドキュメントの基盤を準備しています。次に、createElement()とappendChild()を使って、「これはサンプルテキストです。」というテキストを含む<p>要素をドキュメントに追加しています。この<p>要素のテキストコンテンツは、自動的にDOMTextノードとして内部で表現されます。

コードは$element->firstChildからこのDOMTextノードを取得し、それが確かにDOMTextのインスタンスであることを確認した上で、hasAttributes()メソッドを呼び出しています。実行すると、出力は常に「DOMTextノードは属性を持っていますか？: いいえ」となります。これは、DOMTextが属性を持たないというその性質に基づいているため、このメソッドは常にfalseを返すということを明確に示しています。この挙動は、DOMツリーを走査する際に、ノードの種類に応じた適切な処理を行う上で理解しておくべき重要な点です。