array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'domdocument.replacechildren.php', 1 => 'DOMDocument::replaceChildren', 2 => 'Заменяет дочерние узлы в документе', ), 'up' => array ( 0 => 'class.domdocument.php', 1 => 'DOMDocument', ), 'prev' => array ( 0 => 'domdocument.relaxngvalidatesource.php', 1 => 'DOMDocument::relaxNGValidateSource', ), 'next' => array ( 0 => 'domdocument.save.php', 1 => 'DOMDocument::save', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ru', 'path' => 'reference/dom/domdocument/replacechildren.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

DOMDocument::replaceChildren

(PHP 8 >= 8.3.0)

DOMDocument::replaceChildren — Заменяет дочерние узлы в документе

Описание

public DOMDocument::replaceChildren(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 Пример использования метода DOMDocument::replaceChildren()

Замена дочерних узлов в документе новыми узлами.

<?php
$doc = new DOMDocument;
$doc->loadXML("<container><hello/></container>");

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

echo $doc->saveXML();
?>

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

<?xml version="1.0"?>
beautiful
<world/>

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