【PHP8.x】Dom\HTMLElement::hasAttribute()メソッドの使い方

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

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

基本的な使い方

『hasAttributeメソッドは、Dom\HTMLElementオブジェクトが表すHTML要素に、指定された名前の属性が存在するかどうかを確認するために実行するメソッドです。このメソッドは、HTMLドキュメント内の特定のタグ（例えば<p>や<a>など）に対して使用します。引数として、存在を確認したい属性の名前を文字列で一つ渡します。メソッドの戻り値は真偽値（bool）であり、指定した名前の属性がその要素に設定されていればtrueを、設定されていなければfalseを返します。例えば、<a href="example.com" class="link">という要素を表すオブジェクトに対し、hasAttribute('href')を実行するとtrueが返りますが、hasAttribute('id')を実行するとfalseが返ります。この確認は属性の値には依存しないため、たとえ属性の値が空文字列（例：alt=""）であっても、属性自体が存在すればtrueを返します。この特性から、特定の属性を持つ要素だけを対象に処理を行いたい場合など、if文による条件分岐で広く利用されます。

構文(syntax)


1<?php
2$html = '<p id="intro">これは段落です。</p>';
3$doc = new DOMDocument();
4$doc->loadHTML($html, LIBXML_HTML_NOIMPLIED | LIBXML_HTML_NODEFDTD);
5
6// <p> 要素 (Dom\HTMLElement のインスタンス) を取得
7$element = $doc->getElementsByTagName('p')->item(0);
8
9// 要素が 'id' 属性を持っているかを確認します (結果: true)
10$result = $element->hasAttribute('id');
11
12var_dump($result);

引数(parameters)

string $qualifiedName

string $qualifiedName: 属性名（名前空間を考慮した完全修飾名）を指定する文字列

戻り値(return)

bool

要素が指定された属性を持っているかどうかを真偽値（true または false）で返します。

サンプルコード

PHP DOMDocument hasAttributeで属性を判定する


1<?php
2
3// Dom\HTMLElement::hasAttribute のサンプルコード
4
5// HTMLドキュメントを作成
6$dom = new DOMDocument();
7$dom->loadHTML('<!DOCTYPE html><html><body><p id="myParagraph" class="highlight">Hello World</p></body></html>');
8
9// id属性を持つ要素を取得
10$element = $dom->getElementById('myParagraph');
11
12// id属性の存在を確認
13if ($element->hasAttribute('id')) {
14    echo "id属性は存在します。\n"; // 出力される
15} else {
16    echo "id属性は存在しません。\n";
17}
18
19// class属性の存在を確認
20if ($element->hasAttribute('class')) {
21    echo "class属性は存在します。\n"; // 出力される
22} else {
23    echo "class属性は存在しません。\n";
24}
25
26// style属性の存在を確認
27if ($element->hasAttribute('style')) {
28    echo "style属性は存在します。\n";
29} else {
30    echo "style属性は存在しません。\n"; // 出力される
31}
32?>

PHPのDOM拡張モジュールにおけるDom\HTMLElementクラスのhasAttributeメソッドは、要素が指定された属性を持っているかどうかを確認するために使用します。このメソッドは、引数として属性の名前（$qualifiedName）を受け取ります。属性名は文字列で指定します。

サンプルコードでは、まずDOMDocumentクラスを使ってHTMLドキュメントを作成し、ロードしています。次に、getElementByIdメソッドを使って、id属性がmyParagraphである要素を取得しています。

hasAttributeメソッドは、指定された属性が存在する場合にtrue、存在しない場合にfalseを返します。サンプルコードでは、取得した要素に対してhasAttributeメソッドを使い、id属性、class属性、style属性の存在を確認しています。id属性とclass属性は要素に存在するため、それぞれのif文の中で「属性は存在します」というメッセージが出力されます。style属性は存在しないため、else文の中の「属性は存在しません」というメッセージが出力されます。

このメソッドを利用することで、HTML要素の属性の有無をプログラムで簡単に判断し、それに応じた処理を行うことができます。例えば、特定の属性が存在する場合のみスタイルを変更したり、属性の値に応じて表示内容を切り替えたりするような処理を実装できます。

Dom\HTMLElement::hasAttributeは、指定した属性が要素に存在するかどうかを確認するメソッドです。引数には属性名を文字列で渡します。大文字小文字は区別されます。

このメソッドを使用する前に、DOMDocumentクラスでHTMLを読み込み、getElementByIdなどで要素を取得する必要があります。要素が存在しない場合、hasAttributeを呼び出すとエラーになる可能性があるため、事前に要素の存在を確認することが重要です。

hasAttributeは属性の値をチェックするのではなく、あくまで属性が存在するかどうかを判定する点に注意してください。属性が存在しても、値が空文字列の場合もあります。属性値を取得したい場合は、getAttributeメソッドを使用します。また、HTMLの構造が正しくない場合、期待通りに動作しないことがあります。

PHP DOM hasAttributeで属性存在確認する


1<?php
2
3// HTML ドキュメントをロードする
4$dom = new DOMDocument();
5$dom->loadHTML('<!DOCTYPE html><html><body><p id="myParagraph" class="highlight">This is a paragraph.</p></body></html>');
6
7// ID が "myParagraph" の要素を取得する
8$element = $dom->getElementById('myParagraph');
9
10// "class" 属性が存在するかどうかを確認する
11if ($element && $element->hasAttribute('class')) {
12    echo "The element has the 'class' attribute.\n";
13} else {
14    echo "The element does not have the 'class' attribute.\n";
15}
16
17// "style" 属性が存在するかどうかを確認する
18if ($element && $element->hasAttribute('style')) {
19    echo "The element has the 'style' attribute.\n";
20} else {
21    echo "The element does not have the 'style' attribute.\n";
22}
23
24?>

このサンプルコードは、PHPのDOM拡張に含まれるDom\HTMLElementクラスのhasAttributeメソッドの使い方を示しています。hasAttributeメソッドは、指定された要素が特定の属性を持っているかどうかを確認するために使用します。

まず、DOMDocumentクラスのインスタンスを作成し、loadHTMLメソッドを使ってHTMLドキュメントをロードします。次に、getElementByIdメソッドで、IDが"myParagraph"の要素を取得します。

hasAttributeメソッドは、文字列型の引数$qualifiedNameを受け取ります。この引数には、確認したい属性の名前を指定します。メソッドは、指定された属性が要素に存在する場合はtrue、存在しない場合はfalseを返します。

サンプルコードでは、hasAttribute('class')を使って"class"属性の存在を確認し、存在する場合は「The element has the 'class' attribute.」と出力します。同様に、hasAttribute('style')を使って"style"属性の存在を確認し、存在しないため「The element does not have the 'style' attribute.」と出力します。

hasAttributeメソッドを使うことで、要素の属性の有無を簡単に確認し、条件分岐を行うことができます。これは、動的にHTMLを操作する際に非常に役立ちます。例えば、特定の属性が存在する場合にのみ、別の処理を実行するといった制御が可能になります。

hasAttributeメソッドは、指定した属性が要素に存在するかどうかを確認する際に使用します。引数$qualifiedNameには、確認したい属性の名前を文字列で指定します。属性名は大文字小文字を区別しますので注意してください。DOMDocumentのloadHTMLメソッドでHTMLを読み込む際、文字エンコーディングに注意が必要です。getElementByIdで要素を取得する前に、loadHTMLが成功しているか確認するとより安全です。$elementがnullでないことを確認してからhasAttributeを呼び出すことで、エラーを回避できます。