【PHP8.x】appendChildメソッドの使い方

appendChildメソッドの使い方について、初心者にもわかりやすく解説します。

作成日: 更新日:

基本的な使い方

appendChildメソッドは、DOMノードの末尾に新しい子ノードを追加するメソッドです。Dom\CDATASectionクラスに所属しており、このクラスのインスタンス(CDATAセクションノード)に対して使用します。

具体的には、appendChildメソッドは引数として渡されたノードを、CDATAセクションノードの最後の子ノードとして追加します。もし引数として渡されたノードがすでにドキュメント内に存在する場合、そのノードは現在の位置から削除され、新しい位置(CDATAセクションノードの末尾)に移動されます。

appendChildメソッドは、ノードの追加に成功した場合、追加されたノードを返します。もしエラーが発生した場合(例えば、引数がNodeインターフェースを実装していない場合)、nullを返します。

appendChildメソッドを使用することで、DOM構造を動的に変更できます。たとえば、CDATAセクションにテキストノードを追加したり、他の要素ノードを挿入したりすることが可能です。これにより、プログラムの実行中にXMLドキュメントの内容を柔軟に操作できます。

このメソッドは、DOMを操作する上で非常に重要な役割を果たします。XMLドキュメントの構造をプログラムで制御し、動的なコンテンツ生成やデータ操作を実現するために不可欠なメソッドです。特に、CDATAセクション内のコンテンツを動的に変更する際に、頻繁に使用されます。

構文(syntax)

1<?php
2
3$doc = new DOMDocument();
4$doc->loadXML("<root><![CDATA[example]]></root>");
5
6$cdata = $doc->documentElement->firstChild;
7
8$newText = $doc->createTextNode(" appended");
9$cdata->appendChild($newText);
10
11echo $doc->saveXML();
12
13?>

引数(parameters)

DOMNode $node

  • DOMNode $node: 追加する子ノードを指定するDOMNodeオブジェクト

戻り値(return)

Dom\Node

Dom\CDATASection::appendChild メソッドは、CDATAセクションに新しい子ノードを追加した結果として、追加された子ノード自身 (Dom\Node) を返します。

【PHP8.x】appendChildメソッドの使い方 | いっしー@Webエンジニア