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

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

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

基本的な使い方

nodeNameプロパティは、PHPのDOM拡張機能において、XMLやHTMLドキュメントの構造を操作する際に用いられるDOMTextクラスのインスタンスが表すノードの名前を保持するプロパティです。

DOMTextクラスは、ウェブページやXMLファイル内のテキストコンテンツ、つまり要素の間に存在する文字データや属性の値など、純粋な文字列部分を表現するために使用されます。このnodeNameプロパティは、DOM（Document Object Model）ツリー内の各ノードがどのような種類のノードであるかを識別するための名前を提供します。

特にDOMTextオブジェクトの場合、このnodeNameプロパティは常に固定の文字列である#textを返します。これは、このノードがテキストデータであることを明確に示すための共通の規則です。例えば、<div>Hello</div>というHTMLの例では、Helloという文字列の部分がDOMTextノードとして扱われ、そのnodeNameは#textとなります。これに対して、div要素のような実際のタグを表すDOMElementオブジェクトのnodeNameは、そのタグ名（この場合はdiv）を返します。

このプロパティは読み取り専用であり、値を変更することはできません。主に、処理中のノードがテキストノードであるかどうかを判別したり、ノードの種類に基づいて異なる処理を適用したりする際に利用されます。ノードが実際に保持するテキストの内容を取得したい場合は、nodeNameではなくnodeValueプロパティを使用することに注意が必要です。nodeNameはノードの「型」を示す識別子として機能し、nodeValueはノードの「内容」を保持します。

構文(syntax)


1<?php
2$dom = new DOMDocument();
3$textNode = $dom->createTextNode('Example Text');
4
5// DOMTextオブジェクトのnodeNameプロパティにアクセス
6echo $textNode->nodeName;
7?>

引数(parameters)

引数なし

引数はありません

戻り値(return)

string

DOMText オブジェクトのノード名を返します。DOMText の場合、この値は常に #text となります。

サンプルコード

PHP DOMText nodeName プロパティを取得する


1<?php
2
3// DOMText ノードの nodeName プロパティの例
4$dom = new DOMDocument();
5$dom->loadHTML('<!DOCTYPE html><html><body><div>Hello, world!</div></body></html>');
6
7// テキストノードを取得
8$textNode = $dom->createTextNode("Sample Text");
9
10// div要素を取得
11$div = $dom->getElementsByTagName('div')->item(0);
12
13// div要素にテキストノードを追加
14$div->appendChild($textNode);
15
16// テキストノードの nodeName プロパティを表示
17echo "Node Name: " . $textNode->nodeName . PHP_EOL; // Output: #text

PHPのDOMTextクラスにおけるnodeNameプロパティは、ノードの名前を取得するために使用されます。このプロパティは読み取り専用で、値を設定することはできません。

上記のサンプルコードでは、まずDOMDocumentクラスのインスタンスを作成し、HTMLドキュメントをロードしています。次に、createTextNodeメソッドを使用して、"Sample Text"というテキストノードを作成しています。getElementsByTagNameメソッドでdiv要素を取得し、appendChildメソッドを使って、作成したテキストノードをdiv要素の子要素として追加しています。

そして、$textNode->nodeNameによってテキストノードの名前を取得し、echo文で出力しています。テキストノードのnodeNameプロパティは、常に#textという文字列を返します。これは、テキストノードが特定の要素名を持たないためです。

nodeNameプロパティは引数を必要としません。戻り値は文字列型で、ノードの名前を表します。DOMTextノードの場合、常に#textが返されることを覚えておくと良いでしょう。DOMDocumentを操作する際、ノードの種類を識別し、適切な処理を行うために、このプロパティが役立ちます。例えば、要素ノードとテキストノードで処理を分けたい場合などに利用できます。

DOMText クラスの nodeName プロパティは、ノードの名前を表す文字列を返します。テキストノードの場合、常に "#text" が返される点に注意が必要です。要素名を取得したい場合は、DOMElement クラスの nodeName プロパティを使用してください。このサンプルコードでは、createTextNode で作成したテキストノードの nodeName を確認しています。nodeName は読み取り専用のプロパティであり、値を変更することはできません。DOMDocument の扱いには注意し、HTML構造が正しいことを確認してから操作するように心がけてください。