Учебник PHP
DomNode->append_child
(unknown)
DomNode->append_child - добавляет нового потомка/child в конец списка потомков.
Описание
object DomNode->append_child (object newnode)
Эта функция присоединяет потомка к списку потомков или создаёт новый список. Потомок может быть создан, например, функцией DomDocument_create_element(), DomDocument_create_text() etc. или просто путём использования другого узла.
Перед присоединением потомок сначала дублируется. Следовательно, новый
потомок является совершенно новой копией, которая может изменяться без влияния
на узел, который был передан этой функции. Если передаваемый узел сам имеет
потомков, они также продублируются, что позволяет довольно легко дублировать большие части xml-документа.
return-значение это присоединённый потомок. Если вы планируете в дальнейшем
модифицировать присоединённый потомок, вы обязаны использовать возвращаемый узел.
В следующем примере узел нового элемента добавляется в документ, и атрибут "align" получает значение "left".
