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

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

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

基本的な使い方

dataプロパティは、DOMTextノードが保持するテキストデータを取得または設定するためのプロパティです。DOMTextは、XMLドキュメントまたはHTMLドキュメント内のテキストコンテンツを表すノードです。このdataプロパティを使用することで、ノード内のテキストデータを文字列として読み取ったり、新しいテキストデータで上書きしたりできます。

具体的には、$domtext->dataのように記述することで、DOMTextオブジェクト $domtext が保持しているテキストデータを文字列として取得できます。また、$domtext->data = "新しいテキスト"; のように記述することで、DOMTextオブジェクト $domtext が保持しているテキストデータを "新しいテキスト" という文字列に書き換えることができます。

このプロパティは、XMLドキュメントやHTMLドキュメントの内容を動的に変更する際に非常に役立ちます。例えば、フォームに入力されたデータを元にドキュメント内の特定のテキストを書き換えたり、データベースから取得したデータをドキュメントに埋め込んだりする処理などが考えられます。

DOMTextノードのテキストデータを直接操作する手段として、dataプロパティは不可欠な存在です。テキストデータを取得する際は、現在のノードが保持するテキストコンテンツが文字列として返されます。テキストデータを設定する際は、指定された文字列がノードの新しいテキストコンテンツとして設定され、以前のテキストコンテンツは上書きされます。この際、XMLやHTMLのエンティティ（例：< を < で表現するなど）に関する処理は自動的に行われないため、必要に応じて自分でエスケープ処理を行う必要があります。

構文(syntax)


1string DOMText::$data;

引数(parameters)

引数なし

引数はありません

戻り値(return)

string

DOMTextノードのテキストコンテンツを文字列として返します。

サンプルコード

PHP DOMText dataプロパティでテキスト取得


1<?php
2
3/**
4 * DOMTextのdataプロパティを使用してテキストノードの内容を取得します。
5 *
6 * @param string $htmlContent 解析するHTML文字列。
7 * @return string|null テキストノードの内容。見つからない場合はnull。
8 */
9function getTextDataFromHtml(string $htmlContent): ?string
10{
11    // DOMDocumentオブジェクトをインスタンス化します。
12    $dom = new DOMDocument();
13
14    // HTML文字列を読み込みます。エラーは抑制します。
15    // LIBXML_HTML_NOIMPLIED と LIBXML_HTML_NODEFDTD は、
16    // HTMLスニペットを読み込む際に余分な<html><body>タグが追加されるのを防ぎます。
17    @$dom->loadHTML($htmlContent, LIBXML_HTML_NOIMPLIED | LIBXML_HTML_NODEFDTD);
18
19    // ドキュメント内の最初のp要素を取得します。
20    $pElement = $dom->getElementsByTagName('p')->item(0);
21
22    // p要素が存在し、かつ子ノードを持っているか確認します。
23    if ($pElement && $pElement->hasChildNodes()) {
24        // 最初の子ノードを取得します。この例ではテキストノードです。
25        $firstNode = $pElement->firstChild;
26
27        // ノードがテキストノード(DOMText)であるかを確認します。
28        if ($firstNode instanceof DOMText) {
29            // DOMTextクラスの 'data' プロパティにアクセスして、
30            // ノードの文字列データを取得し、返します。
31            return $firstNode->data;
32        }
33    }
34
35    return null;
36}
37
38// 解析対象のHTMLデータ
39$html = '<p>こんにちは、DOMTextの世界へ！</p>';
40
41// 関数を呼び出してテキストデータを取得します
42$textData = getTextDataFromHtml($html);
43
44// 取得したデータを出力します
45echo $textData . PHP_EOL;
46
47?>

DOMTextクラスのdataプロパティは、HTMLやXML文書におけるテキストノード、つまり文字情報そのものが格納されている部分の内容を取得するために使用します。このプロパティは引数を取らず、戻り値としてテキストノードが持つ文字列（string）を返します。

サンプルコードのgetTextDataFromHtml関数は、引数としてHTML文字列を受け取ります。まず、DOMDocumentクラスを用いてHTML文字列を解析し、プログラムで操作できるオブジェクト構造に変換します。次に、<p>タグで囲まれた要素を探し出し、その要素の最初の子ノードを取得します。この例では、<p>タグの中には「こんにちは、DOMTextの世界へ！」というテキストしか存在しないため、最初の子ノードはテキストノード（DOMTextオブジェクト）となります。そして、$firstNode->dataのようにdataプロパティにアクセスすることで、このテキストノードが保持している実際の文字列データを取得しています。関数は取得した文字列を返し、もしテキストノードが見つからなければnullを返します。このようにdataプロパティは、HTMLタグの中から特定のテキスト情報だけを正確に抜き出したい場合に便利な機能です。

loadHTML関数での@によるエラー抑制は、不正なHTMLでの警告を防ぎますが、デバッグ時にはエラーの原因が分かりにくくなる点に注意が必要です。getElementsByTagNameで要素を取得する際は、対象が見つからないとitem(0)はnullを返すため、必ずif文で存在を確認してください。また、firstChildは必ずしもテキストとは限らず、空白や改行もテキストノードとして扱われたり、子要素である可能性もあります。そのため、instanceof DOMTextでノードの種類をきちんと確認してからdataプロパティにアクセスすることが、エラーを防ぎ安全に処理する上で重要です。

DOMText::dataでPHP dateを取得する


1<?php
2
3/**
4 * DOMText::data プロパティの使用例。
5 * 現在の日付文字列をDOMTextノードに設定し、そのデータをプロパティ経由で取得して表示します。
6 * キーワード「date」に関連付けるため、PHPのdate()関数を使用しています。
7 */
8function demonstrateDomTextDataProperty(): void
9{
10    // 新しいDOMDocumentインスタンスを作成
11    // XML宣言 '1.0' とエンコーディング 'UTF-8' を指定します。
12    $dom = new DOMDocument('1.0', 'UTF-8');
13    // 生成されるXMLの可読性を高めるため、整形出力を有効にします (オプション)。
14    $dom->formatOutput = true;
15
16    // ルート要素（例: <root>）を作成し、DOMDocumentに追加します。
17    $rootElement = $dom->createElement('root');
18    $dom->appendChild($rootElement);
19
20    // 現在の日付文字列を生成します。
21    // PHPのdate()関数を使用して、現在の「年-月-日 時:分:秒」形式の文字列を取得します。
22    $currentDateTimeString = date('Y-m-d H:i:s');
23
24    // DOMTextノードを作成し、生成した日付文字列をそのデータとして設定します。
25    // DOMTextノードは、XMLやHTML要素内の実際のテキストコンテンツを保持する役割を持ちます。
26    $domTextNode = $dom->createTextNode('現在のサーバー日時: ' . $currentDateTimeString);
27
28    // 作成したテキストノードをルート要素に追加します。
29    $rootElement->appendChild($domTextNode);
30
31    // DOMText::data プロパティを使用して、テキストノードの文字列データを取得し表示します。
32    // このプロパティは、テキストノードが持つ純粋な文字列内容に直接アクセスするために使用されます。
33    echo "--- DOMText::data プロパティによるデータ取得 ---" . PHP_EOL;
34    echo "取得されたテキストデータ: " . $domTextNode->data . PHP_EOL;
35}
36
37// 上記の関数を実行して、DOMText::data プロパティの動作を確認します。
38demonstrateDomTextDataProperty();

PHPのDOMText::dataプロパティは、XMLやHTMLドキュメントの構造を表現するDOM（Document Object Model）において、要素の内部にある純粋なテキストコンテンツを扱うDOMTextノードが持つ、実際の文字列データに直接アクセスするためのプロパティです。このプロパティは、追加の引数を必要とせず、DOMTextノードが保持するテキストデータをstring型でそのまま返します。

このサンプルコードでは、まずXMLドキュメントを操作するためのDOMDocumentインスタンスを作成し、その中に<root>要素を追加しています。次に、PHPのdate()関数を利用して現在の「年-月-日時:分:秒」形式の日付文字列を生成しています。これは、キーワード「date」との関連性を示す具体的な例です。生成されたこの日付文字列は、createTextNode()メソッドによってDOMTextノードとして作成され、root要素の子ノードとしてドキュメントツリーに組み込まれます。DOMTextノードは、このように要素のテキスト部分を表現する役割を担います。

最終的に、作成された$domTextNodeインスタンスから->dataプロパティにアクセスすることで、ノードに設定されている文字列データを取得し、画面に出力しています。このようにDOMText::dataプロパティは、DOMツリー内のテキストノードが持つ内容を簡単に読み取るための便利な方法を提供し、テキストデータの取得や確認、あるいは変更といった操作で利用されます。

DOMText::dataプロパティは、XMLやHTMLの要素が持つ純粋なテキスト内容に直接アクセスするものであり、要素名や属性値とは異なります。この違いを理解することが重要です。また、サンプルコードで使用しているPHPのdate()関数は、実行されるサーバーのタイムゾーン設定に影響されます。意図しない時刻になることを防ぐため、必要に応じてdate_default_timezone_set()関数で明示的にタイムゾーンを設定することをおすすめします。DOM操作では、createElementで要素を、createTextNodeでテキストノードを作成し、appendChildで適切な位置に追加していく基本的な手順を習得することが、安全で正確なコンテンツ構築の鍵となります。