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

hasAttributeメソッドの使い方について、初心者にもわかりやすく解説します。

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

基本的な使い方

hasAttributeメソッドは、DOMElementオブジェクトが指定された名前の属性を持っているかどうかを確認するために実行するメソッドです。このメソッドは、HTMLやXMLドキュメント内の特定の要素が、ある属性を持っているかを調べたい場合に役立ちます。引数には、存在を確認したい属性の名前を文字列で指定します。メソッドを実行すると、指定した名前の属性がその要素に存在する場合はtrueを、存在しない場合はfalseを返します。この戻り値はブール値であるため、if文などの条件分岐で利用して、属性の有無に応じた処理を簡単に行うことができます。例えば、<img>タグにalt属性が設定されているかを確認し、設定されていない場合にのみ特定の処理を実行するといった制御が可能になります。属性の値を取得するgetAttributeメソッドとは異なり、このメソッドは属性の存在そのものを判定します。そのため、属性の値が空文字列の場合と、属性自体が存在しない場合とを明確に区別したい場合に特に有効です。DOMを操作する上で、要素の状態を安全かつ確実にチェックするための基本的なメソッドの一つです。

構文(syntax)


1<?php
2
3$xmlString = '<product id="101" available="true">Book</product>';
4$dom = new DOMDocument();
5$dom->loadXML($xmlString);
6
7$element = $dom->getElementsByTagName('product')->item(0);
8
9/*
10 * 構文:
11 * public DOMElement::hasAttribute(string $name): bool
12 */
13
14// "available" 属性が存在するかどうかを確認します (結果: true)
15$hasAvailable = $element->hasAttribute('available');
16var_dump($hasAvailable);
17
18// "price" 属性が存在するかどうかを確認します (結果: false)
19$hasPrice = $element->hasAttribute('price');
20var_dump($hasPrice);
21
22?>

引数(parameters)

string $qualifiedName

string $qualifiedName: 属性の名前を指定する文字列

戻り値(return)

bool

指定された属性が存在するかどうかを示す真偽値 (true または false) を返します。

サンプルコード

PHP DOMElement::hasAttribute を使う


1<?php
2
3declare(strict_types=1);
4
5/**
6 * DOMElement::hasAttribute の使い方を実演します。
7 *
8 * この関数は、HTMLドキュメント内の特定の要素が、
9 * 指定された名前の属性を持っているかどうかを確認し、結果を出力します。
10 */
11function demonstrateHasAttribute(): void
12{
13    // 解析するHTML文字列を定義します。
14    $html = <<<HTML
15    <!DOCTYPE html>
16    <html lang="ja">
17    <head>
18        <meta charset="UTF-8">
19        <title>サンプル</title>
20    </head>
21    <body>
22        <p id="p1" class="greeting">この段落にはidとclass属性があります。</p>
23        <p>この段落には属性がありません。</p>
24    </body>
25    </html>
26    HTML;
27
28    // DOMDocumentオブジェクトを作成し、HTMLを読み込みます。
29    $dom = new DOMDocument();
30    // HTML5の要素に対する警告を抑制するため、エラー制御演算子 @ を使用します。
31    @$dom->loadHTML($html);
32
33    // ID 'p1' を持つ要素を取得します。
34    // getElementByIdはDOMElementオブジェクトまたはnullを返します。
35    $element = $dom->getElementById('p1');
36
37    // 要素が正しく取得できたかを確認します。
38    if ($element instanceof DOMElement) {
39        // --- DOMElement::hasAttribute の使用例 ---
40
41        // 1. 'class' 属性が存在するかどうかをチェックします。(trueが返る)
42        $attributeNameToCheck1 = 'class';
43        if ($element->hasAttribute($attributeNameToCheck1)) {
44            echo "要素 (ID: p1) は '{$attributeNameToCheck1}' 属性を持っています。\n";
45        } else {
46            echo "要素 (ID: p1) は '{$attributeNameToCheck1}' 属性を持っていません。\n";
47        }
48
49        // 2. 存在しない 'style' 属性があるかチェックします。(falseが返る)
50        $attributeNameToCheck2 = 'style';
51        if ($element->hasAttribute($attributeNameToCheck2)) {
52            echo "要素 (ID: p1) は '{$attributeNameToCheck2}' 属性を持っています。\n";
53        } else {
54            echo "要素 (ID: p1) は '{$attributeNameToCheck2}' 属性を持っていません。\n";
55        }
56    } else {
57        echo "ID 'p1' の要素が見つかりませんでした。\n";
58    }
59}
60
61// 関数を実行します。
62demonstrateHasAttribute();
63
64?>

DOMElement::hasAttributeメソッドは、PHPでHTMLやXMLの特定の要素が、指定した名前の属性を持っているかどうかを判定するために使用します。

このメソッドは、引数として調べたい属性の名前を文字列で受け取ります。例えば、class属性の有無を確認したい場合は、'class'という文字列を渡します。メソッドの実行結果として、戻り値に真偽値（bool型）が返されます。指定した属性が存在する場合にはtrue、存在しない場合にはfalseが返るため、if文による条件分岐で役立ちます。

サンプルコードでは、まずHTMLドキュメントを読み込み、id="p1"を持つ段落要素を取得しています。そして、この要素に対してhasAttributeメソッドを使用しています。'class'属性の存在を確認した場合は、実際に属性があるためtrueが返されます。次に、存在しない'style'属性を確認した場合は、falseが返ります。このように、hasAttributeメソッドを使えば、属性の有無に基づいて処理を安全に分岐させることが可能になります。

getElementByIdメソッドは、指定したIDの要素が見つからない場合にnullを返すことがあります。nullに対してhasAttributeを実行するとエラーになるため、必ず事前にif文などで要素が取得できたかを確認してください。hasAttributeは属性の「存在」をtrueかfalseで判定するだけで、属性の値を調べるものではありません。属性の値を取得するにはgetAttributeメソッドを使用します。また、引数に指定する属性名は、大文字と小文字が区別されるため、HTMLで定義されている通りの小文字で指定するのが安全です。loadHTMLの前に付いている@は、HTMLの構文解析エラーを抑制しますが、開発中はエラーを確認することも重要です。

PHP DOM hasAttribute 属性存在確認


1<?php
2
3// DOMDocument の新しいインスタンスを作成します。
4// これは HTML や XML ドキュメントをプログラムで操作するための基盤となります。
5$dom = new DOMDocument();
6
7// HTML 文字列をロードします。
8// LIBXML_HTML_NOIMPLIED と LIBXML_HTML_NODEFDTD フラグは、
9// 余分な <html>, <head>, <body> タグや DOCTYPE 宣言が自動的に追加されるのを防ぎ、
10// よりシンプルなDOMツリーを作成するのに役立ちます。
11$htmlString = '<div id="container">' .
12              '  <p class="intro" data-id="123">これはパラグラフです。</p>' .
13              '  <span>これはスパンです。</span>' .
14              '</div>';
15$dom->loadHTML($htmlString, LIBXML_HTML_NOIMPLIED | LIBXML_HTML_NODEFDTD);
16
17// IDが 'container' の要素をドキュメントから取得します。
18// getElementById は DOMDocument のメソッドで、ドキュメント全体から特定のIDを持つ要素を検索します。
19$containerElement = $dom->getElementById('container');
20
21// 取得した要素が DOMElement のインスタンスであるかを確認します。
22// 取得に失敗した場合 (例: IDが存在しない場合) は null が返されるため、このチェックは重要です。
23if ($containerElement instanceof DOMElement) {
24    echo "ID 'container' を持つ要素が見つかりました。\n\n";
25
26    // containerElement の最初の子要素である <p> タグを取得します。
27    // firstChild プロパティで直接子要素にアクセスできます。
28    // (この例では改行文字がテキストノードとしてカウントされる可能性があるので、より堅牢な方法としては getElementsByTagName などが考えられますが、ここではシンプルにfirstElementChildを使用します)
29    // 注意: firstChild はテキストノードも含む可能性があるため、firstElementChild を使用するとより確実に要素ノードを取得できます。
30    $paragraphElement = null;
31    foreach ($containerElement->childNodes as $childNode) {
32        if ($childNode->nodeType === XML_ELEMENT_NODE && $childNode->nodeName === 'p') {
33            $paragraphElement = $childNode;
34            break;
35        }
36    }
37
38    if ($paragraphElement instanceof DOMElement) {
39        echo "パラグラフ要素が見つかりました。\n";
40
41        // hasAttribute メソッドを使用して、'class' 属性が存在するか確認します。
42        $hasCssClass = $paragraphElement->hasAttribute('class');
43        echo "パラグラフ要素に 'class' 属性はありますか？ " . ($hasCssClass ? 'はい' : 'いいえ') . "\n"; // 期待値: はい
44
45        // hasAttribute メソッドを使用して、'data-id' 属性が存在するか確認します。
46        $hasDataId = $paragraphElement->hasAttribute('data-id');
47        echo "パラグラフ要素に 'data-id' 属性はありますか？ " . ($hasDataId ? 'はい' : 'いいえ') . "\n"; // 期待値: はい
48
49        // hasAttribute メソッドを使用して、存在しない 'style' 属性をチェックします。
50        $hasStyle = $paragraphElement->hasAttribute('style');
51        echo "パラグラフ要素に 'style' 属性はありますか？ " . ($hasStyle ? 'はい' : 'いいえ') . "\n"; // 期待値: いいえ
52
53        // hasAttribute メソッドを使用して、存在しない 'lang' 属性をチェックします。
54        $hasLang = $paragraphElement->hasAttribute('lang');
55        echo "パラグラフ要素に 'lang' 属性はありますか？ " . ($hasLang ? 'はい' : 'いいえ') . "\n"; // 期待値: いいえ
56    } else {
57        echo "パラグラフ要素が見つかりませんでした。\n";
58    }
59} else {
60    echo "ID 'container' を持つ要素が見つかりませんでした。\n";
61}
62
63?>

DOMElement::hasAttributeメソッドは、PHPでHTMLやXMLドキュメントの特定の要素が、指定された属性を持っているかどうかを確認するために使用されます。

このメソッドは、string $qualifiedNameという引数に、確認したい属性の名前（例えば「class」や「id」など）を受け取ります。戻り値はbool型で、指定した属性が要素に存在すればtrue（真）、存在しなければfalse（偽）を返します。

サンプルコードでは、まずDOMDocumentオブジェクトを作成し、HTML文字列を読み込んでいます。次に、getElementByIdメソッドを使ってIDが「container」のdiv要素を取得し、その中の<p>要素にアクセスしています。そして、この<p>要素に対してhasAttributeメソッドを複数回呼び出し、さまざまな属性の有無を調べています。例えば、hasAttribute('class')では「class」属性の有無を、hasAttribute('data-id')では「data-id」属性の有無を確認し、その結果を「はい」または「いいえ」で表示しています。存在しない属性（例えば「style」や「lang」）をチェックした場合も、正しくfalseを返すことが示されており、プログラムはHTML要素の属性状況を効率的に判断し、それに応じた処理を行うことができます。

DOMElement::hasAttribute メソッドは、対象のDOM要素に指定した属性が存在するかどうかを確認するために使います。引数には確認したい属性の名前を正確な文字列で渡してください。このメソッドは属性があれば true、なければ false をブール値で返しますので、コード内で属性の有無に応じた条件分岐を行う際に非常に役立ちます。

特に注意が必要な点として、このメソッドは必ず DOMElement のインスタンスに対して呼び出す必要があります。DOMDocument::getElementById などで要素を取得した場合、対象の要素が存在しないと null が返されることがあります。null に対して hasAttribute を呼び出すとエラーが発生するため、必ず if ($element instanceof DOMElement) のように、要素が正しく取得されているかを確認してから使用してください。このメソッドは属性の値ではなく、属性キー自体が存在するかどうかをチェックします。