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

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

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

基本的な使い方

textContentプロパティは、DOMTextノードのテキスト内容を取得または設定するためのプロパティです。DOMTextクラスは、XMLドキュメントまたはHTMLドキュメント内のテキストノードを表します。textContentプロパティを使用することで、テキストノードに含まれるテキストデータを文字列として取得したり、新しいテキストデータで既存のテキストデータを置き換えたりすることができます。

具体的には、テキストノードのtextContentプロパティを読み取ることで、そのノードが保持しているテキストコンテンツが文字列として返されます。例えば、<p>Hello, world!</p>というHTML要素があった場合、"Hello, world!"というテキストノードのtextContentプロパティを読み取ると、"Hello, world!"という文字列が得られます。

一方、textContentプロパティに文字列を代入すると、そのテキストノードのテキストコンテンツが指定された文字列で置き換えられます。元のテキストコンテンツは完全に削除され、新しいテキストコンテンツが設定されます。textContentプロパティへの代入は、テキストノードの内容を動的に変更する際に非常に便利です。

textContentプロパティは、テキストノードの操作において基本的な役割を果たします。他のDOM操作と組み合わせることで、ドキュメントの構造を柔軟に操作し、動的なコンテンツ生成を容易にします。例えば、ユーザーの入力に基づいてテキストノードの内容を更新したり、データベースから取得したデータをテキストノードに表示したりするなど、さまざまな用途で活用できます。textContentプロパティは、DOMを操作する上で不可欠なプロパティの一つと言えるでしょう。

構文(syntax)


1<?php
2$dom = new DOMDocument();
3$dom->loadHTML('<p>Hello, world!</p>');
4$textNode = $dom->createTextNode('New text content');
5
6$paragraph = $dom->getElementsByTagName('p')->item(0);
7$paragraph->textContent = $textNode->textContent;
8
9echo $dom->saveHTML();
10?>

引数(parameters)

引数なし

引数はありません

戻り値(return)

string

DOMTextノードに含まれるテキストコンテンツを文字列として取得します。

サンプルコード

PHP DOMDocument textContent でテキスト取得


1<?php
2
3// DOMDocument を作成
4$dom = new DOMDocument();
5
6// HTML 文字列をロード
7$dom->loadHTML('<!DOCTYPE html><html><body><p>Hello, world!</p></body></html>');
8
9// p 要素を取得
10$p = $dom->getElementsByTagName('p')->item(0);
11
12// p 要素の中のテキストノードを取得
13if ($p) {
14    $textNode = $p->firstChild;
15
16    // テキストノードが DOMText のインスタンスであるか確認
17    if ($textNode instanceof DOMText) {
18        // textContent プロパティを使用してテキストコンテンツを取得
19        $textContent = $textNode->textContent;
20
21        // テキストコンテンツを出力
22        echo $textContent . PHP_EOL; // Hello, world!
23    }
24}
25
26?>

PHPのDOMTextクラスにおけるtextContentプロパティは、ノードのテキストコンテンツを取得または設定するために使用されます。このプロパティは、DOMTextオブジェクトが持つテキストデータを文字列として返します。

上記のサンプルコードでは、まずDOMDocumentオブジェクトを作成し、HTML文字列をロードしています。次に、getElementsByTagNameメソッドを使ってp要素を取得し、そのfirstChild（テキストノード）を取得しています。instanceof演算子を用いて、取得したノードがDOMTextクラスのインスタンスであるかを確認します。

DOMTextオブジェクトであることが確認できたら、textContentプロパティにアクセスすることで、テキストコンテンツを取得できます。この例では、$textNode->textContentによって、<p>要素内のテキスト「Hello, world!」が変数$textContentに格納されます。最後に、取得したテキストコンテンツをechoで出力しています。

textContentプロパティは引数を持ちません。戻り値は文字列型（string）で、ノードが持つテキストコンテンツを表します。このプロパティを使用することで、DOMドキュメントから簡単にテキストデータを取り出すことが可能になります。Webページのスクレイピングやデータ抽出処理などで非常に役立ちます。

DOMText クラスの textContent プロパティは、テキストノードの内容を取得する際に便利です。サンプルコードでは、まず DOMDocument を使ってHTMLを読み込み、p 要素内の最初のノードが DOMText のインスタンスであることを確認しています。textContent は、取得したテキストを文字列として返します。firstChild が常にテキストノードとは限らないため、instanceof DOMText による型チェックが重要です。また、要素が存在しない場合やテキストノードが存在しない場合は、エラーを避けるために事前に存在確認を行うようにしましょう。getElementsByTagName() の結果や $textNode が null でないことを確認することで、より安全なコードになります。

PHP DOM textContent でテキスト取得する


1<?php
2
3// DOMDocumentを生成
4$dom = new DOMDocument();
5
6// HTMLを読み込み
7$dom->loadHTML('<!DOCTYPE html><html><body><div>Hello, world!</div></body></html>');
8
9// テキストノードを取得
10$element = $dom->getElementsByTagName('div')->item(0);
11$textNode = $element->firstChild;
12
13// textContentプロパティを使用してテキストコンテンツを取得
14if ($textNode instanceof DOMText) {
15    $textContent = $textNode->textContent;
16
17    // 結果を出力
18    echo $textContent . PHP_EOL; // Hello, world!
19}

PHPのDOMTextクラスにおけるtextContentプロパティは、テキストノードのテキストコンテンツを取得するために使用されます。このプロパティは引数を持ちません。戻り値として、テキストノードに含まれる文字列を返します。

上記のサンプルコードでは、まずDOMDocumentオブジェクトを作成し、HTMLドキュメントを読み込んでいます。次に、getElementsByTagName()メソッドを使ってdiv要素を取得し、その最初の子ノード（テキストノード）を取得しています。

取得したノードがDOMTextのインスタンスであることを確認した後、textContentプロパティにアクセスしてテキストコンテンツを取得しています。取得したテキストコンテンツは、変数$textContentに格納されます。

最後に、echoステートメントを使ってテキストコンテンツを出力しています。この例では、div要素内のテキスト「Hello, world!」が出力されます。textContentプロパティを使用することで、DOMツリー内のテキストノードから簡単にテキストコンテンツを取り出すことができます。

DOMTextのtextContentプロパティは、テキストノードの文字列を取得する際に利用します。サンプルコードでは、firstChildがテキストノードであることをinstanceofで確認してからtextContentを取得しています。これは、想定外のノードタイプ（例えばコメントノード）だった場合にエラーが発生するのを防ぐためです。textContentは読み取り専用ではありませんが、DOM構造に影響を与える可能性があるため、値を変更する場合は注意が必要です。また、HTMLエンティティ（&など）はデコードされた状態で取得される点も覚えておきましょう。