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

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

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

基本的な使い方

textContentプロパティは、Dom\DocumentFragmentオブジェクトとそのすべての子孫ノードのテキストコンテンツを保持するプロパティです。このプロパティの値を取得すると、フラグメント内に含まれるすべてのノードを再帰的にたどり、それぞれのテキスト部分を連結した一つの文字列が返されます。このとき、HTMLのタグやコメント、処理命令といったマークアップはすべて除去され、純粋なテキスト情報のみが抽出されます。これにより、DOM構造から人間が読むテキスト部分だけを簡単に取り出すことが可能です。逆に、このプロパティに新しい文字列を代入すると、DocumentFragmentが元々保持していたすべての子ノードは完全に削除されます。そして、代入された文字列を内容とする新しいテキストノードが一つだけ、フラグメントの子として新たに追加されます。この機能は、フラグメントの内容を特定のテキストで一括して置き換えたい場合に非常に便利です。

構文(syntax)


1<?php
2
3$doc = new Dom\Document();
4$fragment = $doc->createDocumentFragment();
5
6// textContentプロパティに値を設定します
7$fragment->textContent = "Example text content.";
8
9// textContentプロパティの値を取得します
10$text = $fragment->textContent;
11
12echo $text; // "Example text content." を出力
13
14?>

引数(parameters)

引数なし

引数はありません

戻り値(return)

string|null

DomDocumentFragment オブジェクトが保持するテキストノードのコンテンツを文字列として返します。ノードが空の場合は null を返します。

サンプルコード

PHP DOMDocument textContentでテキスト取得


1<?php
2
3// DomDocumentFragment を作成し、テキストコンテンツを設定する例
4$dom = new DOMDocument();
5$fragment = $dom->createDocumentFragment();
6$fragment->appendXML('<p>Hello, world!</p>');
7
8// textContent プロパティを使用してテキストコンテンツを取得する
9$textContent = $fragment->textContent;
10
11// 結果を出力する
12echo $textContent; // "Hello, world!" が出力される
13
14// 空の DomDocumentFragment の場合
15$emptyFragment = $dom->createDocumentFragment();
16$emptyTextContent = $emptyFragment->textContent;
17
18// 結果を出力する。空の場合は空文字列が返る
19var_dump($emptyTextContent); // string(0) "" が出力される
20
21?>

PHPのDom\DocumentFragmentクラスにおけるtextContentプロパティは、ノードとその子孫ノードのテキストコンテンツを文字列として取得または設定するために使用します。このプロパティは、PHP 8で利用可能です。

サンプルコードでは、まずDOMDocumentFragmentオブジェクトを新規に作成し、appendXMLメソッドを用いて<p>Hello, world!</p>というXML構造を追加しています。その後、textContentプロパティにアクセスすることで、フラグメントに含まれるテキストコンテンツ（この場合は"Hello, world!"）を取得し、echoで出力しています。

textContentプロパティは読み書き可能です。値を設定することで、フラグメントの内容を新しいテキストコンテンツで置き換えることができます。

また、空のDOMDocumentFragmentオブジェクトに対してtextContentプロパティにアクセスした場合、空文字列が返されます。サンプルコードでは、空のフラグメントを作成し、textContentプロパティの値を変数に格納した後、var_dump関数を用いて型と値を確認しています。これにより、空文字列が返されることを確認できます。

textContentプロパティは引数を持ちません。戻り値は文字列型（string）またはnullです。ノードがテキストコンテンツを持たない場合は、空文字列が返されます。textContentプロパティを使用することで、DOMドキュメント内のテキストデータを簡単に操作できます。

DomDocumentFragmentのtextContentプロパティは、ノードとその子孫ノードに含まれるテキストコンテンツを文字列として返します。サンプルコードでは、appendXMLで追加された要素内のテキストを取得しています。もしノードにテキストコンテンツがない場合、textContentは空文字列("")を返します。これはnullとは異なるので注意が必要です。また、textContentは取得専用のプロパティであり、値を設定することはできません。textContentは、HTMLタグなどの要素を取り除いたテキストのみを取得したい場合に便利です。

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


1<?php
2
3// DomDocumentFragment を作成
4$fragment = new DOMDocumentFragment();
5
6// テキストノードを追加
7$fragment->appendXML('<p>Hello, world!</p>');
8
9// DomDocumentFragment の textContent プロパティを取得
10$textContent = $fragment->textContent;
11
12// 結果を出力
13echo $textContent . PHP_EOL; // 出力: Hello, world!
14
15// 空の DomDocumentFragment を作成
16$emptyFragment = new DOMDocumentFragment();
17
18// textContent プロパティを取得 (nullを返す)
19$emptyTextContent = $emptyFragment->textContent;
20
21// 結果を出力
22var_dump($emptyTextContent); // 出力: NULL

PHP 8 における Dom\DocumentFragment クラスの textContent プロパティについて解説します。Dom\DocumentFragment は、DOMドキュメントの一部を表現するために使用される軽量なノードです。textContent プロパティは、このフラグメントに含まれるすべてのテキストノードのテキスト内容を連結した文字列を取得または設定するために使用されます。

上記のサンプルコードでは、まず DOMDocumentFragment のインスタンスを作成し、appendXML メソッドを使用して <p>Hello, world!</p> という XML 文字列をフラグメントに追加しています。その後、textContent プロパティにアクセスすることで、フラグメント内のテキストノード (この場合は "Hello, world!") が抽出され、文字列として取得できます。取得したテキスト内容は echo 文によって出力されます。

次に、空の DOMDocumentFragment を作成し、同様に textContent プロパティにアクセスしています。この場合、フラグメント内にテキストノードが存在しないため、textContent プロパティは null を返します。var_dump 関数を使用して、戻り値が null であることを確認しています。

textContent プロパティは引数を取りません。戻り値は、フラグメント内にテキストノードが存在する場合は文字列、存在しない場合は null となります。textContent プロパティを使用することで、DomDocumentFragment に含まれるテキスト情報を簡単に取得できます。

DomDocumentFragment の textContent プロパティは、そのノードとその子孫ノードに含まれるテキストコンテンツを結合して返します。HTMLタグは取り除かれ、テキストのみが抽出される点に注意が必要です。もしフラグメントが空の場合、null が返されます。textContent は読み取り専用であり、値を設定することはできません。XMLとして追加する際は、appendXML が適切にエンコードされていることを確認してください。特に特殊文字やマルチバイト文字を含む場合は、文字化けを防ぐために注意が必要です。