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

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

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

基本的な使い方

dataプロパティは、Dom\Textオブジェクトが表すテキストノードの実際の文字列データを保持するプロパティです。このプロパティは、親クラスであるDom\CharacterDataから継承されており、HTMLやXMLドキュメント内の具体的なテキスト内容に直接アクセスするために使用されます。例えば、サンプルテキストというHTML要素がある場合、p要素の子であるテキストノードのdataプロパティには、「サンプルテキスト」という文字列が格納されています。このプロパティは値の読み取りだけでなく、新しい文字列を代入することによる書き込みも可能です。これにより、DOMツリー内のテキストを動的に変更できます。Dom\Nodeクラスから継承されるtextContentプロパティと機能が似ていますが、Dom\TextノードにおいてはdataとtextContentは同じ値を返します。textContentが子孫ノード全体のテキストを連結して返すのに対し、dataはそのノード自身が持つ純粋なテキストデータのみを扱う点が特徴です。したがって、個別のテキストノードの値を正確に操作する際に不可欠なプロパティとなります。

構文(syntax)


1<?php
2
3$document = new \Dom\Document();
4$document->loadHTML('<div>Sample Text</div>');
5
6$textNode = $document->getElementsByTagName('div')[0]->firstChild;
7
8// Dom\Text::data プロパティから値を取得します
9echo $textNode->data . PHP_EOL;
10
11// Dom\Text::data プロパティに新しい値を設定します
12$textNode->data = 'New Text Content';
13
14echo $document->saveHTML();
15
16?>

引数(parameters)

引数なし

引数はありません

戻り値(return)

string

Dom\Text クラスの data プロパティは、ノードのテキストコンテンツを文字列として返します。

サンプルコード

PHP Dom\Text::data でテキスト取得


1<?php
2
3/**
4 * Dom\Text クラスの data プロパティを使用して、
5 * HTML要素内のテキストコンテンツを取得するサンプル関数です。
6 *
7 * @return void
8 */
9function demonstrateDataProperty(): void
10{
11    // 操作対象のHTML文字列
12    $htmlString = '<!DOCTYPE html>
13    <html>
14    <body>
15        <h1>DOMの例</h1>
16        <p>これは段落のテキストです。</p>
17    </body>
18    </html>';
19
20    // DOMDocumentオブジェクトをインスタンス化
21    $dom = new \DOMDocument();
22
23    // HTML文字列を読み込む（エラーは内部で処理）
24    @$dom->loadHTML($htmlString);
25
26    // <p> タグの要素を取得
27    $pElement = $dom->getElementsByTagName('p')->item(0);
28
29    // <p> 要素の最初の子ノード（テキストノード）を取得
30    $textNode = $pElement?->firstChild;
31
32    // ノードがテキストノードであることを確認
33    if ($textNode instanceof \Dom\Text) {
34        // Dom\Text::data プロパティを使用してテキストデータを取得
35        $textData = $textNode->data;
36
37        // 取得したデータを出力
38        echo 'p要素から取得したテキスト: ' . $textData . PHP_EOL;
39    } else {
40        echo 'テキストノードが見つかりませんでした。' . PHP_EOL;
41    }
42}
43
44// 関数を実行
45demonstrateDataProperty();

このサンプルコードは、PHPのDom\Textクラスにおけるdataプロパティの使用例を示しています。dataプロパティは、Dom\Textオブジェクトが保持するテキストノードの文字列データを取得するために使用されます。

まず、DOMDocumentオブジェクトを生成し、HTML文字列を読み込みます。次に、getElementsByTagNameメソッドを使って要素を取得し、その最初の子ノードであるテキストノードを取得します。

重要な点として、取得したノードがDom\Textクラスのインスタンスであるかを確認する必要があります。これは、instanceof演算子を用いて確認できます。

テキストノードであることが確認できたら、$textNode->dataと記述することで、dataプロパティにアクセスし、テキストデータを文字列として取得できます。このdataプロパティは引数を必要とせず、テキストノードが保持する文字列を返します。

最後に、取得したテキストデータを出力します。もしテキストノードが見つからない場合は、その旨を知らせるメッセージを出力します。この例では、要素内のテキストコンテンツを抽出するためにdataプロパティが活用されています。

Dom\Text クラスの data プロパティは、テキストノードのテキストコンテンツを取得するために使用します。$pElement?->firstChild のように、? を用いたnull許容演算子を使用している箇所は、 $pElement がnullの場合にエラーが発生するのを防ぐための安全策です。loadHTML 関数は、HTMLの構造によっては警告を発生させる可能性があるため、@ でエラーを抑制しています。しかし、本番環境ではエラーの内容を確認できるように、エラー処理を適切に行うことを推奨します。instanceof 演算子で $textNode が Dom\Text のインスタンスであることを確認してから data プロパティにアクセスすることで、予期せぬエラーを回避できます。

PHP Dom\Text data プロパティでテキスト取得


1<?php
2
3// Dom\Text クラスの data プロパティを使用して、テキストノードのデータを取得する例
4$dom = new DOMDocument();
5$dom->loadHTML('<!DOCTYPE html><html><body><p>Hello, world!</p></body></html>');
6
7// テキストノードを取得
8$textNode = $dom->getElementsByTagName('p')->item(0)->firstChild;
9
10// data プロパティを使用してテキストノードのデータを取得
11if ($textNode instanceof DOMText) {
12    $data = $textNode->data;
13    echo $data . PHP_EOL; // "Hello, world!" が出力される
14}
15
16// 日付の操作例
17$currentDate = date("Y-m-d H:i:s");
18echo "Current date and time: " . $currentDate . PHP_EOL;

PHPのDom\Textクラスのdataプロパティは、テキストノードが保持する文字列データにアクセスするために使用します。このプロパティは引数を取らず、テキストノードの値を文字列として返します。

上記のサンプルコードでは、まずDOMDocumentクラスを用いてHTMLドキュメントを読み込んでいます。次に、getElementsByTagNameメソッドで要素を取得し、その最初の子ノード（テキストノード）を変数$textNodeに格納しています。

instanceof演算子を使って $textNode が実際に DOMText クラスのインスタンスであるかを確認後、$textNode->data でテキストノードのデータを取得し、画面に出力しています。この例では "Hello, world!" という文字列が出力されます。

また、関連する例として、date()関数を用いた現在の日付と時刻の取得方法も示しています。date("Y-m-d H:i:s") は、現在の日付と時刻を指定されたフォーマット（年-月-日時:分:秒）で文字列として返します。取得した日付と時刻は、画面に出力されます。date()関数は、PHPで日付や時刻を扱う上で非常に基本的な関数であり、様々なフォーマットで日付情報を取得するために広く利用されます。PHP_EOL は改行コードを意味し、出力結果を見やすくするために使用しています。

Dom\Text クラスの data プロパティは、テキストノードの内容を文字列として取得します。取得前に、ノードが DOMText クラスのインスタンスであることを instanceof で確認しましょう。これにより、予期せぬエラーを防ぐことができます。date() 関数は、現在の日付や時刻を指定した形式で取得する際に便利です。書式指定文字列（例："Y-m-d H:i:s"）を正しく指定することで、希望どおりの日付情報を取得できます。date() 関数の引数にタイムゾーンを指定することも可能です。