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

attributesプロパティの使い方について、初心者にもわかりやすく解説します。

作成日: 2025年09月11日更新日: 2025年11月22日

基本的な使い方

Dom\HTMLElementクラスのattributesプロパティは、その要素に設定されている属性（attributes）を保持するプロパティです。具体的には、このプロパティはDOMNamedNodeMapオブジェクトを返します。DOMNamedNodeMapは、属性名と属性値のペアをノードとして保持するコレクションであり、要素の属性にアクセスしたり、変更したりするために使用されます。

例えば、<div id="container" class="main">というHTML要素があった場合、attributesプロパティを通じてid属性（値は"container"）、class属性（値は"main"）にアクセスできます。

attributesプロパティを使用することで、要素の属性をプログラム的に取得、追加、削除、変更することが可能になります。属性の取得には、DOMNamedNodeMapのgetNamedItem()メソッドを、属性の追加にはsetNamedItem()メソッドを、属性の削除にはremoveNamedItem()メソッドを利用します。

このプロパティは、HTML要素の動的な操作や、属性に基づいた処理を行う際に非常に重要です。ウェブスクレイピングやHTMLドキュメントの構造解析、コンテンツ生成などの様々な場面で活用できます。要素の属性情報を操作することで、ウェブページの表示や動作を柔軟に制御することができます。attributesプロパティは読み取り専用であり、直接値を設定することはできません。属性の変更は、DOMNamedNodeMapのメソッドを通して行う必要があります。

構文(syntax)


1Dom\HTMLElement::$attributes;

引数(parameters)

引数なし

引数はありません

戻り値(return)

DOMNamedNodeMap|null

Dom\HTMLElement クラスの attributes プロパティは、その要素が持つ属性のコレクションである DOMNamedNodeMap オブジェクト、または属性が存在しない場合に null を返します。

サンプルコード

PHP HTML属性とアノテーションを扱う


1<?php
2
3// HTML 要素の属性 (attributes) と PHP のアノテーション (annotations) の使用例
4
5// attributes は、HTML 要素に定義された属性にアクセスするために使用されます。
6// annotations は、PHP コードにメタデータを追加するために使用されます。
7
8// HTML 文字列を解析
9$html = <<<HTML
10<!DOCTYPE html>
11<html>
12<head>
13    <title>サンプル</title>
14</head>
15<body>
16    <div id="myDiv" class="container" data-value="123">
17        <p>テキスト</p>
18    </div>
19</body>
20</html>
21HTML;
22
23$dom = new DOMDocument();
24$dom->loadHTML($html);
25
26// id が "myDiv" の要素を取得
27$element = $dom->getElementById('myDiv');
28
29// 属性を取得
30if ($element) {
31    $attributes = $element->attributes;
32
33    // 属性をループ処理
34    foreach ($attributes as $attribute) {
35        echo $attribute->name . ' = ' . $attribute->value . PHP_EOL;
36    }
37}
38
39// PHP 8 のアノテーション (属性) の例
40#[MyAttribute("Example")]
41class MyClass
42{
43    public function myFunction(#[MyParameterAttribute] string $param)
44    {
45        // 処理
46    }
47}
48
49// カスタム属性の定義
50#[\Attribute]
51class MyAttribute
52{
53    public function __construct(public string $value) {}
54}
55
56#[\Attribute]
57class MyParameterAttribute
58{
59}
60
61// アノテーションの利用例（リフレクションを使用）
62$reflectionClass = new ReflectionClass(MyClass::class);
63$attributes = $reflectionClass->getAttributes(MyAttribute::class);
64
65foreach ($attributes as $attribute) {
66    $instance = $attribute->newInstance();
67    echo "Class Annotation Value: " . $instance->value . PHP_EOL;
68}
69
70$reflectionMethod = $reflectionClass->getMethod('myFunction');
71$parameters = $reflectionMethod->getParameters();
72
73foreach ($parameters as $parameter) {
74    $attributes = $parameter->getAttributes(MyParameterAttribute::class);
75    if (!empty($attributes)) {
76        echo "Parameter '{$parameter->getName()}' has MyParameterAttribute." . PHP_EOL;
77    }
78}
79?>

このサンプルコードは、HTML要素の属性（attributes）とPHP 8のアノテーション（attributes）の違いを示すものです。Dom\HTMLElementクラスのattributesプロパティは、指定されたHTML要素に設定されている属性の集合をDOMNamedNodeMapオブジェクトとして返します。存在しない場合はnullを返します。引数は不要です。

前半部分では、HTML文字列を解析し、idが"myDiv"の要素を取得しています。そして、その要素のattributesプロパティにアクセスし、各属性の名前と値をループ処理で出力しています。これにより、HTML要素に定義されたid、class、data-valueといった属性をPHPから操作できます。

後半部分では、PHP 8で導入されたアノテーション（属性）の例を示しています。#[MyAttribute("Example")]のように、クラスやメソッド、パラメータに対してメタデータを付与できます。このメタデータは、リフレクションAPIを使って実行時に取得できます。サンプルでは、MyClassのMyAttributeアノテーションと、myFunctionメソッドのMyParameterAttributeアノテーションを取得し、その値を表示しています。

HTML要素のattributesは、HTML構造における属性を操作するためのものであり、PHPのアノテーションは、PHPコード自体にメタデータを付与するためのものです。これらは異なる概念であり、それぞれ異なる目的で使用されます。

Dom\HTMLElement->attributes は、HTML要素の属性を取得する際に利用します。取得できるのは、HTMLタグに直接記述された属性のみです。CSSで設定されたスタイルなどは含まれません。戻り値が DOMNamedNodeMap|null なので、要素が存在しない場合は null が返る可能性があるため、if ($element) のように存在確認が必要です。

PHP8のアノテーション（属性）は、クラスやメソッドにメタ情報を付与するために使用されます。リフレクションを使って情報を取得する必要がある点に注意してください。アノテーションは実行時の動作に直接影響を与えるものではなく、あくまで付加情報です。自作のアノテーションを定義する際は、#[\Attribute] を付与する必要があります。