【PHP8.x】DOMProcessingInstruction::hasAttributes()メソッドの使い方

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

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

基本的な使い方

『hasAttributesメソッドは、DOMProcessingInstructionオブジェクトが属性を持っているかどうかを確認するメソッドです』このメソッドは、対象となる処理命令ノードに属性が存在するかを調べ、その結果を真偽値で返します。属性が存在すればtrue、存在しなければfalseを返しますが、XMLおよびHTMLの仕様上、処理命令ノードは属性を持つことができません。したがって、DOMProcessingInstructionオブジェクトに対してこのメソッドを呼び出した場合、その返り値は常にfalseとなります。このメソッドは、すべてのノードの基本クラスであるDOMNodeから継承されています。DOMElementのような要素ノードでは属性を持つことができるためtrueを返す可能性がありますが、DOMProcessingInstructionでは構造的に属性を持たないためです。このメソッドは、DOMにおけるノード操作の一貫性を保つために用意されていますが、処理命令ノードに対しては属性が存在しないという仕様を理解した上で使用することが重要です。

構文(syntax)


1<?php
2$document = new DOMDocument();
3
4// <?php-app-version check="true"?> という処理命令ノードを作成します
5$pi = $document->createProcessingInstruction('php-app-version', 'check="true"');
6
7// 処理命令ノードが属性を持つか確認します。
8// このメソッドは常に false を返します。
9$result = $pi->hasAttributes();
10
11var_dump($result); // bool(false)
12?>

引数(parameters)

引数なし

引数はありません

戻り値(return)

bool

このメソッドは、DOMProcessingInstructionノードが属性を持っているかどうかを示す真偽値（boolean）を返します。属性があればtrue、なければfalseを返します。

サンプルコード

DOMProcessingInstruction::hasAttributes を確認する


1<?php
2
3declare(strict_types=1);
4
5/**
6 * DOMProcessingInstruction::hasAttributes の使用例を示します。
7 *
8 * 処理命令 (Processing Instruction) ノードはXMLの仕様上、属性を持つことができないため、
9 * このメソッドは常に false を返します。このサンプルではその挙動を確認します。
10 */
11function checkProcessingInstructionAttributes(): void
12{
13    // 1. DOMDocumentオブジェクトを作成します。
14    $dom = new DOMDocument('1.0', 'UTF-8');
15
16    // 2. 処理命令ノードを作成します。
17    // 例: <?xml-stylesheet type="text/css" href="style.css"?>
18    $pi = $dom->createProcessingInstruction(
19        'xml-stylesheet',
20        'type="text/css" href="style.css"'
21    );
22
23    // 3. ドキュメントに処理命令ノードを追加します。
24    $dom->appendChild($pi);
25
26    // 4. 追加した処理命令ノードを取得します。
27    // 今回は最初の子ノードとして追加したため、firstChildで取得できます。
28    $node = $dom->firstChild;
29
30    // 5. 取得したノードがDOMProcessingInstructionのインスタンスであることを確認します。
31    if ($node instanceof DOMProcessingInstruction) {
32        // 6. hasAttributes() メソッドを呼び出して、属性の有無を確認します。
33        // 処理命令ノードは属性を持てないため、常に false が返されます。
34        $hasAttributes = $node->hasAttributes();
35
36        // 7. 結果を出力します。
37        echo '処理命令ノードは属性を持っていますか？' . PHP_EOL;
38        var_dump($hasAttributes); // bool(false) が出力されます。
39    }
40}
41
42// 関数を実行して結果を確認します。
43checkProcessingInstructionAttributes();

DOMProcessingInstruction::hasAttributes()は、PHPでXMLの処理命令ノード（Processing Instruction Node）を扱う際に、そのノードが属性を持っているかどうかを判定するためのメソッドです。

このメソッドは引数を必要とせず、戻り値として属性の有無を示す真偽値（bool型）を返します。具体的には、属性が存在すればtrue、存在しなければfalseを返すように設計されています。

しかし、XMLの仕様上、処理命令ノードは属性を持つことができません。そのため、DOMProcessingInstructionオブジェクトに対してこのメソッドを呼び出した場合、その結果は常にfalseとなります。

サンプルコードでは、まずDOMDocumentオブジェクトとcreateProcessingInstructionメソッドを使って、<?xml-stylesheet ...?>のような処理命令ノードを作成しています。そして、作成されたノードに対してhasAttributes()メソッドを実行し、その結果が仕様通りfalseであることをvar_dump関数で出力して確認しています。このコードは、メソッドのこの特有の挙動を実証するものです。

DOMProcessingInstructionクラスのhasAttributes()メソッドは、XMLの仕様上、処理命令ノードが属性を持つことができないため、常にfalseを返します。このメソッドで属性の有無を判定する処理は実質的に意味を持ちません。サンプルコードにある'type="text/css" href="style.css"'の部分は、見た目が属性のようですが、これは属性ではなく単一の文字列データとして扱われる点に注意が必要です。このデータを操作したい場合は、dataプロパティにアクセスし、文字列としてご自身で解析する必要があります。また、instanceofを使ってノードの種類を確認してからメソッドを呼び出すのは、予期せぬエラーを防ぐための良い習慣です。