函数名: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" 等)。