XMLWriter 是 PHP 内置流式 XML 生成器,内存占用低、性能好,仅顺序写入不解析;支持字符串缓冲或文件直写,自动转义特殊字符,需手动管理标签开闭与错误检查。

XMLWriter 是 PHP 内置的流式 XML 生成器,适合处理大文件或需边写边输出的场景,内存占用低、性能好。它不解析 XML,只按顺序写入标签、属性、文本,因此不能回退或修改已写内容。
初始化与基础写入
创建 XMLWriter 实例后,需先打开输出目标(字符串或文件),再开始写结构:
- 用 openMemory() 写入字符串缓冲区,适合小量数据或后续处理
- 用 openURI('file.xml') 直接写入文件,适合大文件生成
- 调用 startDocument() 声明 XML 版本和编码(如 UTF-8)
- 用 startElement() 和 endElement() 成对写标签,自动缩进需手动控制(XMLWriter 不自动格式化)
写元素、属性与文本内容
元素内容分三类:纯文本、带属性的标签、嵌套结构。注意写入顺序必须合法(先开标签,再写内容,最后闭合):
-
writeElement('name', 'Alice') —— 一次性写闭合标签,等价于
Alice - startElement('user') + writeAttribute('id', '123') + text('John') + endElement() —— 写带属性的非空标签
- writeRaw('') 可插入 CDATA 段,但需确保内容不破坏结构
处理嵌套与特殊字符
嵌套靠 start/end 元素自然实现;所有文本和属性值默认自动转义(, &, ", '),无需手动 htmlspecialchars:
立即学习“PHP免费学习笔记(深入)”;
- 写
,直接传5 & 3 text('5 & 3')即可,XMLWriter 自动转为& - 若需写原始 XML 片段(如已有格式化子树),用 writeRaw(),但要确保合法且不破坏上下文
- 避免在未闭合元素内调用 flush() 或切换输出目标,否则会出错
错误处理与关闭
XMLWriter 错误通常静默失败,建议检查返回值并配合 libxml_get_errors():
- 每个方法(如 startElement)失败返回 false,应判断并记录
- 写完调用 flush()(对文件无效,仅对内存有效)或直接销毁对象
- 用 endDocument() 显式结束(非必须,但推荐);对象析构时会自动清理资源
- 生成文件后,可用 simplexml_load_file() 快速验证是否格式正确










