(PHP 8)
DOMDocument::prepend — 在第一個子節點之前新增節點
nodes要新增的節點。字串會自動轉換為文字節點。
不回傳任何值。
DOM_HIERARCHY_REQUEST_ERR如果此節點的類型不允許其中一個傳遞的 nodes 類型的子節點，或者如果要放入的節點是此節點的祖先或此節點本身，則會引發此錯誤。
DOM_WRONG_DOCUMENT_ERR如果傳入的 nodes 參數中，有任何一個節點是從與建立此節點不同的文件所建立的，則會引發此錯誤。
| 版本 | 說明 |
|---|---|
| 8.3.0 | 現在可以在沒有擁有者文件的節點上呼叫此方法。先前呼叫此方法會丟出代碼為 DOM_HIERARCHY_REQUEST_ERR 的 DOMException 例外。 |
範例 #1 DOMDocument::prepend() 範例
在文件根節點之前新增節點。
<?php
$doc = new DOMDocument;
$doc->loadXML("<world/>");
$doc->prepend($doc->createElement("hello"), "beautiful");
echo $doc->saveXML();
?>上述範例將輸出：
<?xml version="1.0"?> <hello/> beautiful <world/>