(PHP 5, PHP 7, PHP 8)
DOMNode::appendChild — 子要素群の最後に新しい子要素を追加する
この関数は、既存の子要素のリストに新しい子要素を追加するか、 あるいは新しい子要素リストを作成します。子要素の作成には DOMDocument::createElement()、 DOMDocument::createTextNode() などを使用するか、単に別のノードを使用します。
既存のノードを使う場合、そのノードは移動します。
node追加する子要素。
追加したノードを返します。
エラーの場合は false を返します。
以下のエラーコードで DOMException をスローします:
DOM_NO_MODIFICATION_ALLOWED_ERRノードが読み込み専用であったり、挿入するノードの以前の親が 読み込み専用であったりした場合に発生します。
DOM_HIERARCHY_REQUEST_ERR
node で指定した型の子ノードを
保持することが許可されていない場合、あるいは追加しようとしている
ノードが自分自身やその祖先であった場合に発生します。
DOM_WRONG_DOCUMENT_ERR
node が、このノードとは別の
ドキュメントで作成されたものである場合に発生します。
以下の例は、新しいドキュメントに新しい要素を追加します。
例1 子要素の追加
<?php
$doc = new DOMDocument;
$node = $doc->createElement("para");
$newnode = $doc->appendChild($node);
echo $doc->saveXML();
?>
例2 ネストされた子ノード
<?php
$doc = new DOMDocument;
$headNode = $doc->createElement("head");
$doc->appendChild($headNode);
$titleNode = $doc->createElement("title");
$headNode->appendChild($titleNode);
echo $doc->saveXML();
?>