PHP Conference Japan 2024

    DOMNode::appendChild

    (PHP 5, PHP 7, PHP 8)

    DOMNode::appendChild — 在子节点的末尾添加新的子节点

    描述

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

    此函数将子节点附加到现有的子节点列表中，或创建一个新的子节点列表。可以使用例如 DOMDocument::createElement()、DOMDocument::createTextNode() 等创建子节点，或者简单地使用任何其他节点。

    使用现有节点时，它将被移动。

    参数

    node

    附加的子节点。

    返回值

    添加的节点或发生错误时为 false。

    错误/异常

    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();
    ?>

    参见

    发现问题？

    了解如何改进此页面 • 提交拉取请求 • 报告错误
    ＋添加注释

    用户贡献的注释 4 条注释

    19
    krisdover at hotmail dot com
    16 年前
    这里没有提到的是，DOMNode::appendChild() 也可以用来将现有的节点移动到 DOMDocument 的另一个部分，例如

    <?php
    $doc     = new DOMDocument();
    $doc->loadXML("<foobar><bar/><foo/></foobar>");
    $bar = $doc->documentElement->firstChild;
    $foo = $doc->documentElement->lastChild;
    $foo->appendChild($bar);
    print     $doc->saveXML();
    ?>

    这将生成

    <?xml version="1.0"?>
    <foobar><foo><bar/></foo></foobar>

    请注意，节点 "<foo/>" 和 "<bar/>" 是兄弟节点，即 "<foobar>" 的第一个和最后一个子节点，但使用 appendChild() 我们能够移动 "<bar/>" 使其成为 "<foo/>" 的子节点。

    这可以避免您在将 "<bar/>" 附加为 "<foo/>" 的子节点之前执行 DOMNode::removeChild($bar) 来删除 "<bar/>" 的麻烦。

    Kris Dover
    8
    cweiske at php dot net
    7 年前
    如果您想将一个节点的子节点移动到另一个节点，您不能简单地迭代 $element->childNodes - 您必须首先创建一个数组

    <?php
    $children     = [];
    foreach (    $elemWithChildren->childNodes as $child) {
    $children[] = $child;
    }
    foreach (    $children as $child) {
    $targetElement->appendChild($child);
    }
    ?>
    3
    frame at dynamiccreated dot de
    14 年前
    注意处理 DOMNodeList 和同一个节点上的 appendChild()。

    如果您只想替换子节点而不是 DOMElement 本身，您可能需要使用 foreach childNodes 属性或使用 for 循环和 DOMNodeList 的 item() 方法获取 DOMElements。

    如果您不克隆接收到的单个 DOMElement，则会失败。实际上，DOMNodelist 的数量在 appendChild 数量上会减少，但 appendChild 似乎引用了旧的 Nodelist，并且不会发生任何可见的变化。克隆将有所帮助。
    3
    jrtayloriv at gmail dot com
    16 年前
    如果您想创建嵌套的 DOM 元素

    <?php
    $doc     = new DOMDocument();

    $foo = $doc->createElement("foo");
    $doc->appendChild($foo);

    $bar = $doc->createElement("bar");
    $foo->appendChild($bar);

    $bazz = $doc->createElement("bazz");
    $foo->appendChild($bazz);

    echo     $doc->saveXML();
    ?>

    等价于

    <foo>
    <bar></bar>
    <bazz></bazz>
    </foo>
    ＋添加注释
    To Top