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

Copy
1<?php
2
3// Dom\XMLDocument の textContent プロパティのサンプル
4
5// XML 文字列を定義
6$xmlString = <<<XML
7<?xml version="1.0" encoding="UTF-8"?>
8<root>
9  <element>This is some text content.</element>
10</root>
11XML;
12
13// XMLDocument オブジェクトを生成
14$dom = new DOMDocument();
15$dom->loadXML($xmlString);
16
17// ルート要素を取得
18$root = $dom->documentElement;
19
20// element 要素を取得
21$element = $root->firstChild;
22
23// textContent プロパティを使用してテキストコンテンツを取得
24$textContent = $element->textContent;
25
26// 結果を出力
27echo $textContent . PHP_EOL; // 出力: This is some text content.

PHP 8 における Dom\XMLDocument クラスの textContent プロパティについて解説します。このプロパティは、XML ドキュメントのノード（要素など）に含まれるテキストコンテンツを取得するために使用されます。

上記のサンプルコードでは、まず XML 文字列を定義し、DOMDocument オブジェクトを生成してその XML 文字列を読み込んでいます。次に、documentElement プロパティを使用してルート要素を取得し、firstChild プロパティで最初の子要素（ここでは <element> 要素）を取得しています。

そして、取得した要素の textContent プロパティにアクセスすることで、<element> 要素に含まれるテキストコンテンツ "This is some text content." を文字列として取得しています。 最後に、取得したテキストコンテンツを出力しています。

textContent プロパティは引数を持ちません。戻り値は文字列型で、ノードに含まれるテキストコンテンツ全体を表します。もしノードが子要素を含んでいる場合、それらの子要素に含まれるテキストコンテンツも連結されて返されます。このプロパティを使用することで、XML ドキュメントから簡単にテキスト情報を抽出できます。システム開発において、XML データを扱う際に非常に役立つ機能です。

Copy
1<?php
2
3// Dom\XMLDocument クラスの textContent プロパティのサンプルコード
4
5// XML ドキュメントをロード
6$xmlString = '<root><child>Hello, World!</child></root>';
7$dom = new DOMDocument();
8$dom->loadXML($xmlString);
9
10// ルート要素を取得
11$root = $dom->documentElement;
12
13// 子要素を取得
14$child = $root->firstChild;
15
16// textContent プロパティを使用して、要素のテキストコンテンツを取得
17$textContent = $child->textContent;
18
19// 結果を出力
20echo $textContent . PHP_EOL; // "Hello, World!" が出力される
21
22// nodeValue と textContent の違い
23// nodeValue は要素ノードの場合、null を返す (属性ノードの場合は属性値を返す)
24// textContent は要素ノードとその子孫ノードのテキストコンテンツを連結したものを返す
25echo $child->nodeValue . PHP_EOL; // "Hello, World!" が出力される (このケースでは同じ結果になるが、より複雑な構造では異なる)
26
27$xmlStringWithAttributes = '<root><child attr="value">Hello, World!</child></root>';
28$domWithAttributes = new DOMDocument();
29$domWithAttributes->loadXML($xmlStringWithAttributes);
30
31$rootWithAttributes = $domWithAttributes->documentElement;
32$childWithAttributes = $rootWithAttributes->firstChild;
33
34echo $childWithAttributes->nodeValue . PHP_EOL; // Hello, World!
35echo $childWithAttributes->textContent . PHP_EOL; // Hello, World!
36
37$attr = $childWithAttributes->getAttributeNode('attr');
38echo $attr->nodeValue . PHP_EOL; // value
39echo $attr->textContent . PHP_EOL; // value

PHP 8 の Dom\XMLDocument クラスにおける textContent プロパティについて解説します。このプロパティは、XML ドキュメント内の要素ノードが持つテキストコンテンツを取得するために使用します。

サンプルコードでは、まず XML 文字列を DOMDocument オブジェクトにロードしています。その後、ルート要素と子要素を取得し、子要素の textContent プロパティにアクセスすることで、要素に含まれるテキスト "Hello, World!" を取得しています。取得したテキストは echo 文で出力されます。

textContent と nodeValue の違いについても触れています。要素ノードの場合、nodeValue は要素自体の値ではなく、その要素が持つテキストノードの値を返します。一方、textContent は要素ノードとそのすべての子孫ノードのテキストコンテンツを連結した文字列を返します。簡単な例では同じ結果になることもありますが、より複雑な XML 構造の場合、結果が異なることがあります。属性ノードの場合は、nodeValue も textContent も属性値を返します。

textContent プロパティは引数を持ちません。戻り値は常に文字列型です。このプロパティを使用することで、XML ドキュメントから効率的にテキストコンテンツを抽出できます。システム開発においては、XML データを処理する際に非常に役立ちます。