【PHP8.x】DOMCdataSection::removeChild()メソッドの使い方

Copy
1<?php
2
3/**
4 * DOMCdataSection::removeChild の使用例
5 *
6 * DOMCdataSection ノードはテキストデータを保持するノードであり、
7 * 子ノードを持つことができません。
8 * したがって、このメソッドを DOMCdataSection インスタンスに対して呼び出すと、
9 * 常に DOMException (DOM_NOT_FOUND_ERR) が発生します。
10 * このサンプルは、その振る舞いを示します。
11 */
12function demonstrateDomCdataSectionRemoveChild(): void
13{
14    // 新しい DOM ドキュメントを作成
15    $dom = new DOMDocument('1.0', 'UTF-8');
16    $dom->formatOutput = true; // 出力を見やすく整形
17
18    // ルート要素を作成し、ドキュメントに追加
19    $root = $dom->createElement('root');
20    $dom->appendChild($root);
21
22    // CDATAセクションノードを作成
23    // DOMCdataSection は DOMNode を継承していますが、自身は子ノードを持つことができません。
24    $cdataSection = $dom->createCDATASection('この内容は <XML> マークアップとして解釈されません');
25    
26    // CDATAセクションをルート要素の子として追加 (cdataSection は $root の子になります)
27    $root->appendChild($cdataSection);
28
29    echo "現在のXMLドキュメント:\n";
30    echo $dom->saveXML();
31    echo "\n";
32
33    // DOMCdataSection は子ノードを持てないため、removeChild は常に失敗します。
34    // 存在しない子ノードを渡して削除を試みます。
35    $nonExistentChild = $dom->createElement('fakeChild');
36
37    try {
38        // DOMCdataSection から子ノードを削除しようと試みる
39        // これは DOM_NOT_FOUND_ERR をスローします
40        echo "DOMCdataSection から子ノードを削除しようと試みます...\n";
41        $cdataSection->removeChild($nonExistentChild);
42        // 通常、この行には到達しません
43        echo "子ノードが削除されました (このメッセージが表示されることは稀です)。\n";
44    } catch (DOMException $e) {
45        // DOM_NOT_FOUND_ERR 例外を捕捉し、エラーメッセージと理由を出力
46        echo "エラーが発生しました: " . $e->getMessage() . "\n";
47        echo "理由: DOMCdataSection は子ノードを持つことができないため、removeChild() は常に失敗します。\n";
48    }
49}
50
51// 関数を実行
52demonstrateDomCdataSectionRemoveChild();

このサンプルコードは、PHPのDOM（Document Object Model）拡張機能におけるDOMCdataSection::removeChildメソッドの特殊な挙動を示しています。

PHPのDOM拡張機能は、XMLやHTMLドキュメントをオブジェクトとして扱い、その構造や内容をプログラムから操作するための機能を提供します。その中でDOMCdataSectionは、XMLドキュメント内で特殊なデータセクション（CDATAセクション）を表現するノードです。CDATAセクション内のテキストはXMLマークアップとして解釈されず、そのままの形でデータとして扱われます。

removeChildメソッドは、通常、親ノードから指定された子ノードを削除するために使用されます。引数には削除したいDOMNode型のノードを指定し、削除が成功するとその子ノードを返します。

しかし、DOMCdataSectionノードはテキストデータのみを保持する特殊なノードであり、自身が子ノードを持つことはできません。このため、DOMCdataSectionインスタンスに対してremoveChildメソッドを呼び出すと、たとえどのようなDOMNodeを引数として渡しても、削除対象の子ノードが見つからないというエラー（DOMExceptionのDOM_NOT_FOUND_ERR）が必ず発生します。

サンプルコードでは、DOMCdataSectionを作成し、そこから子ノードを削除しようと試みています。try-catchブロックを用いることで、この常に発生するDOMExceptionを捕捉し、エラーメッセージとその理由を出力することで、このメソッドの特性を明確に示しています。したがって、このメソッドはDOMCdataSectionに対しては通常、意味を持ちません。