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

『appendメソッドは、既存のDOMElementオブジェクトの子ノードリストの最後に、新たなノードや文字列を追加する処理を実行するメソッドです。このメソッドの主な特徴は、一度の呼び出しで複数のノードや文字列を引数として渡し、まとめて追加できる点にあります。引数には、DOMNodeオブジェクトだけでなく、通常の文字列も直接指定することが可能です。文字列を渡した場合、その文字列を内容とするDOMTextノードが内部で自動的に作成され、対象要素の最後の子ノードとして挿入されます。これにより、テキストノードを別途生成する手間を省くことができます。複数のノードや文字列を追加したい場合は、引数をカンマで区切って渡します。このメソッドは戻り値を返さず、呼び出し元のDOMElementオブジェクトの状態を直接変更します。従来のappendChildメソッドが一度に一つのノードしか追加できなかったのに対し、appendメソッドはより直感的かつ効率的にDOMツリーを構築する手段を提供します。

Copy
1<?php
2
3// DOMDocumentオブジェクトとルート要素を作成します
4$doc = new DOMDocument('1.0', 'UTF-8');
5$list = $doc->createElement('list');
6
7// list要素に、新しい要素とテキストノードを一度に追加します
8$item1 = $doc->createElement('item', 'Apple');
9$item2 = $doc->createElement('item', 'Orange');
10$list->append($item1, $item2, 'and more fruits...');
11
12$doc->appendChild($list);
13
14// 生成されたXMLを出力します
15echo $doc->saveXML();
16
17/*
18出力結果:
19
20<?xml version="1.0" encoding="UTF-8"?>
21<list><item>Apple</item><item>Orange</item>and more fruits...</list>
22
23*/

DOMNode|string ...$nodes

• DOMNode|string $nodes: 追加するノードまたは文字列。可変長引数。

void

このメソッドは、指定されたノードを現在の要素の末尾に追加します。処理が成功しても、明示的な戻り値はありません。