【PHP8.x】DOMText::attributesプロパティの使い方

Copy
1<?php
2
3// DOMText クラスの attributes プロパティは常に NULL を返します。
4// アノテーション (PHP 8 以降の attributes) とは全く異なる概念です。
5
6// DOMText オブジェクトを作成
7$dom = new DOMDocument();
8$textNode = $dom->createTextNode("Hello, world!");
9
10// attributes プロパティにアクセス (常に NULL)
11$attributes = $textNode->attributes;
12
13if ($attributes === null) {
14    echo "DOMText attributes プロパティは常に NULL です。\n";
15} else {
16    echo "DOMText attributes プロパティは DOMNamedNodeMap オブジェクトではありません。\n";
17}
18
19// PHP 8 以降のアノテーション (attributes) の例 (DOMText とは無関係)
20#[ExampleAttribute("value")]
21class ExampleClass {
22    public function exampleMethod() {
23        // ...
24    }
25}
26
27// アノテーションの情報を取得する例 (DOMText とは無関係)
28$reflectionClass = new ReflectionClass(ExampleClass::class);
29$attributes = $reflectionClass->getAttributes();
30
31foreach ($attributes as $attribute) {
32    echo "アノテーション名: " . $attribute->getName() . "\n";
33    echo "アノテーション引数: " . json_encode($attribute->getArguments()) . "\n";
34}
35
36// ExampleAttribute は存在しないクラスのため、上記コードは実行時にエラーが発生する可能性があります。
37// これは、アノテーションの使用例を示すためのものであり、DOMText の attributes プロパティとは関係ありません。
38
39class ExampleAttribute {
40    public function __construct(public string $value) {}
41}

PHPのDOMTextクラスにおけるattributesプロパティは、テキストノードに関連付けられた属性を取得するためのものではなく、常にNULLを返します。これは、テキストノードが属性を持たないためです。戻り値の型は?DOMNamedNodeMapと定義されていますが、実際にはNULLが返されます。

このプロパティは、PHP 8以降で導入されたアノテーション（attributes）とは全く異なる概念である点に注意が必要です。アノテーションは、クラスやメソッドなどの宣言にメタデータを付与する機能であり、#[ExampleAttribute("value")]のように記述します。アノテーションの情報は、Reflection APIを用いて取得できます。

サンプルコードでは、まずDOMTextオブジェクトを作成し、attributesプロパティにアクセスしています。その結果がNULLであることを確認することで、DOMTextのattributesプロパティが常にNULLを返すことを示しています。

次に、アノテーションの簡単な例を示しています。ExampleClassというクラスに#[ExampleAttribute("value")]というアノテーションを付与し、Reflection APIを使ってアノテーションの名前と引数を取得しています。ただし、ExampleAttributeクラスが定義されていない場合、エラーが発生する可能性があります。このアノテーションの例は、DOMTextのattributesプロパティとは全く関係がないことを明確にするために含まれています。DOMTextのattributesとアノテーションは名前が似ていますが、機能や用途は全く異なるため混同しないようにしてください。