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

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

作成日: 更新日:

基本的な使い方

nodeValueプロパティは、DOMツリー内の各ノードが保持するテキストコンテンツを保持するプロパティです。このプロパティは、ノードの種類によって取得できる値が異なります。

特にDOMDocumentクラスのインスタンス、つまりドキュメント全体を表すノードに対してnodeValueプロパティを参照した場合、通常はnullを保持します。これは、DOMDocumentオブジェクト自体が、直接的なテキストデータを持つノードではないためです。DOMDocumentはHTMLやXMLドキュメント全体の構造を管理する役割を持ち、その内部に要素やテキストといった具体的な内容を含んでいます。

このプロパティは、主にテキストノード、コメントノード、CDATAセクションノードといった、実際に文字情報を保持するノードで具体的な値を示します。これらのノードでは、nodeValueプロパティを通じてノードが持つテキストの内容を取得したり、新しいテキストに更新したりすることができます。

システムエンジニアを目指す方にとって、nodeValueプロパティがノードの種類によって振る舞いが異なることを理解することは、DOM操作を正確に行う上で非常に重要です。

構文(syntax)

1<?php
2$dom = new DOMDocument();
3echo $dom->nodeValue;
4?>

引数(parameters)

戻り値(return)

?string

DOMDocument オブジェクトが表すノードのテキストコンテンツを文字列として返します。ノードがテキストコンテンツを持たない場合や、ノードがテキストコンテンツを持てない型の場合は null を返します。