Добавляет новый дочерний узел перед опорным узлом

public DOMNode DOMNode::insertBefore ( DOMNode $newnode [, DOMNode $refnode ] )

Данная функция вставляет новый узел перед опорным узлом. Чтобы дальше модифицировать добавляемый узел, необходимо использовать возвращаемый узел

newnode: Новый узел.
refnode: Опорный узел. Если отсутствует, то newnode добавляется в конец списка потомков.

Добавленный узел.

DOM_NO_MODIFICATION_ALLOWED_ERR: Возникает, если узел доступен только для чтения или предыдущий родитель вставляемого узла доступен только для чтения.
DOM_HIERARCHY_REQUEST_ERR: Возникает, если тип узла не поддерживает потомков типа, который имеет узел newnode, или же если добавляемый узел является предком целевого узла или им самим.
DOM_WRONG_DOCUMENT_ERR: Возникает, если newnode создан в другом документе, отличном от того, в котором был создан этот узел.
DOM_NOT_FOUND: Возникает, если refnode не является дочерним узлом данного узла.