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

textContentプロパティは、PHPのDom\Notationオブジェクトのテキストコンテンツを保持するプロパティです。Dom\Notationクラスは、XMLドキュメントのDOCTYPE宣言内で定義される「表記法（Notation）」という概念を表現します。表記法は、XMLの外部に存在するデータ（例えば、特定の画像フォーマットやアプリケーションデータなど）を識別し、その形式を宣言するために利用されますが、それ自体が直接的なテキストデータを持つことはありません。

このtextContentプロパティは、通常、指定されたノードとその子孫ノードのすべてのテキスト内容を連結した文字列を返します。しかし、Dom\Notationノードは、その性質上、テキストノードのような実質的なテキストコンテンツを持つことがありません。そのため、Dom\NotationオブジェクトからこのtextContentプロパティを読み取ると、常に空の文字列が返されます。このプロパティに値を設定しようとしても、効果はありません。

Dom\Notationオブジェクトが実際に持つ重要な情報（例えば、表記法の名前、公開識別子、システム識別子など）は、このtextContentプロパティではなく、nodeName、publicId、systemIdといった別のプロパティを通じてアクセスすることができます。このプロパティはPHP 8以降で利用可能な新しいDOM拡張機能の一部であり、XMLドキュメント構造をプログラムから操作する際に活用されます。Dom\NotationノードのtextContentプロパティは常に空文字列を返すという特性を理解しておくことが、正確なXML処理を行う上で重要です。

Copy
1<?php
2
3$dom = new DOMDocument();
4$dom->loadXML('<!DOCTYPE root [<!NOTATION gif SYSTEM "image/gif">]><root/>');
5
6$doctype = $dom->doctype;
7$notation = $doctype->notations->getNamedItem('gif');
8
9$content = $notation->textContent;
10
11?>

引数なし

引数はありません

string

textContent プロパティは、DOMノードに含まれるすべてのテキストコンテンツを連結した文字列を返します。