PHP DOMDocument怎么创建和插入一个新节点

PHP的DOMDocument类是实现XML和HTML文档操作的核心工具，通过它可以动态创建、修改文档的节点结构，其中创建和插入新节点是最基础也最常用的操作场景。

核心方法说明

DOMDocument提供了多个用于创建和插入节点的方法，以下是常用的几个核心函数：

• createElement：用于创建一个新的元素节点，参数是元素名称，返回对应的DOMElement对象。
• createTextNode：用于创建一个文本节点，参数是文本内容，返回DOMText对象。
• appendChild：将新节点追加到指定父节点的子节点列表末尾。
• insertBefore：将新节点插入到指定父节点的某个已有子节点之前。

创建新节点的基本操作

创建元素节点和文本节点

首先需要初始化DOMDocument对象，然后调用对应的创建方法生成节点，以下是基础示例：

<?php
// 初始化DOMDocument对象，设置编码为UTF-8
$dom = new DOMDocument('1.0', 'UTF-8');

// 创建根节点html
$htmlNode = $dom->createElement('html');
// 将根节点添加到文档中
$dom->appendChild($htmlNode);

// 创建head元素节点
$headNode = $dom->createElement('head');
// 创建title元素节点
$titleNode = $dom->createElement('title');
// 创建title的文本内容节点
$titleText = $dom->createTextNode('DOMDocument节点操作示例');
// 将文本节点添加到title节点中
$titleNode->appendChild($titleText);
// 将title节点添加到head节点中
$headNode->appendChild($titleNode);
// 将head节点添加到html根节点中
$htmlNode->appendChild($headNode);

// 输出当前文档结构
echo $dom->saveHTML();
?>

创建带属性的节点

如果需要给创建的元素节点添加属性，可以使用setAttribute方法，示例如下：

<?php
$dom = new DOMDocument('1.0', 'UTF-8');
// 创建div元素节点
$divNode = $dom->createElement('div');
// 给div节点添加class属性
$divNode->setAttribute('class', 'content');
// 给div节点添加id属性
$divNode->setAttribute('id', 'main');
// 创建div的文本内容
$divText = $dom->createTextNode('这是一个带属性的div节点');
$divNode->appendChild($divText);

$dom->appendChild($divNode);
echo $dom->saveHTML();
?>

插入新节点的不同场景

追加到父节点末尾

使用appendChild方法可以将新节点追加到父节点的子节点列表最后，这是最常用的插入方式：

<?php
$dom = new DOMDocument('1.0', 'UTF-8');
// 加载已有的HTML字符串
$html = '<div id="parent"><p>第一个子节点</p></div>';
$dom->loadHTML($html, LIBXML_HTML_NOIMPLIED | LIBXML_HTML_NODEFDTD);

// 获取父节点
$parentNode = $dom->getElementById('parent');
// 创建新的p元素节点
$newP = $dom->createElement('p');
$newPText = $dom->createTextNode('追加的新子节点');
$newP->appendChild($newPText);

// 将新节点追加到父节点末尾
$parentNode->appendChild($newP);

echo $dom->saveHTML();
?>

插入到指定节点之前

如果需要将新节点插入到某个已有节点之前，可以使用insertBefore方法，该方法需要两个参数，第一个是新节点，第二个是参考节点：

<?php
$dom = new DOMDocument('1.0', 'UTF-8');
$html = '<div id="parent"><p id="ref">参考节点</p></div>';
$dom->loadHTML($html, LIBXML_HTML_NOIMPLIED | LIBXML_HTML_NODEFDTD);

$parentNode = $dom->getElementById('parent');
// 获取参考节点
$refNode = $dom->getElementById('ref');
// 创建新的p元素节点
$newP = $dom->createElement('p');
$newPText = $dom->createTextNode('插入到参考节点之前的新节点');
$newP->appendChild($newPText);

// 将新节点插入到参考节点之前
$parentNode->insertBefore($newP, $refNode);

echo $dom->saveHTML();
?>

完整操作示例

以下是一个完整的示例，演示从创建文档到插入多个不同类型节点的完整流程：

<?php
$dom = new DOMDocument('1.0', 'UTF-8');
// 创建根节点
$root = $dom->createElement('bookstore');
$dom->appendChild($root);

// 创建第一个book节点
$book1 = $dom->createElement('book');
$book1->setAttribute('category', '编程');
// 创建book的子节点title
$title1 = $dom->createElement('title');
$title1Text = $dom->createTextNode('PHP高级编程');
$title1->appendChild($title1Text);
$book1->appendChild($title1);
// 创建book的子节点author
$author1 = $dom->createElement('author');
$author1Text = $dom->createTextNode('张三');
$author1->appendChild($author1Text);
$book1->appendChild($author1);
$root->appendChild($book1);

// 创建第二个book节点，插入到第一个book之前
$book2 = $dom->createElement('book');
$book2->setAttribute('category', '前端');
$title2 = $dom->createElement('title');
$title2Text = $dom->createTextNode('HTML5实战');
$title2->appendChild($title2Text);
$book2->appendChild($title2);
$root->insertBefore($book2, $book1);

// 格式化输出文档
$dom->formatOutput = true;
echo $dom->saveXML();
?>

注意事项

• 创建节点后必须将其添加到文档的节点树中，否则节点不会被包含在最终输出的文档里。
• 使用loadHTML方法加载HTML内容时，建议添加LIBXML_HTML_NOIMPLIED | LIBXML_HTML_NODEFDTD参数，避免自动添加html、body等冗余标签。
• 操作完成后如果需要输出HTML内容，使用saveHTML方法，如果需要输出XML格式内容，使用saveXML方法。
• 如果插入的节点已经存在于文档树中，会先将该节点从原位置移除，再插入到新位置，不会重复创建节点。

PHPDOMDocumentcreateElementappendChildinsertBefore修改时间：2026-07-07 15:30:37