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

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

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

基本的な使い方

nodeNameプロパティは、Dom\Text クラスのノードの名前を保持するプロパティです。Dom\Text クラスは、DOM (Document Object Model) におけるテキストノードを表現します。テキストノードは、XMLやHTMLドキュメント内のテキストコンテンツを表すもので、要素や属性とは異なり、文字データそのものを保持します。

nodeName プロパティには、テキストノードの場合、常に #text という文字列が格納されています。これは、テキストノードが特定の要素名や属性名を持たず、テキストコンテンツのみを表すことに由来します。このプロパティを参照することで、対象のノードがテキストノードであることを確認できます。

システムエンジニアを目指す上で、DOMの構造を理解し、各ノードの種類とその役割を把握することは重要です。nodeName プロパティは、ノードの種類を識別するための基本的な手段の一つであり、DOMを操作する際に頻繁に利用されます。例えば、DOMをトラバース (走査) しながら特定の種類のノードを処理する際に、nodeName プロパティを参照してテキストノードかどうかを判別することができます。

PHPでDOMを扱う場合、DOMDocument クラスや DOMElement クラスなど、様々なクラスが登場しますが、Dom\Text クラスとその nodeName プロパティも、テキストコンテンツを操作する上で欠かせない要素となります。テキストノードの操作は、Webページの動的な生成やデータ処理において重要な役割を果たすため、しっかりと理解しておくことが望ましいです。

構文(syntax)


1Dom\Text::$nodeName;

引数(parameters)

引数なし

引数はありません

戻り値(return)

#text

Dom\TextクラスのnodeNameプロパティは、このノードがテキストノードであることを示す文字列 #text を返します。

サンプルコード

PHP DOMText nodeName を取得する


1<?php
2
3// DomDocument を作成
4$dom = new DOMDocument();
5
6// テキストノードを持つ要素を作成
7$element = $dom->createElement('example');
8$textNode = $dom->createTextNode('This is a text node.');
9$element->appendChild($textNode);
10$dom->appendChild($element);
11
12// テキストノードの nodeName プロパティを取得
13$nodeName = $textNode->nodeName;
14
15// 結果を出力
16echo "Node Name: " . $nodeName . PHP_EOL; // Node Name: #text
17
18?>

このサンプルコードは、PHPのDOM拡張機能を使って、DOMTextオブジェクトのnodeNameプロパティの値を取得する方法を示しています。DOMTextは、XMLドキュメントやHTMLドキュメント内のテキストを表すノードです。

まず、DOMDocumentオブジェクトを作成し、createElement()メソッドで 'example' という名前の要素を作成します。次に、createTextNode()メソッドを使ってテキストノードを作成し、要素に追加します。最後に、DOMDocumentに要素を追加することで、ドキュメント構造を構築します。

nodeNameプロパティは、ノードの名前を表す読み取り専用のプロパティです。DOMTextオブジェクトの場合、nodeNameプロパティの値は常に #text となります。サンプルコードでは、$textNode->nodeName でテキストノードのnodeNameプロパティにアクセスし、その値を $nodeName 変数に格納しています。

最後に、echo文を使ってnodeNameの値を出力します。実行結果からわかるように、DOMTextオブジェクトのnodeNameプロパティは常に #text を返します。このサンプルコードは、DOMDocumentを操作する上で、テキストノードの基本的な性質を理解するのに役立ちます。システムエンジニアを目指す上で、XMLやHTMLをプログラムで扱うための基礎知識として、DOMDocumentの理解は重要です。

Dom\TextクラスのnodeNameプロパティは、テキストノードの名前を #text という文字列で返します。要素ノードの名前（例えば、example）とは異なる点に注意してください。テキストノード自体が持つ名前であり、変更することはできません。このプロパティは主にノードの種類を識別するために使用されます。ノードの種類によって処理を切り替えたい場合に役立ちます。nodeNameの値は常に #text なので、具体的なテキストの内容を取得したい場合は、nodeValueプロパティを使用する必要があります。