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

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

作成日: 2025年09月11日更新日: 2025年11月09日

基本的な使い方

appendメソッドは、PHP 8のDom\XMLDocumentクラスに属し、XMLドキュメントにDOMノードを子ノードとして追加するメソッドです。このメソッドは、XML文書の構造をプログラム上で動的に構築したり、既存の文書を変更したりする際に中心的な役割を果たします。

具体的には、引数として渡されたDom\Nodeオブジェクト（例えば、新しいXML要素を表すDom\Elementオブジェクトや、テキストコンテンツを表すDom\Textオブジェクトなど）を、現在のDom\XMLDocumentオブジェクトの子ノードリストの末尾に挿入します。これにより、XML文書のルートに新しい要素を追加したり、既存の要素内にさらに子要素やテキストコンテンツを組み込んだりすることが可能になります。

XML文書は、要素や属性、テキストといった「ノード」と呼ばれる部品で構成されており、appendメソッドはこれらのノードを文書ツリーの適切な位置に配置するための基本的な操作手段を提供します。データの動的な生成、Webサービスの応答作成、設定ファイルの操作など、XMLをプログラムで扱う多岐にわたる場面で利用されます。文書の構造を正確かつ効率的に管理するために不可欠な機能です。

構文(syntax)


1<?php
2$document = new Dom\XMLDocument('1.0', 'UTF-8');
3$elementToAdd = $document->createElement('rootElement');
4$document->append($elementToAdd);

引数(parameters)

Dom\Node|string $nodes = null

Dom\Node|string $nodes = null: 追加するノードまたはXML文字列。省略可能で、省略した場合は何も追加されません。

戻り値(return)

Dom\Node

このメソッドは、指定したノードを現在のノードの子ノードリストの末尾に追加します。追加されたノード自身を返します。