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

Copy
1<?php
2
3// DOMDocumentを新規作成
4$dom = new DOMDocument('1.0', 'UTF-8');
5
6// ルート要素を作成
7$root = $dom->createElement('root');
8$dom->appendChild($root);
9
10// 子要素を作成
11$child = $dom->createElement('child');
12$root->appendChild($child);
13
14// テキストノードを作成
15$text = $dom->createTextNode('Hello, world!');
16$child->appendChild($text);
17
18// 各ノードのnodeTypeを表示
19echo "Document nodeType: " . $dom->nodeType . "\n"; // 9 (DOCUMENT_NODE)
20echo "Root element nodeType: " . $root->nodeType . "\n"; // 1 (ELEMENT_NODE)
21echo "Child element nodeType: " . $child->nodeType . "\n"; // 1 (ELEMENT_NODE)
22echo "Text node nodeType: " . $text->nodeType . "\n"; // 3 (TEXT_NODE)
23
24// nodeTypeを名前で表示するヘルパー関数
25function getNodeTypeName(int $nodeType): string {
26    switch ($nodeType) {
27        case XML_ELEMENT_NODE:
28            return 'XML_ELEMENT_NODE';
29        case XML_ATTRIBUTE_NODE:
30            return 'XML_ATTRIBUTE_NODE';
31        case XML_TEXT_NODE:
32            return 'XML_TEXT_NODE';
33        case XML_CDATA_SECTION_NODE:
34            return 'XML_CDATA_SECTION_NODE';
35        case XML_ENTITY_REF_NODE:
36            return 'XML_ENTITY_REF_NODE';
37        case XML_ENTITY_NODE:
38            return 'XML_ENTITY_NODE';
39        case XML_PI_NODE:
40            return 'XML_PI_NODE';
41        case XML_COMMENT_NODE:
42            return 'XML_COMMENT_NODE';
43        case XML_DOCUMENT_NODE:
44            return 'XML_DOCUMENT_NODE';
45        case XML_DOCUMENT_TYPE_NODE:
46            return 'XML_DOCUMENT_TYPE_NODE';
47        case XML_DOCUMENT_FRAGMENT_NODE:
48            return 'XML_DOCUMENT_FRAGMENT_NODE';
49        case XML_NOTATION_NODE:
50            return 'XML_NOTATION_NODE';
51        default:
52            return 'Unknown Node Type';
53    }
54}
55
56echo "Document nodeType name: " . getNodeTypeName($dom->nodeType) . "\n";
57echo "Root element nodeType name: " . getNodeTypeName($root->nodeType) . "\n";
58echo "Child element nodeType name: " . getNodeTypeName($child->nodeType) . "\n";
59echo "Text node nodeType name: " . getNodeTypeName($text->nodeType) . "\n";
60?>

このPHPのサンプルコードは、DOMDocumentクラスのnodeTypeプロパティの利用方法を示しています。nodeTypeプロパティは、DOMノードの種類を表す整数値を返します。DOM（Document Object Model）は、XMLやHTMLドキュメントをプログラムから操作するためのインターフェースです。

まず、DOMDocumentクラスのインスタンスを作成し、XMLドキュメントのルート要素、子要素、テキストノードを生成して、ドキュメントに追加しています。

次に、各ノード（ドキュメント、ルート要素、子要素、テキストノード）のnodeTypeプロパティの値を出力しています。$dom->nodeTypeはドキュメントノードの種類を表し、$root->nodeType、$child->nodeTypeは要素ノードの種類を、$text->nodeType`はテキストノードの種類を表します。

nodeTypeプロパティの戻り値は整数ですが、それぞれの整数値はXMLドキュメント内のノードの種類に対応しています。例えば、DOCUMENT_NODEはドキュメントノード、ELEMENT_NODEは要素ノード、TEXT_NODEはテキストノードを表します。

サンプルコードでは、getNodeTypeNameというヘルパー関数を定義し、nodeTypeの整数値を対応するノードの種類の文字列に変換して表示しています。これにより、nodeTypeの値が具体的にどのノードの種類を表しているのかをより分かりやすく確認できます。

この例を通じて、nodeTypeプロパティを利用することで、DOMツリー内の各ノードがどのような種類のノードであるかをプログラムから判別できることが理解できます。これは、XMLやHTMLドキュメントの構造を解析し、特定の種類のノードに対して処理を行う場合に役立ちます。

Copy
1<?php
2
3// DOMDocument を作成
4$dom = new DOMDocument();
5
6// XML 文字列をロード
7$xmlString = '<root><element attribute="value">text</element></root>';
8$dom->loadXML($xmlString);
9
10// ルート要素を取得
11$root = $dom->documentElement;
12
13// ルート要素のノードタイプを表示
14echo "ルート要素のノードタイプ: " . $root->nodeType . PHP_EOL;
15
16// 子ノードを取得
17$element = $root->firstChild;
18
19// 子ノードのノードタイプを表示
20echo "子要素のノードタイプ: " . $element->nodeType . PHP_EOL;
21
22// テキストノードのノードタイプを表示
23$text = $element->firstChild;
24echo "テキストノードのノードタイプ: " . $text->nodeType . PHP_EOL;
25
26// 属性ノードを取得
27$attribute = $element->attributes->getNamedItem("attribute");
28
29// 属性ノードが存在する場合、ノードタイプを表示
30if ($attribute) {
31    echo "属性ノードのノードタイプ: " . $attribute->nodeType . PHP_EOL;
32}
33
34// ノードタイプの定数
35echo "ELEMENT_NODE: " . XML_ELEMENT_NODE . PHP_EOL;
36echo "ATTRIBUTE_NODE: " . XML_ATTRIBUTE_NODE . PHP_EOL;
37echo "TEXT_NODE: " . XML_TEXT_NODE . PHP_EOL;
38echo "DOCUMENT_NODE: " . XML_DOCUMENT_NODE . PHP_EOL;
39?>

このサンプルコードは、PHPのDOMDocumentクラスを使ってXMLを操作し、nodeTypeプロパティでXMLノードの種類を調べる方法を示しています。

まず、DOMDocumentオブジェクトを作成し、XML文字列をロードします。次に、documentElementプロパティでXMLドキュメントのルート要素を取得します。

nodeTypeプロパティは、ノードの種類を整数値で返します。例えば、要素ノードであれば XML_ELEMENT_NODE、属性ノードであれば XML_ATTRIBUTE_NODE、テキストノードであれば XML_TEXT_NODE のような定数が返されます。

サンプルコードでは、ルート要素、その子要素、テキストノード、属性ノードそれぞれのnodeTypeプロパティの値を表示しています。firstChildプロパティで最初の子ノードを取得したり、attributes->getNamedItem()メソッドで指定した名前の属性ノードを取得したりしています。

最後に、主要なノードタイプに対応する定数の値を表示しています。これらの定数と比較することで、nodeTypeプロパティが返す値がどのノードの種類を表しているかを判断できます。

nodeTypeプロパティは、XMLドキュメントを扱う上で、ノードの種類を判別し、適切な処理を行うために重要な役割を果たします。戻り値は整数値であり、引数は必要ありません。