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

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

作成日: 2025年09月11日更新日: 2025年12月02日

基本的な使い方

hasAttributesメソッドは、DOMDocumentTypeオブジェクトが属性を持つかどうかを確認するメソッドです。DOMDocumentTypeは、XMLドキュメントやHTMLドキュメントにおけるDOCTYPE宣言を表すオブジェクトです。DOCTYPE宣言は、ドキュメントの構造や使用するDTD（Document Type Definition）を定義するために使用されます。

このメソッドは、DOCTYPE宣言が属性を持つ場合にtrueを返し、持たない場合にfalseを返します。DOCTYPE宣言自体が属性を持つことは稀ですが、DTDによってはDOCTYPE宣言に属性を持たせることが可能です。

システムエンジニアを目指す初心者の方にとって、このメソッドは、XMLやHTMLドキュメントをプログラムで扱う際に、DOCTYPE宣言の情報を取得し、処理を分岐させる必要がある場合に役立ちます。例えば、特定のDTDを使用しているドキュメントに対してのみ、特定の処理を実行するといった場合に利用できます。

DOMDocumentTypeオブジェクトのhasAttributesメソッドを使用することで、DOCTYPE宣言の属性の有無を簡単に判定でき、より柔軟なドキュメント処理を実装できます。このメソッドは、DOM (Document Object Model) を利用したXMLやHTMLの解析、操作において、ドキュメントの構造を把握し、適切に処理を行うための重要なツールの一つと言えるでしょう。

構文(syntax)


1<?php
2$dom = new DOMDocument('1.0', 'UTF-8');
3$doctype = $dom->implementation->createDocumentType('html', '', '');
4$dom->appendChild($doctype);
5
6if ($doctype->hasAttributes()) {
7  echo "Document type has attributes\n";
8} else {
9  echo "Document type has no attributes\n";
10}
11?>

引数(parameters)

引数なし

引数はありません

戻り値(return)

bool

このメソッドは、DOMDocumentTypeノードが属性を持っているかどうかを真偽値（trueまたはfalse）で返します。

サンプルコード

DOMDocumentType::hasAttributes() で属性の有無を確認する


1<?php
2
3// DOMDocumentType::hasAttributes() のサンプルコード
4
5// 新しい DOMDocument を作成
6$dom = new DOMDocument();
7
8// <!DOCTYPE> を作成
9$doctype = $dom->implementation->createDocumentType('html', '', '');
10
11// DOMDocument に <!DOCTYPE> を追加
12$dom->appendChild($doctype);
13
14// DOMDocumentType ノードを取得
15$docTypeNode = $dom->doctype;
16
17// 属性がないことを確認
18if ($docTypeNode->hasAttributes()) {
19    echo "<!DOCTYPE> has attributes.\n";
20} else {
21    echo "<!DOCTYPE> does not have attributes.\n"; // こちらが出力される
22}
23
24// <!DOCTYPE> にダミーの属性を追加 (実際には属性は追加できない)
25// $docTypeNode->setAttribute('dummy', 'value');  // これはエラーになる
26
27// 再度、属性の有無を確認 (ダミーの属性は追加できないため結果は変わらない)
28if ($docTypeNode->hasAttributes()) {
29    echo "<!DOCTYPE> has attributes.\n";
30} else {
31    echo "<!DOCTYPE> still does not have attributes.\n"; // こちらが出力される
32}

このPHPのサンプルコードは、DOMDocumentTypeクラスのhasAttributesメソッドの使い方を示しています。DOMDocumentTypeは、XMLドキュメントのDOCTYPE宣言を表すノードです。hasAttributesメソッドは、DOCTYPE宣言に属性が存在するかどうかを調べ、結果をboolean値（trueまたはfalse）で返します。引数は不要です。

このサンプルでは、まずDOMDocumentオブジェクトを作成し、createDocumentTypeメソッドでDOCTYPE宣言を作成します。次に、作成したDOCTYPE宣言をDOMDocumentに追加し、$dom->doctypeでDOMDocumentTypeノードを取得しています。

そして、hasAttributesメソッドを使って、DOCTYPE宣言に属性が存在するかどうかを確認します。DOCTYPE宣言は通常、属性を持たないため、最初のif文では「<!DOCTYPE> does not have attributes.」が出力されます。

コメントアウトされていますが、setAttributeメソッドを使ってDOCTYPE宣言に属性を追加しようとすると、エラーが発生します。これは、DOCTYPE宣言が属性を持つことを許可されていないためです。そのため、2回目のhasAttributesメソッドの呼び出しでも、結果は変わらず、「<!DOCTYPE> still does not have attributes.」が出力されます。

このコードは、hasAttributesメソッドがDOCTYPE宣言に対して常にfalseを返すことを示唆しています。DOCTYPE宣言自体は属性を持てませんが、このメソッドを使うことで、プログラム内でDOCTYPE宣言の状態を確認することができます。

DOMDocumentType::hasAttributes()は、<!DOCTYPE>ノードが属性を持つかどうかを確認するメソッドです。しかし、<!DOCTYPE>ノードはDTDの定義において属性を持つことができません。そのため、このメソッドは常にfalseを返すことに注意が必要です。サンプルコードでは、属性を追加しようとしていますが、実際にはsetAttribute()は使用できずエラーが発生します。hasAttributes()は、DOCTYPEノードに属性が存在するかをチェックする目的には適していません。他のノードタイプ（例えば、Elementノード）での属性の有無を確認する際に利用します。