[函数]DOMDocument::save()函数—用法及示例

函数名：DOMDocument::save()

适用版本：PHP 5, PHP 7

用法：DOMDocument::save() 用于将DOM文档保存到指定的文件中。

语法：bool DOMDocument::save ( string $filename [, int $options = 0 ] )

参数：

• filename：要保存的文件路径和名称。
• options（可选）：输出选项，可以是下列常量的组合：
  • LIBXML_NOEMPTYTAG：不生成空元素标签（只适用于XML格式）。
  • LIBXML_NOENT：不展开实体引用。
  • LIBXML_NOCDATA：将文本节点的CDATA节拆分为多个文本节点。
  • LIBXML_NOBLANKS：移除空白节点。
  • LIBXML_COMPACT：用于压缩输出。
  • LIBXML_NSCLEAN：将命名空间定义符从回退的默认名称空间中移除。

返回值：如果成功保存则返回 true，否则返回 false。

示例：

<?php
// 创建一个 DOMDocument 对象
$dom = new DOMDocument();

// 加载一个XML文档
$dom->load('example.xml');

// 在XML文档中添加一个新节点
$root = $dom->documentElement;
$newNode = $dom->createElement('book');
$root->appendChild($newNode);

// 保存XML文档到文件
$dom->save('new_example.xml');
?>

上述示例中，我们首先创建一个 DOMDocument 对象，并从文件 example.xml 中加载一个XML文档。然后我们在文档中添加一个名为 "book" 的新节点，并最后将修改后的文档保存到新的文件 new_example.xml 中。

请注意，DOMDocument::save() 方法还可以用于保存文档到数据流或字符串（通过将 filename 参数设置为 "php://output" 或 "php://memory" 等）。