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

nodeValueプロパティは、ノードの値を文字列として取得または設定するプロパティです。DOMNameSpaceNodeクラスに属し、名前空間ノードのテキストコンテンツを操作するために使用されます。具体的には、ノードが持つテキストデータを参照したり、新しいテキストデータで置き換えたりできます。

このプロパティを使用することで、XMLドキュメントやHTMLドキュメント内の要素や属性の値をプログラムから読み書きすることが可能になります。例えば、要素のテキスト内容を取得したり、属性の値を変更したりする際に利用できます。

取得時には、ノードが持つテキストコンテンツが文字列として返されます。設定時には、指定された文字列がノードの新しいテキストコンテンツとして設定されます。もしノードがテキストコンテンツを持たない場合、取得時には空文字列が返されます。

注意点として、nodeValueプロパティは、すべてのノードタイプで意味を持つわけではありません。例えば、要素ノードの場合、直接的なテキストコンテンツを持たないため、nodeValueは通常nullを返します。要素ノードのテキストコンテンツを操作する場合は、代わりにchildNodesプロパティやtextContentプロパティを使用する必要があります。テキストノードや属性ノードなど、テキストコンテンツを直接持つノードに対しては、nodeValueプロパティが有効に機能します。

システムエンジニアを目指す初心者の方は、XMLやHTMLドキュメントを扱う際に、このnodeValueプロパティがデータの読み書きにおいて重要な役割を果たすことを理解しておくと良いでしょう。

Copy
1<?php
2$dom = new DOMDocument();
3$element = $dom->createElementNS("http://www.example.com", "prefix:element", "some value");
4$namespace = $element->namespaceURI;
5$nodeName = $element->nodeName;
6
7$domNameSpaceNode = new DOMNameSpaceNode($namespace, $nodeName);
8echo $domNameSpaceNode->nodeValue;
9?>

string|null

DOMNameSpaceNode の nodeValue プロパティは、名前空間ノードの実際の値（URI）を文字列として返します。ノードに値がない場合は null を返します。