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

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

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

基本的な使い方

『nodeValueプロパティは、Dom\Documentオブジェクトが表すドキュメントノード自体の値を保持するプロパティです。しかし、ドキュメントノードはDOMツリー全体のコンテナとしての役割を持ち、特定のテキスト値を持たないという特性があります。そのため、Dom\DocumentオブジェクトのnodeValueプロパティにアクセスした場合、その値は常にnullとなります。このプロパティは、ノードの種類によってその意味が異なり、例えばテキストノードやコメントノードではその内容の文字列を返しますが、ドキュメントノードや要素ノードではnullを返す仕様です。このプロパティに対して値を設定しようとしても、ドキュメントノードには適用されず、その操作は無視されます。したがって、Dom\Documentオブジェクトにおいてこのプロパティを直接利用する場面はほとんどありません。ドキュメントに含まれる全てのテキスト内容を連結して取得したい場合は、textContentプロパティのような別の手段を用いる必要があります。』

構文(syntax)


1<?php
2
3$document = new Dom\Document();
4
5$value = $document->nodeValue;
6
7var_dump($value);
8
9?>

引数(parameters)

引数なし

引数はありません

戻り値(return)

string|null

Dom\Document::nodeValue プロパティは、ノードのテキストコンテンツを表す文字列、またはノードにテキストコンテンツがない場合は null を返します。

サンプルコード

PHP nodeValue でHTML要素の値を取得する


1<?php
2
3// HTML ドキュメントをロードします。
4$html = <<<HTML
5<!DOCTYPE html>
6<html>
7<head>
8  <title>Example</title>
9</head>
10<body>
11  <h1>Hello, World!</h1>
12  <p>This is a paragraph.</p>
13</body>
14</html>
15HTML;
16
17$dom = new DOMDocument();
18$dom->loadHTML($html);
19
20// h1 要素を取得します。
21$h1 = $dom->getElementsByTagName('h1')->item(0);
22
23// h1 要素の nodeValue を取得します。
24if ($h1) {
25  $nodeValue = $h1->nodeValue;
26
27  // nodeValue を表示します。
28  echo "h1 nodeValue: " . $nodeValue . PHP_EOL; // 出力: h1 nodeValue: Hello, World!
29}
30
31// p 要素を取得します。
32$p = $dom->getElementsByTagName('p')->item(0);
33
34// p 要素の nodeValue を取得します。
35if ($p) {
36  $nodeValue = $p->nodeValue;
37
38  // nodeValue を表示します。
39  echo "p nodeValue: " . $nodeValue . PHP_EOL; // 出力: p nodeValue: This is a paragraph.
40}
41?>

このサンプルコードは、PHPのDOMDocumentクラスを使用してHTMLドキュメントを解析し、特定の要素のテキストコンテンツ（nodeValue）を取得する方法を示します。

まず、DOMDocumentクラスのインスタンスを作成し、loadHTML()メソッドでHTML文字列を読み込みます。次に、getElementsByTagName()メソッドを使って、取得したい要素（ここではh1要素とp要素）を指定します。item(0)で最初に見つかった要素を取得します。

取得した要素に対して、nodeValueプロパティにアクセスすることで、その要素に含まれるテキストコンテンツを取得できます。nodeValueは、要素内のテキストノードの値を示す文字列を返します。もし要素が存在しない場合は、nullが返される可能性があります。サンプルコードでは、if ($h1)のように要素の存在を確認してからnodeValueを取得することで、エラーを回避しています。

取得したnodeValueは、echo文で表示しています。PHP_EOLは改行コードを表し、出力結果を見やすくするために使用しています。このコードを実行すると、h1要素とp要素のテキストコンテンツがそれぞれ表示されます。

nodeValueプロパティは、HTMLドキュメントからテキスト情報を抽出する際に非常に便利です。例えば、WebスクレイピングやHTMLデータの解析など、さまざまな場面で活用できます。

nodeValueは、要素ノードが持つテキストコンテンツを取得する際に使用します。HTMLタグ自体は含まれません。getElementsByTagNameはDOMNodeListを返すため、item(0)で最初の要素を取得する必要があります。もし要素が見つからない場合（item(0)がnullを返す場合）は、nodeValueにアクセスする前にif文でnullチェックを行うことが重要です。nodeValueの戻り値は文字列またはnullであるため、型を意識して扱いましょう。loadHTMLメソッドを使用する際は、文字コードの問題に注意し、必要に応じてエンコーディングを指定してください。HTML構造が複雑な場合、XPathを使用するとより柔軟に要素を特定できます。