PHP中如何使用DOMDocument创建XML

在PHP开发中，生成XML文件是数据交互、配置文件存储等场景下的常见需求，DOMDocument作为PHP内置的XML处理扩展，提供了面向对象的操作方式，能够灵活创建结构化的XML文档。

DOMDocument基础准备

使用DOMDocument前需要确认PHP环境已经开启DOM扩展，大部分默认的PHP环境都会默认开启该扩展，无需额外配置。DOMDocument的核心能力是通过节点操作构建XML的树形结构，每个XML元素、属性、文本内容都对应一个节点对象。

创建XML的基本步骤

1. 初始化DOMDocument对象

首先需要实例化DOMDocument类，指定XML的版本和编码格式，这是生成标准XML文件的基础。

<?php
// 初始化DOMDocument对象，指定XML版本为1.0，编码为UTF-8
$dom = new DOMDocument('1.0', 'UTF-8');
// 设置格式化输出，生成的XML会有缩进，方便阅读
$dom->formatOutput = true;
?>

2. 创建根节点

XML文档必须有且仅有一个根节点，通过createElement方法创建元素节点，再通过appendChild方法将根节点添加到文档中。

<?php
// 创建根节点book_store
$root = $dom->createElement('book_store');
// 将根节点添加到DOM文档中
$dom->appendChild($root);
?>

3. 添加子节点与文本内容

可以在根节点下添加多层子节点，同时给节点添加文本内容，文本内容需要通过createTextNode方法创建，避免特殊字符导致的XML格式错误。

<?php
// 创建第一个book子节点
$book1 = $dom->createElement('book');
// 创建book下的title子节点并添加文本
$title1 = $dom->createElement('title');
$titleText1 = $dom->createTextNode('PHP从入门到精通');
$title1->appendChild($titleText1);
$book1->appendChild($title1);

// 创建book下的price子节点并添加文本
$price1 = $dom->createElement('price');
$priceText1 = $dom->createTextNode('89.00');
$price1->appendChild($priceText1);
$book1->appendChild($price1);

// 将book1添加到根节点
$root->appendChild($book1);
?>

4. 给节点添加属性

如果需要给XML节点添加属性，可以使用createAttribute方法创建属性节点，设置属性值后添加到对应的元素节点上。

<?php
// 给book1节点添加id属性
$idAttr = $dom->createAttribute('id');
$idAttr->value = 'b001';
$book1->appendChild($idAttr);
?>

5. 输出或保存XML

完成节点构建后，可以通过saveXML方法输出XML字符串，或者通过save方法将XML保存到文件中。

<?php
// 输出XML字符串
echo $dom->saveXML();

// 保存到文件，路径为当前目录下的book_store.xml
$dom->save('book_store.xml');
?>

完整示例代码

以下是一个完整的创建包含多本书信息的XML文件的示例，生成的XML结构清晰，符合规范。

<?php
$dom = new DOMDocument('1.0', 'UTF-8');
$dom->formatOutput = true;

// 创建根节点
$root = $dom->createElement('book_store');
$dom->appendChild($root);

// 第一本书
$book1 = $dom->createElement('book');
$idAttr1 = $dom->createAttribute('id');
$idAttr1->value = 'b001';
$book1->appendChild($idAttr1);

$title1 = $dom->createElement('title');
$titleText1 = $dom->createTextNode('PHP从入门到精通');
$title1->appendChild($titleText1);
$book1->appendChild($title1);

$price1 = $dom->createElement('price');
$priceText1 = $dom->createTextNode('89.00');
$price1->appendChild($priceText1);
$book1->appendChild($price1);

$root->appendChild($book1);

// 第二本书
$book2 = $dom->createElement('book');
$idAttr2 = $dom->createAttribute('id');
$idAttr2->value = 'b002';
$book2->appendChild($idAttr2);

$title2 = $dom->createElement('title');
$titleText2 = $dom->createTextNode('XML基础教程');
$title2->appendChild($titleText2);
$book2->appendChild($title2);

$price2 = $dom->createElement('price');
$priceText2 = $dom->createTextNode('59.00');
$price2->appendChild($priceText2);
$book2->appendChild($price2);

$root->appendChild($book2);

// 输出XML
echo $dom->saveXML();
// 可选：保存到文件
// $dom->save('book_store.xml');
?>

注意事项

• 文本内容如果包含<、>、&等XML特殊字符，必须使用createTextNode方法创建，DOMDocument会自动进行转义，避免XML格式错误。
• 如果不需要格式化输出，可以将formatOutput设置为false，生成的XML会压缩为一行，减少文件体积。
• 创建属性时，属性值如果包含特殊字符，同样会被自动转义，无需手动处理。

PHPDOMDocumentXMLcreateElement修改时间：2026-07-12 13:18:28