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

# DOMNode::appendChild

(PHP 5, PHP 7, PHP 8)

DOMNode::appendChild — Добавляет новый дочерний узел в конец списка потомков

### Описание

public function DOMNode::appendChild(DOMNode `$node`): DOMNode|false

Функция добавляет дочерний узел в существующий список потомков или создаёт новый список дочерних элементов. Дочерний узел может быть создан с помощью 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();
    ?>

### Смотрите также

- DOMChildNode::after() - Добавляет узлы после узла
- DOMNode::insertBefore() - Добавляет новый дочерний узел перед указанным узлом
- DOMNode::removeChild() - Удаляет дочерний узел из списка потомков
- DOMNode::replaceChild() - Заменяет дочерний узел

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open