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

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

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

基本的な使い方

textContentプロパティは、PHPのDOM拡張機能において、Dom\Documentクラスが持つ、ドキュメントのすべてのテキストコンテンツを文字列として取得または設定するためのプロパティです。このプロパティを使用すると、HTMLやXMLドキュメント全体から、タグや属性、コメントなどのマークアップを除いた、純粋なテキスト部分のみを簡単に扱えます。

具体的には、Dom\Documentオブジェクトに対してtextContentプロパティを参照すると、そのドキュメント内のすべての要素ノード、テキストノード、CDATAセクションノードなどのテキストコンテンツが結合され、単一の文字列として返されます。これにより、例えばウェブページから記事の本文だけを抽出する際などに非常に便利です。

一方、textContentプロパティに新しい文字列を代入することで、ドキュメント全体のテキストコンテンツを更新することも可能です。この操作を行うと、元のドキュメントが持っていたすべての子ノードは削除され、代入された文字列が新しいテキストノードとしてドキュメントの直下に追加されます。そのため、既存の複雑なドキュメント構造を保持しながら一部のテキストを更新したい場合には注意が必要です。ドキュメントの内容を一括でシンプルなテキストに置き換えたい場合に特に有効です。このプロパティは、ドキュメントの構造を意識せずに、その「中身」であるテキスト情報にアクセスしたり変更したりする際に役立つでしょう。

構文(syntax)


1<?php
2$document = new Dom\Document();
3$document->loadHTML('<!DOCTYPE html><html><body><h1>Title</h1><p>Hello, World!</p></body></html>');
4echo $document->textContent;
5?>

引数(parameters)

引数なし

引数はありません

戻り値(return)

string

Dom\Document::textContent プロパティは、DOMツリー全体（要素、属性、テキストノードなど）に含まれるすべてのテキストコンテンツを連結した単一の文字列を返します。

サンプルコード

PHP DomDocument textContent でテキスト取得


1<?php
2
3// DomDocument を作成
4$dom = new DomDocument();
5
6// HTML をロード
7$dom->loadHTML('<!DOCTYPE html><html><head><title>Example</title></head><body><p>Hello, world!</p></body></html>');
8
9// body 要素を取得
10$body = $dom->getElementsByTagName('body')->item(0);
11
12// textContent プロパティを使って、body 要素のテキストコンテンツを取得
13$textContent = $body->textContent;
14
15// 結果を出力
16echo $textContent . PHP_EOL; // Hello, world!

PHPのDomDocumentクラスにおけるtextContentプロパティについて解説します。このプロパティは、その要素ノードが持つテキストコンテンツを取得するために使用されます。サンプルコードでは、まずDomDocumentクラスのインスタンスを作成し、loadHTML()メソッドでHTMLドキュメントをロードしています。次に、getElementsByTagName()メソッドを使ってbody要素を取得し、item(0)で最初のbody要素ノードを取得しています。

この取得したbody要素ノードに対して、textContentプロパティにアクセスすることで、body要素に含まれるテキストコンテンツ（この場合は"Hello, world!"）を取得できます。textContentプロパティは引数を持ちません。そして、取得したテキストコンテンツは文字列として返されます。

サンプルコードでは、取得したテキストコンテンツをechoで出力しています。この例では、HTMLドキュメント全体の構造から特定の要素のテキスト部分だけを抽出する方法を示しており、WebスクレイピングやHTMLデータの解析において非常に役立ちます。textContentプロパティを使用することで、要素内のHTMLタグを除いたテキスト情報のみを簡単に取得することが可能です。

DomDocument::textContentは、要素内のテキストノードを連結した文字列を返します。HTML全体ではなく、指定した要素（上記の例ではbody要素）の子要素のテキスト内容のみ取得することに注意が必要です。要素に子要素がない場合、空文字列が返されます。loadHTMLで読み込むHTMLは、文字エンコーディングに注意してください。UTF-8以外のエンコーディングの場合、文字化けが発生する可能性があります。getElementsByTagNameはDomNodeListを返すため、item(0)で最初の要素を取得する必要があります。要素が存在しない場合、item(0)はnullを返すため、事前に存在チェックを行うことを推奨します。

PHP DOM textContent で要素のテキストを取得する


1<?php
2
3// DomDocument を作成
4$dom = new DOMDocument();
5
6// HTML をロード
7$dom->loadHTML('<!DOCTYPE html><html><head><title>Example</title></head><body><p>Hello, World!</p></body></html>');
8
9// p 要素を取得
10$p = $dom->getElementsByTagName('p')->item(0);
11
12// textContent プロパティを使用して、p 要素のテキストコンテンツを取得
13$textContent = $p->textContent;
14
15// 結果を出力
16echo $textContent . PHP_EOL; // Hello, World!

このサンプルコードは、PHPのDOM拡張を用いて、HTMLドキュメントから特定の要素のテキストコンテンツを抽出する方法を示しています。DomDocumentクラスは、HTMLやXMLドキュメントを操作するための強力なツールです。

まず、DOMDocumentオブジェクトを作成し、loadHTML()メソッドを使用してHTML文字列を読み込みます。これにより、HTMLドキュメントがDOMツリーとして解析されます。次に、getElementsByTagName()メソッドを使って、特定のタグ名を持つ要素のリストを取得します。ここでは、タグを持つ要素を取得しています。item(0)メソッドでリストの最初の要素（つまり最初の要素）を取得し、$p変数に格納します。

ここで、textContentプロパティが登場します。textContentは、Dom\Documentクラスのプロパティであり、要素ノードのテキストコンテンツを取得・設定するために使用されます。この例では、$p要素（最初の要素）のtextContentプロパティにアクセスすることで、Hello, World!という要素のテキスト部分である"Hello, World!"を取得し、$textContent変数に格納しています。

最後に、echoステートメントを使用して、取得したテキストコンテンツを出力します。PHP_EOLは改行コードを表し、出力結果を見やすくするために追加されています。このコードを実行すると、コンソールに"Hello, World!"と表示されます。textContentプロパティは引数を取りませんが、文字列型の値を返します。HTMLドキュメントの構造を理解し、特定の要素からテキスト情報を抽出する基本的なテクニックを学ぶことができます。

textContentは、要素ノード内のテキストコンテンツを取得する際に便利です。ただし、HTMLに複数の子要素が含まれる場合、それら全てのテキストが連結された文字列として返される点に注意が必要です。要素の中に別の要素が含まれている場合、内側の要素のテキストも含まれます。また、loadHTMLでHTMLを読み込む際、文字エンコーディングに注意してください。予期せぬ文字化けを防ぐため、mb_convert_encodingなどで適切なエンコーディングに変換することを推奨します。さらに、getElementsByTagNameはDOMNodeListを返すため、item(0)で最初の要素を取得している点も重要です。もし要素が存在しない場合、item(0)はnullを返すため、事前に要素の存在を確認すると安全です。