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

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

作成日: 2025年09月11日更新日: 2025年10月31日

基本的な使い方

nodeValueプロパティは、DOMツリー内のノードが持つテキストコンテンツや属性値などの値を保持するプロパティです。

このプロパティは、PHPのDOM拡張機能におけるDOMDocumentFragmentクラスに属しています。DOMDocumentFragmentは、XMLやHTMLドキュメントのDOM（Document Object Model）ツリーに直接は追加されず、親ノードを持たない軽量な「コンテナ」として機能します。これは、複数のノード（例えば、動的に生成した複数のHTML要素やテキスト）を一時的にまとめて保持し、それらを一度に既存のドキュメントの特定の位置に挿入する際に非常に役立ちます。

しかし、DOMDocumentFragment自体は、テキストコンテンツを直接保持するノードタイプではありません。その役割は、あくまで複数の子ノードを格納する器であるため、自身が固有のテキスト値を持つことはありません。したがって、DOMDocumentFragmentのインスタンスに対してnodeValueプロパティにアクセスしても、常にnullが返されます。これは、このプロパティがそのノードに直接的なテキストデータが存在しないことを示しているためです。もし、DOMDocumentFragment内に含まれる子ノードのテキストコンテンツにアクセスしたい場合は、個々の子ノードに対してアクセスする必要があります。

構文(syntax)


1<?php
2$fragment = new DOMDocumentFragment();
3
4// nodeValueプロパティに値を設定する構文
5$fragment->nodeValue = 'これはDOMDocumentFragmentのnodeValueです。';
6
7// nodeValueプロパティから値を取得する構文
8$value = $fragment->nodeValue;
9
10echo $value;
11?>

引数(parameters)

引数なし

引数はありません

戻り値(return)

?string

DOMDocumentFragment オブジェクトのノードの値を取得します。ノードの値が存在しない場合は null を返します。

サンプルコード

PHP DOMDocument nodeValue でテキスト取得


1<?php
2
3// DOMDocumentFragment を作成し、テキストノードを追加する例
4$dom = new DOMDocument();
5$fragment = $dom->createDocumentFragment();
6
7// テキストノードを作成
8$text = $dom->createTextNode("Hello, world!");
9
10// フラグメントにテキストノードを追加
11$fragment->appendChild($text);
12
13// nodeValue プロパティを使用して、テキストノードの値を取得する
14$nodeValue = $fragment->nodeValue;
15
16// 結果を出力
17echo $nodeValue . PHP_EOL; // Hello, world!

PHPのDOMDocumentFragmentクラスにおけるnodeValueプロパティは、フラグメントに含まれるノードのテキストコンテンツを取得するために使用します。このプロパティは引数を必要としません。

上記のサンプルコードでは、まずDOMDocumentオブジェクトを作成し、それを用いてDOMDocumentFragmentオブジェクトを生成しています。次に、createTextNodeメソッドでテキストノードを作成し、appendChildメソッドでそのテキストノードをフラグメントに追加しています。

$fragment->nodeValueと記述することで、フラグメント内のすべてのテキストノードの値を連結した文字列を取得できます。この例では、フラグメントには"Hello, world!"というテキストノードのみが含まれているため、nodeValueプロパティは"Hello, world!"という文字列を返します。

nodeValueプロパティの戻り値はnullable string型（?string）です。これは、フラグメントが空の場合など、テキストコンテンツが存在しない場合にnullを返す可能性があることを意味します。取得したテキストコンテンツは、echo文で出力され、ターミナルやブラウザに表示されます。

DOMDocumentFragmentのnodeValueプロパティは、フラグメント自体ではなく、フラグメントに含まれるすべての子ノードのテキストコンテンツを連結したものを返します。フラグメントが空の場合や、テキストノード以外の子ノードを含む場合は、期待どおりの結果にならないことがあります。nodeValueは読み取り専用プロパティであり、値を直接変更することはできません。テキストノードの値を変更するには、該当するテキストノードに対して操作を行う必要があります。また、nodeValueがnullを返す可能性があるため、利用する際にはnullチェックを行うことを推奨します。

PHP DOMDocumentFragmentのnodeValueを取得する


1<?php
2
3/**
4 * DOMDocumentFragment クラスの nodeValue プロパティの基本的な使用例を示します。
5 *
6 * DOMDocumentFragment は、ノードの断片を保持するためのコンテナであり、
7 * それ自体はテキスト値を持たないため、nodeValue プロパティは常に NULL を返します。
8 * HTMLコンテンツをフラグメントに追加しても、この振る舞いは変わりません。
9 */
10function demonstrateDomDocumentFragmentNodeValue(): void
11{
12    // DOMDocument オブジェクトを作成し、HTMLコンテンツを扱う準備をします。
13    // DOMDocumentFragment を作成するには、まず DOMDocument オブジェクトが必要です。
14    $dom = new DOMDocument('1.0', 'UTF-8');
15    // HTMLのパース時に発生する可能性のある警告を抑制します。
16    libxml_use_internal_errors(true);
17    // 最小限のHTMLをロードします。（DOMDocumentFragmentの作成には必要ありませんが、
18    // DOMDocumentが有効な状態であることを示します。）
19    $dom->loadHTML('<!DOCTYPE html><html><body></body></html>');
20    libxml_clear_errors();
21
22    // 新しい DOMDocumentFragment を作成します。
23    $fragment = $dom->createDocumentFragment();
24
25    // HTML文字列を DOMDocumentFragment に追加します。
26    // このHTMLはフラグメントの子ノードとして追加されます。
27    $htmlContent = '<p>Hello <span>World</span>!</p>追加のテキストです。';
28    $fragment->appendXML($htmlContent);
29
30    echo "DOMDocumentFragment に以下のHTMLコンテンツを追加しました:\n";
31    echo "--------------------------------------------------\n";
32    echo $htmlContent . "\n";
33    echo "--------------------------------------------------\n\n";
34
35    echo "DOMDocumentFragment->nodeValue の値を確認します。\n";
36    echo "DOMDocumentFragment はノードのコンテナであるため、\n";
37    echo "それ自体は直接的なテキスト値を持たず、nodeValue は常に NULL を返します。\n\n";
38
39    // DOMDocumentFragment の nodeValue プロパティを取得し、表示します。
40    // NULL が出力されることを確認してください。
41    $nodeValue = $fragment->nodeValue;
42    echo "DOMDocumentFragment->nodeValue: ";
43    var_dump($nodeValue); // 出力は 'NULL' となります
44}
45
46// サンプル関数を実行します。
47demonstrateDomDocumentFragmentNodeValue();
48

DOMDocumentFragmentクラスのnodeValueプロパティは、ノードの値を返します。ただし、DOMDocumentFragmentはノードの断片を保持するコンテナであり、それ自体はテキストノードではないため、nodeValueは常にNULLを返します。

このサンプルコードでは、まずDOMDocumentオブジェクトを作成し、HTMLをロードします。次に、createDocumentFragment()メソッドでDOMDocumentFragmentオブジェクトを生成し、appendXML()メソッドを使ってHTMLコンテンツをフラグメントに追加します。

ここで、$fragment->nodeValueを実行すると、NULLが出力されます。これは、DOMDocumentFragmentが複数のノードをまとめて扱うためのもので、フラグメント自体が特定のテキスト値を持つわけではないためです。このプロパティは、要素ノードやテキストノードなどの具体的なテキスト値を持つノードに対して意味を持ちます。DOMDocumentFragmentはあくまでノードの集合を扱うためのものと理解してください。戻り値はnullable string型（?string）で、値がない場合はNULLを返します。

DOMDocumentFragmentのnodeValueプロパティは、常にNULLを返すことに注意が必要です。これは、DOMDocumentFragment自体がテキストノードではなく、複数のノードを保持するコンテナであるためです。HTMLコンテンツをappendXML()などで追加しても、フラグメント自身のnodeValueはNULLのままです。フラグメント内のテキストを取得したい場合は、子ノードを辿ってテキストノードのnodeValueを取得する必要があります。libxml_use_internal_errors(true)は、HTML解析エラーを抑制しますが、本番環境ではエラー内容を適切に処理することを推奨します。loadHTML()を使用する際は、文字エンコーディングに注意してください。