Edit Report a Bug

    DOMDocumentFragment::append

    (PHP 8)

    DOMDocumentFragment::append — Добавляет узлы после последнего дочернего узла

    Описание

    public DOMDocumentFragment::append(DOMNode|string ...$nodes): void

    Добавляет один или несколько узлов nodes в список дочерних узлов после последнего дочернего узла.

    Список параметров

    nodes

    Узлы, которые необходимо добавить. Строки автоматически преобразуются в текстовые узлы.

    Возвращаемые значения

    Функция не возвращает значения после выполнения.

    Ошибки

    DOM_HIERARCHY_REQUEST_ERR

    Возникает, если тип одного из переданных в параметре nodes элементов не допускается в типе узла, или если добавляемый узел является одним из предков этого узла или самим этим узлом.

    DOM_WRONG_DOCUMENT_ERR

    Возникает, если один из переданных в параметре nodes элементов был создан из документа, отличного от того, в котором был создан этот узел.

    Список изменений

    Версия Описание
    8.3.0 Вызов этого метода на узле без документа владельца теперь работает. Ранее это выбрасывало исключение DOMException с кодом DOM_HIERARCHY_REQUEST_ERR.

    Примеры

    Пример #1 Пример использования метода DOMDocumentFragment::append()

    Добавление узлов в фрагмент.

    <?php
    $doc     = new DOMDocument;
    $fragment = $doc->createDocumentFragment();
    $fragment->appendChild($doc->createElement("hello"));

    $fragment->append("beautiful", $doc->createElement("world"));

    echo     $doc->saveXML($fragment);
    ?>

    Результат выполнения приведённого примера: 

    <hello/>beautiful<world/>

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

    add a note add a note

    User Contributed Notes

    There are no user contributed notes for this page.
    To Top