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

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

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

基本的な使い方

nodeTypeプロパティは、DOMツリーを構成する各ノードのタイプを識別するための整数値を保持するプロパティです。

このプロパティは、PHPのDOM拡張機能におけるDom\HTMLElementクラスを含む、Dom\Nodeを継承するすべてのオブジェクトで利用可能です。保持される整数値は、ノードの種類に応じてPHPの組み込み定数に対応しています。例えば、HTML要素（<p>, <div>など）を表すノードはDOM_ELEMENT_NODE（値1）を、テキストコンテンツはDOM_TEXT_NODE（値3）を、コメントはDOM_COMMENT_NODE（値8）を保持します。

これらの定数を利用することで、コードの可読性が向上し、ノードのタイプを明確に判別できます。nodeTypeプロパティは、DOMツリーを走査し、特定の種類のノードに限定して処理を実行したい場合や、ノードのタイプによって処理を分岐させたい場合に特に有効です。これにより、HTMLやXMLドキュメントの解析において、目的に応じた柔軟な操作が可能になります。

構文(syntax)


1<?php
2
3$document = new Dom\Document();
4$htmlElement = $document->createElement('div');
5$nodeType = $htmlElement->nodeType;

引数(parameters)

引数なし

引数はありません

戻り値(return)

int

このプロパティは、ノードの種類を表す整数値を返します。例えば、要素ノードの場合は1、テキストノードの場合は3となります。

サンプルコード

PHP DOM nodeTypeで要素の種類を判定する


1<?php
2
3/**
4 * HTMLドキュメントから特定の要素を取得し、そのノードタイプ (nodeType) を表示する関数。
5 * システムエンジニアを目指す初心者が、DOM要素の基本的な構造を理解するのに役立つサンプルです。
6 *
7 * Dom\HTMLElement::nodeType プロパティは、そのノードが何であるか（要素、テキスト、コメントなど）
8 * を示す整数値を返します。
9 */
10function demonstrateDomNodeType(): void
11{
12    // Dom\Document クラスの新しいインスタンスを作成します。
13    // これはHTMLやXMLドキュメントをプログラムで操作するための基盤となります。
14    $dom = new Dom\Document();
15
16    // 解析するシンプルなHTML文字列を定義します。
17    $htmlContent = <<<HTML
18<!DOCTYPE html>
19<html>
20<head>
21    <title>nodeTypeサンプル</title>
22</head>
23<body>
24    <h1 id="main-title">こんにちは、PHP DOM！</h1>
25    <p>この段落はテキストノードを含んでいます。</p>
26    <!-- これはコメントです -->
27</body>
28</html>
29HTML;
30
31    // HTML文字列をDOMドキュメントにロードします。
32    // エラーが表示されるのを避けるため @ を使用していますが、
33    // 実運用ではエラーハンドリングを行うべきです。
34    @$dom->loadHTML($htmlContent);
35
36    // ドキュメント内の最初の <h1> 要素を取得します。
37    // getElementsByTagName() は Dom\HTMLCollection を返し、その中の最初の要素が欲しいので [0] を使います。
38    // 取得される要素は Dom\HTMLElement のインスタンス（またはその親クラス）となります。
39    $headingElement = $dom->getElementsByTagName('h1')[0] ?? null;
40
41    if ($headingElement instanceof Dom\HTMLElement) {
42        // Dom\HTMLElement の nodeType プロパティにアクセスします。
43        // これは、このノードが「要素ノード」であることを示す整数値を返します。
44        $nodeTypeForElement = $headingElement->nodeType;
45
46        echo "--- <h1>要素のノードタイプ ---" . PHP_EOL;
47        echo "ノードタイプ値: " . $nodeTypeForElement . PHP_EOL;
48
49        // nodeType の値が何を表すかを説明します。
50        // Dom\Node::ELEMENT は、HTML要素（例: <h1>, <p>, <div>）を示す定数です。
51        if ($nodeTypeForElement === Dom\Node::ELEMENT) {
52            echo "この値は Dom\\Node::ELEMENT (" . Dom\Node::ELEMENT . ") と一致し、" . PHP_EOL;
53            echo "このノードがHTMLの要素（タグ）であることを示します。" . PHP_EOL;
54        } else {
55            echo "このノードタイプは Dom\\Node::ELEMENT ではありません。" . PHP_EOL;
56        }
57
58        // 補足として、テキストノードの例も示します。
59        // <h1>要素の最初の子ノードは通常、その内部のテキストコンテンツです。
60        $textNodeInsideHeading = $headingElement->firstChild;
61        if ($textNodeInsideHeading instanceof Dom\Text) {
62            $nodeTypeForText = $textNodeInsideHeading->nodeType;
63            echo PHP_EOL . "--- <h1>要素内のテキストノードのノードタイプ ---" . PHP_EOL;
64            echo "ノードタイプ値: " . $nodeTypeForText . PHP_EOL;
65
66            // Dom\Node::TEXT は、要素内のテキストコンテンツを示す定数です。
67            if ($nodeTypeForText === Dom\Node::TEXT) {
68                echo "この値は Dom\\Node::TEXT (" . Dom\Node::TEXT . ") と一致し、" . PHP_EOL;
69                echo "このノードがテキストコンテンツであることを示します。" . PHP_EOL;
70                echo "テキスト内容: '" . $textNodeInsideHeading->textContent . "'" . PHP_EOL;
71            }
72        }
73    } else {
74        echo "<h1>要素が見つからないか、期待されるDom\\HTMLElementのインスタンスではありませんでした。" . PHP_EOL;
75    }
76}
77
78// 上記の関数を実行して、DOMのnodeTypeプロパティの動作を確認します。
79demonstrateDomNodeType();

このサンプルコードは、PHPのDOM拡張機能を利用してHTMLドキュメントから特定の要素を取得し、そのノードタイプ（nodeType）を表示する方法を説明しています。Dom\HTMLElement::nodeTypeプロパティは、そのノードがどのような種類であるかを示す整数値を返します。このプロパティは引数を取らず、ノードの種類を示すint型の数値を返します。

コードではまず、用意したHTML文字列をDom\Documentオブジェクトにロードし、操作可能な形式にします。次に、getElementsByTagName('h1')メソッドを使ってドキュメント内の最初の<h1>要素を取得し、そのDom\HTMLElementインスタンスのnodeTypeプロパティにアクセスしています。取得されたノードタイプ値は、Dom\Node::ELEMENT定数と比較され、このノードがHTMLの要素（タグ）であることを具体的に示しています。Dom\Node::ELEMENTは要素ノードを表す数値です。

さらに、<h1>要素の最初の子ノード、つまり内部のテキストコンテンツのnodeTypeも取得し、Dom\Node::TEXT定数と比較して、それがテキストノードであることを確認しています。Dom\Node::TEXTはテキストノードを表します。これにより、要素とテキストが異なる種類のノードとして扱われることが理解できます。このサンプルは、システムエンジニアを目指す初心者がDOMの基本的な構造と、ノードの種類を識別する方法を学ぶ上で役立ちます。

このサンプルコードでは、nodeTypeプロパティをDom\Nodeクラスの定数と比較して使用している点が重要です。これにより、数値の意味が明確になり、可読性が向上します。しかし、loadHTML関数のエラー抑制に@演算子を使用していますが、実運用ではこの記述を避け、例外処理やlibxml_use_internal_errorsなどを用いた堅牢なエラーハンドリングを実装してください。また、getElementsByTagNameなどで要素を取得する際は、対象の要素が存在しない可能性を常に考慮し、取得結果がnullでないか、または期待するDom\HTMLElementのインスタンスであるかをif文で確認する習慣を身につけることが、予期せぬエラーを防ぐために不可欠です。

PHP DOM nodeTypeプロパティでノード種別を取得する


1<?php
2
3use Dom\Document;
4use Dom\HTMLElement;
5
6/**
7 * Dom\HTMLElement の nodeType プロパティの使用例を示します。
8 * nodeType は、HTML/XML DOMノードの種類を示す整数値を返します。
9 * 例えば、要素ノード（例: <div>, <p>）の場合、XML_ELEMENT_NODE (値は 1) を返します。
10 */
11function demonstrateNodeTypeProperty(): void
12{
13    // 1. 新しい Dom\Document オブジェクトを作成します。
14    // これは、HTMLドキュメント全体のルートを表すオブジェクトです。
15    $document = new Document();
16
17    // 2. ドキュメント内に 'div' という名前の新しいHTML要素 (Dom\HTMLElement) を作成します。
18    // createElement メソッドは、指定されたタグ名を持つ要素オブジェクトを返します。
19    $divElement = $document->createElement('div');
20
21    // 3. 作成した要素にテキストコンテンツを設定します。
22    $divElement->textContent = 'これはサンプル要素です。';
23
24    // 4. 作成した要素をドキュメントのルートに子として追加します。
25    // この操作により、要素がドキュメントツリーの一部となります。
26    $document->appendChild($divElement);
27
28    // 5. Dom\HTMLElement オブジェクトの nodeType プロパティにアクセスし、値を取得します。
29    // このプロパティは、ノードの種類を数値で示します。
30    $nodeType = $divElement->nodeType;
31
32    // 6. 取得したノードタイプと、そのノードが要素ノードであるかどうかの情報を表示します。
33    echo "作成した要素の nodeType: " . $nodeType . "\n";
34
35    // 7. DOM の組み込み定数 (XML_ELEMENT_NODE) と比較して、ノードの種類をより具体的に説明します。
36    // XML_ELEMENT_NODE は、要素ノードを示す定数で、その値は 1 です。
37    if ($nodeType === XML_ELEMENT_NODE) {
38        echo "このノードは要素ノードです (XML_ELEMENT_NODE の値: " . XML_ELEMENT_NODE . ").\n";
39    } else {
40        echo "このノードは要素ノードではありません。\n";
41    }
42}
43
44// 上記のサンプル関数を実行し、nodeType の動作を確認します。
45demonstrateNodeTypeProperty();

PHPのDom\HTMLElementクラスが提供するnodeTypeプロパティは、HTMLやXMLドキュメント内のDOMノードの種類を識別するためのものです。このプロパティは引数を持たず、ノードの種類を示す整数値（int）を返します。DOM（Document Object Model）では、HTMLのタグやテキスト、コメントなど、ドキュメントを構成するすべての部分が「ノード」として扱われます。nodeTypeプロパティは、そのノードが要素（タグ）なのか、テキストコンテンツなのか、あるいはコメントなのかといった種類を数値で教えてくれます。

サンプルコードでは、まず新しいDom\Documentオブジェクトを作成し、次にdiv要素としてDom\HTMLElementのインスタンスを生成しています。その後、このdiv要素のnodeTypeプロパティにアクセスし、その値を取得・表示しています。HTMLの<div>のようなタグは「要素ノード」と呼ばれ、そのnodeTypeはXML_ELEMENT_NODEという定数と同じ値（通常は1）を返します。コードでは、取得した値がこの定数と一致するかを比較することで、作成したノードが要素ノードであることを確認しています。このように、nodeTypeプロパティを使用することで、プログラムはDOMツリーを走査しながら、特定の種類のノードを正確に判別し、それに応じた柔軟な処理を行うことが可能になります。

nodeTypeプロパティは、HTMLやXMLのDOMノードがどのような種類であるかを数値で示す読み取り専用のプロパティです。サンプルコードでは要素ノード（例: <div>タグ）のタイプを取得しており、この場合、値はXML_ELEMENT_NODEというPHPが提供する定数（値は1）と一致します。この数値を直接比較するよりも、XML_ELEMENT_NODEのような定数を利用することで、コードの意図が明確になり、可読性が向上します。また、このプロパティはDom\HTMLElementだけでなく、テキストノードやコメントノードなど、様々な種類のDOMノードオブジェクトに存在し、それぞれ異なるノードタイプに応じた数値を返しますので、条件分岐などでノードの種類を判別する際に非常に役立ちます。ノードタイプは作成後に変更することはできません。