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

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

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

基本的な使い方

『nodeType』プロパティは、DOMツリー内におけるノードの種類を識別するための整数値を保持するプロパティです。DOMドキュメントは、要素、属性、テキスト、コメントなど、さまざまな種類のノードから構成されています。プログラムで特定の種類のノードだけを対象に処理を行いたい場合、このnodeTypeプロパティの値を確認することで、ノードの種類を判別できます。Dom\ProcessingInstructionクラスのインスタンスの場合、このプロパティが返す値は常に整数値の7となります。この数値は、処理命令ノード（Processing Instruction Node）を表すPHPの定義済み定数XML_PI_NODEに対応しています。コード内で条件分岐を行う際には、7という直接的な数値（マジックナンバー）を使用するよりも、XML_PI_NODE定数と比較する方が可読性が高く、意図が明確になります。このプロパティは読み取り専用であり、その値はオブジェクトがインスタンス化された時点で決定されるため、後から変更することはできません。

構文(syntax)


1<?php
2
3$doc = new \Dom\Document();
4$doc->loadXML('<?php-app target="myapp" instruction="go"?>');
5
6// 処理命令ノード（ProcessingInstruction）を取得します
7$pi = $doc->firstChild;
8
9// Dom\ProcessingInstruction オブジェクトの nodeType プロパティにアクセスします。
10// このプロパティは読み取り専用で、ノードの種類を示す整数を返します。
11// 処理命令ノードの場合、この値は常に 7 となります。
12$type = $pi->nodeType;
13
14var_dump($type); // int(7)
15
16?>

引数(parameters)

引数なし

引数はありません

戻り値(return)

int

Dom\ProcessingInstruction::nodeType は、このノードが XML または HTML における処理命令であることを示す整数値を返します。

サンプルコード

PHP DOM Processing Instruction nodeType を取得する


1<?php
2
3declare(strict_types=1);
4
5/**
6 * DOMProcessingInstruction の nodeType プロパティの例を示します。
7 *
8 * この関数は、処理命令 (Processing Instruction) を含むXMLを解析し、
9 * そのノードの nodeType プロパティの値を出力します。
10 */
11function demonstrateProcessingInstructionNodeType(): void
12{
13    // 処理命令 (<?xml-stylesheet ... ?>) を含むXML文字列を定義
14    $xmlString = <<<XML
15<?xml version="1.0" encoding="UTF-8"?>
16<?xml-stylesheet type="text/css" href="style.css"?>
17<document>
18  <title>Sample Document</title>
19</document>
20XML;
21
22    // DOMDocument オブジェクトをインスタンス化
23    $doc = new DOMDocument();
24
25    // XML文字列を読み込む
26    $doc->loadXML($xmlString);
27
28    // ドキュメント直下の子ノードを順に調べる
29    foreach ($doc->childNodes as $node) {
30        // ノードの種類が処理命令 (Processing Instruction) であるかを確認します。
31        // Dom\ProcessingInstruction の場合、nodeTypeプロパティは定数 XML_PI_NODE (値は 7) を返します。
32        if ($node->nodeType === XML_PI_NODE) {
33            // ProcessingInstruction ノードが見つかった場合
34            echo 'ノード名: ' . $node->nodeName . PHP_EOL;
35            echo 'ノードタイプ (nodeType): ' . $node->nodeType . PHP_EOL;
36            echo '定数 XML_PI_NODE の値: ' . XML_PI_NODE . PHP_EOL;
37
38            // instanceof を使って型を検証することもできます
39            if ($node instanceof Dom\ProcessingInstruction) {
40                echo 'このノードは Dom\ProcessingInstruction のインスタンスです。' . PHP_EOL;
41            }
42            break; // 最初の処理命令ノードを見つけたらループを終了
43        }
44    }
45}
46
47// 関数を実行して結果を表示
48demonstrateProcessingInstructionNodeType();

PHPのDom\ProcessingInstructionクラスに属するnodeTypeプロパティは、XML文書内のノードの種類を識別するための整数値を返します。このプロパティに引数はありません。Dom\ProcessingInstructionオブジェクトの場合、nodeTypeは常にPHPの定義済み定数であるXML_PI_NODEと同じ値、具体的には整数の7を返します。

サンプルコードでは、まずDOMDocumentクラスを使って処理命令（<?xml-stylesheet ... ?>）を含むXML文字列を解析しています。次に、foreachループを使ってXML文書内の各ノードを順番に調べていきます。ループの中のif文では、$node->nodeTypeが返す値がXML_PI_NODEと等しいかどうかを判定しています。この条件式が真になるのは、現在のノードが処理命令である場合です。条件に一致したノードが見つかると、そのノード名とnodeTypeプロパティの値（7）を出力します。

このようにnodeTypeプロパティを利用することで、XML文書を構成する様々なノードの中から、特定の種類のノード、この例では処理命令ノードを正確に特定することができます。

nodeTypeプロパティは、XML文書内の各要素が何の種類（タグ、テキスト、コメントなど）であるかを示す数値です。処理命令の場合、この値は7になります。サンプルコードのように、7という数値を直接書くのではなく、PHPで定義済みの定数XML_PI_NODEを使って比較することが重要です。定数を使うことで、コードの意図が明確になり、間違いを減らせます。また、PHP 8からDOM関連クラスはDom名前空間に属するため、instanceof Dom\ProcessingInstructionのように記述する必要があります。古い情報では名前空間がない場合があるので注意してください。実際の開発では、loadXMLが失敗する場合に備えてエラー処理を追加すると、より安全なコードになります。

PHP DOM ProcessingInstruction の nodeType を取得する


1<?php
2
3declare(strict_types=1);
4
5/**
6 * DOMProcessingInstruction の nodeType プロパティの使用例を示します。
7 */
8function showProcessingInstructionNodeType(): void
9{
10    // 処理命令 (<?php-style ... ?>) を含むXML文字列を準備します。
11    $xmlString = <<<XML
12<?xml version="1.0" encoding="UTF-8"?>
13<?php-style-checker check="true"?>
14<document>
15  <p>This is a paragraph.</p>
16</document>
17XML;
18
19    // DOMDocument オブジェクトをインスタンス化します。
20    $doc = new \Dom\Document();
21
22    // XML文字列を読み込み、DOMツリーを構築します。
23    $doc->loadXML($xmlString);
24
25    // ドキュメント直下の子ノードを走査します。
26    foreach ($doc->childNodes as $node) {
27        // ノードが Dom\ProcessingInstruction のインスタンスであるかを確認します。
28        if ($node instanceof \Dom\ProcessingInstruction) {
29            echo '処理命令ノードが見つかりました。' . PHP_EOL;
30            echo 'ターゲット (nodeName): ' . $node->nodeName . PHP_EOL;
31            echo 'データ (nodeValue): ' . $node->nodeValue . PHP_EOL;
32
33            // nodeType プロパティはノードの種類を示す整数を返します。
34            // 処理命令ノード (ProcessingInstruction) の場合、nodeType は常に 7 です。
35            // この値は定数 XML_PI_NODE としても定義されています。
36            echo 'nodeType の値: ' . $node->nodeType . PHP_EOL;
37
38            if ($node->nodeType === XML_PI_NODE) {
39                echo 'nodeType は XML_PI_NODE (7) です。' . PHP_EOL;
40            }
41        }
42    }
43}
44
45// 関数を実行します。
46showProcessingInstructionNodeType();
47

Dom\ProcessingInstruction->nodeTypeは、DOMツリー内のノードの種類を識別するための整数を返す読み取り専用のプロパティです。引数はなく、戻り値はノードの種類を示す整数（int）です。Dom\ProcessingInstructionクラスのインスタンス、つまりXMLの処理命令（例: <?target data?>）の場合、このプロパティは常に7という値を返します。この7という数値は、PHPの定義済み定数であるXML_PI_NODEと等しく、コード内で直接7と書く代わりにこの定数を使うことで、より分かりやすいプログラムになります。

サンプルコードでは、まず処理命令を含むXML文字列をDom\Documentオブジェクトに読み込ませ、DOMツリーを構築します。次に、foreachループでドキュメント内の各ノードを順番に調べ、instanceof演算子を使ってノードがDom\ProcessingInstructionクラスのオブジェクトであるかを確認します。該当するノードが見つかった場合、そのnodeTypeプロパティにアクセスして値を出力します。実行結果から、処理命令ノードのnodeTypeが7であり、定数XML_PI_NODEと一致することが確認できます。

nodeTypeプロパティは、XML内のノードがどの種類かを示す整数を返します。処理命令ノード（Dom\ProcessingInstruction）の場合、この値は常に7です。サンプルコードのように、7という数値を直接コードに書くよりも、意味が明確な定数XML_PI_NODEを使って比較することが推奨されます。これにより、コードが読みやすくなり、間違いも減ります。ノードの種類を判定するには、このnodeTypeプロパティを使う方法の他に、instanceof演算子でクラスを直接調べる方法も有効です。また、PHP 8からDOM関連のクラスは\Dom名前空間に属している点にも注意してください。