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

Copy
1<?php
2
3/**
4 * Dom\CDATASection の nodeName プロパティの振る舞いを示します。
5 *
6 * CDATASection ノードの nodeName プロパティは常に '#cDATA-SECTION' を返します。
7 * これは、XML内でマークアップとして解釈させたくないテキストを表現する際に使用されます。
8 */
9function showCdataSectionNodeNameExample(): void
10{
11    // 新しい DOMDocument オブジェクトを作成します。
12    // これはXMLドキュメント全体を扱うためのコンテナとして機能します。
13    $dom = new DOMDocument('1.0', 'UTF-8');
14
15    // DOMDocument を使って CDATASection ノードを作成します。
16    // CDATASection は、特殊文字 (<, > & など) を含むテキストを
17    // XMLパーサーがマークアップとして扱わないようにするために使用されます。
18    $cdataSection = $dom->createCDATASection('これは <tag> や &amp; エンティティを含むRAWデータです。');
19
20    // 作成した Dom\CDATASection オブジェクトの nodeName プロパティにアクセスし、
21    // その値を出力します。
22    // このプロパティは、ノードの種類を示す固定の文字列を返します。
23    echo "Dom\\CDATASection の nodeName: " . $cdataSection->nodeName . PHP_EOL;
24}
25
26// 上記で定義した関数を実行し、CDATASection の nodeName の値を確認します。
27showCdataSectionNodeNameExample();

PHP 8 の Dom\CDATASection クラスの nodeName プロパティは、XMLドキュメント内の CDATASection ノードの種類を示すものです。CDATASection は、XMLパーサーが < や >、& といった特殊文字をマークアップとしてではなく、純粋なテキストデータとして扱いたい場合に使う特別なブロックです。

この nodeName プロパティは引数を取らず、常に固定の文字列 #cDATA-SECTION を戻り値として返します。これは、DOMツリー内で CDATASection ノードを識別するための値です。

サンプルコードでは、DOMDocument オブジェクトを使って特殊文字を含む CDATASection ノードを作成し、その nodeName プロパティを出力しています。実行すると「Dom\CDATASection の nodeName: #cDATA-SECTION」と表示され、CDATASection の nodeName が定義通り #cDATA-SECTION を返すことが確認できます。このプロパティは、XMLドキュメントを操作する際にノードの種類を判別する上で役立ちます。