XMLWriter 是轻量高效 XML 生成器,需先 openMemory() 或 openURI(),再 startDocument(),元素须 startElement() 与 endElement() 成对,属性用 writeAttribute(),文本用 writeElement() 或 text(),CDATA 用 writeCData(),循环嵌套注意层级匹配,最后 outputMemory() 输出。

PHP 的 XMLWriter 是一个轻量、高效、面向对象的 XML 生成器,适合动态构建结构清晰的 XML 文档(比如 RSS、配置文件、API 响应等),不依赖 DOM 或 SimpleXML,内存占用低,流式写入。
初始化与基础写入
创建实例后,需先打开内存或文件输出,再开始写入元素:
- 用
new XMLWriter()实例化对象 - 调用
openMemory()写入字符串(推荐调试和小数据) - 或用
openURI('file.xml')直接写入文件 - 必须调用
startDocument()开始文档(可指定版本、编码) - 每个
startElement()需配对endElement(),类似 HTML 标签闭合
示例:
$xml = new XMLWriter();
$xml->openMemory();
$xml->startDocument('1.0', 'UTF-8');
$xml->startElement('book');
$xml->writeAttribute('id', '101');
$xml->writeElement('title', 'PHP 入门');
$xml->writeElement('author', '张三');
$xml->endElement(); // 关闭 book
echo $xml->outputMemory(); // 输出字符串
写入属性、文本与 CDATA
属性用 writeAttribute(),只能在 startElement() 后立即调用;普通文本内容用 writeElement()(自动转义)或 text()(在已开启的元素内写纯文本);需要保留特殊字符(如 HTML 片段)时,用 writeCData()。
立即学习“PHP免费学习笔记(深入)”;
-
writeElement('tag', 'value'):一步写闭合标签(含转义) -
startElement('tag'); text('value'); endElement():适合多步操作(如嵌套) -
writeCData(':生成加粗
')加粗]]>
嵌套结构与循环生成
生成列表、树形结构时,靠多次 startElement / endElement 嵌套。循环中注意层级匹配,避免遗漏 endElement()。
- 外层用
startElement('books') - 循环内每次写
startElement('book')→ 写子元素 →endElement() - 可用变量控制是否写某字段(如空 author 不输出)
示例片段:
$xml->startElement('books');
foreach ($data as $item) {
$xml->startElement('book');
$xml->writeAttribute('status', $item['published'] ? 'yes' : 'no');
$xml->writeElement('title', htmlspecialchars($item['name']));
if (!empty($item['desc'])) {
$xml->writeElement('description', $item['desc']);
}
$xml->endElement(); // book
}
$xml->endElement(); // books
输出与清理
写完后,建议显式调用 endDocument()(非必须但更规范)。输出方式取决于初始化方式:
-
outputMemory(true):返回字符串并清空内存缓冲 -
flush():仅用于文件输出,强制写入磁盘 - 若用
openURI(),无需手动获取内容,文件已生成 - 对象可复用:调用
flush()+startDocument()可写新文档
不复杂但容易忽略细节,关键是保持 start/end 成对、属性紧跟 start、文本内容注意转义需求。











