【PHP8.x】nodeTypeプロパティの使い方

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

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

基本的な使い方

nodeTypeプロパティは、DOM要素のノードタイプを表す読み取り専用のプロパティです。このプロパティは、DOMElementオブジェクトがどの種類のノードであるかを識別するために使用されます。ノードタイプは整数値で表され、XML_ELEMENT_NODE、XML_ATTRIBUTE_NODE、XML_TEXT_NODEなど、定義済みの定数に対応します。

システムエンジニアを目指す初心者の方にとって、nodeTypeプロパティは、DOMツリーを操作する際に非常に役立ちます。例えば、特定の種類の要素のみを処理したい場合、nodeTypeプロパティをチェックすることで、処理対象を絞り込むことができます。具体的には、DOMElementオブジェクトのnodeTypeプロパティの値を取得し、XML_ELEMENT_NODE定数と比較することで、そのノードが要素ノードであるかどうかを判定できます。

このプロパティを使用することで、DOM構造を解析し、要素の種類に基づいて異なる処理を行うことが可能になります。nodeTypeプロパティは、DOMドキュメントの構造を理解し、効率的に操作するための重要なツールの一つです。DOM操作を行う際には、このプロパティを積極的に活用することで、より柔軟で正確な処理を実装できます。

構文(syntax)


1Dom\Element::$nodeType

引数(parameters)

引数なし

引数はありません

戻り値(return)

int

このプロパティは、ノードの種類を示す整数値を返します。例えば、要素ノードの場合は1、属性ノードの場合は2といった値が返されます。

サンプルコード

PHP DOMのnodeTypeを取得する


1<?php
2
3// Dom\Element クラスの nodeType プロパティのサンプルコード
4
5// ドキュメントを作成
6$dom = new DOMDocument();
7
8// ルート要素を作成
9$root = $dom->createElement('root');
10$dom->appendChild($root);
11
12// 子要素を作成
13$child = $dom->createElement('child');
14$root->appendChild($child);
15
16// テキストノードを作成
17$text = $dom->createTextNode('Hello, World!');
18$child->appendChild($text);
19
20// 要素の nodeType を取得
21$elementNodeType = $child->nodeType;
22
23// テキストノードの nodeType を取得
24$textNodeType = $text->nodeType;
25
26// 結果を出力
27echo "Element nodeType: " . $elementNodeType . PHP_EOL; // ELEMENT_NODE (1)
28echo "Text nodeType: " . $textNodeType . PHP_EOL; // TEXT_NODE (3)
29
30// nodeType 定数の例
31echo "Node Element Constant: " . XML_ELEMENT_NODE . PHP_EOL;
32echo "Node Text Constant: " . XML_TEXT_NODE . PHP_EOL;
33?>

このサンプルコードは、PHPのDOM拡張を用いて、Dom\ElementクラスのnodeTypeプロパティの利用方法を示しています。nodeTypeプロパティは、要素のノードタイプを整数値で取得するために使用します。

まず、DOMDocumentクラスのインスタンスを作成し、createElement()メソッドでルート要素と子要素を作成します。次に、createTextNode()メソッドでテキストノードを作成し、要素にそれぞれ追加します。

$child->nodeTypeと$text->nodeTypeによって、それぞれ要素ノードとテキストノードのnodeTypeプロパティの値を取得しています。取得した値は整数で、要素ノードの場合は1（XML_ELEMENT_NODE）、テキストノードの場合は3（XML_TEXT_NODE）となります。

サンプルコードでは、取得したnodeTypeの値をecho文で出力しています。また、XML_ELEMENT_NODEやXML_TEXT_NODEといった、ノードタイプに対応する定数の値も出力しています。これらの定数は、nodeTypeプロパティから返される整数値を比較する際に利用できます。

nodeTypeプロパティは引数を持ちません。戻り値は整数で、ノードの種類を表します。このプロパティを使用することで、DOMツリー内のノードの種類を判別し、処理を分岐させることができます。

nodeTypeはノードの種類を表す整数値を取得するプロパティです。DOMElementなどのノードの種類を判別する際に使用します。取得できる値は、定義済みの定数（XML_ELEMENT_NODEなど）と比較して利用します。数値そのもの（1, 3など）を直接比較するよりも、定数を使う方が可読性が高く推奨されます。nodeTypeは読み取り専用で、値を変更することはできません。異なる種類のノード（属性ノード、コメントノードなど）も存在するため、nodeTypeの値を確認することで処理を分岐できます。PHP_EOLは改行コードを意味し、環境に合わせて自動で改行されます。

PHP DOM Element の nodeType を取得する


1<?php
2
3// Dom\Element の nodeType プロパティのサンプルコード
4
5// HTML ドキュメントを作成
6$dom = new DOMDocument();
7$dom->loadHTML('<!DOCTYPE html><html><body><p id="test">Hello, World!</p></body></html>');
8
9// ID を指定して要素を取得
10$element = $dom->getElementById('test');
11
12// nodeType プロパティの値を出力
13// ELEMENT_NODE は 1 を表す
14echo "Node type: " . $element->nodeType . PHP_EOL;
15
16// nodeName プロパティの値を出力
17// 要素名を出力する
18echo "Node name: " . $element->nodeName . PHP_EOL;
19
20// nodeValue プロパティの値を出力
21// 要素の値を表す。この場合はNULL
22echo "Node value: " . $element->nodeValue . PHP_EOL;
23?>

このサンプルコードは、PHPのDOM拡張機能を使って、HTMLドキュメント内の要素のnodeTypeプロパティを取得する方法を示しています。nodeTypeプロパティは、DOM要素のノードタイプを表す整数値を返します。

まず、DOMDocumentクラスのインスタンスを作成し、loadHTML()メソッドを使ってHTMLドキュメントを読み込みます。次に、getElementById()メソッドで、IDがtestの要素を取得し、$element変数に格納します。

$element->nodeTypeで要素のノードタイプを取得し、echo文でその値を出力します。この例では、<p>要素のノードタイプはELEMENT_NODEであり、これは整数値の1に対応します。DOMには様々なノードタイプが存在し、要素、属性、テキストなど、それぞれ異なる整数値が割り当てられています。nodeNameプロパティは要素の名前（この場合は"p"）を、nodeValueプロパティは要素の値を返します。要素の値が存在しない場合はNULLを返します。

nodeTypeプロパティを使用することで、DOMツリー内の要素の種類を識別し、それに応じて処理を分岐させることができます。例えば、特定の種類の要素のみに特定の処理を適用したい場合に役立ちます。

nodeTypeは要素の種類を表す整数値です。ELEMENT_NODEは要素ノードであることを示し、値は1です。HTMLのタグ（<p>など）に対応します。nodeNameは要素の名前（タグ名）を文字列で返します。nodeValueは要素の内容を表しますが、要素ノードの場合は基本的にNULLになることに注意が必要です。要素内のテキストを取得したい場合は、textContentプロパティを使用します。nodeTypeの値は、DOMDocumentクラスの定数として定義されており、例えばDOMDocument::ELEMENT_NODEのように参照することもできます。これらの定数を利用することで、コードの可読性を向上させることができます。