函数: DOMDocument::createCDATASection()
适用版本: PHP 5, PHP 7, PHP 8
描述: createCDATASection()
方法创建一个 CDATA 部分(不解析标签)。
语法: DOMDocument->createCDATASection(string $data): DOMCDATASection|false
参数:
- $data: CDATA 部分的内容。
返回值:
- 成功时返回一个 DOMCDATASection 对象,表示创建的 CDATA 部分。
- 失败时返回 false。
示例:
// 创建一个新的 DOM 文档
$doc = new DOMDocument();
// 创建一个 CDATA 部分
$cdata = $doc->createCDATASection('This is some <![CDATA[<b>bold</b>]]> text.');
// 将 CDATA 部分添加到 XML 文档中的元素
$element = $doc->createElement('foo');
$element->appendChild($cdata);
$doc->appendChild($element);
// 输出 XML
echo $doc->saveXML();
输出:
<?xml version="1.0"?>
<foo><![CDATA[This is some <![CDATA[<b>bold</b>]]> text.]]></foo>
注意事项:
- CDATA 部分不会被解析为标签,所以其中的 HTML 标签也会被原样显示。
- 在 XML 文档中,CDATA 部分用于包含特殊字符,如
<
,>
, 和&
,以避免与标记冲突。 - 使用
saveXML()
方法可以将 DOM 文档保存为 XML 字符串。 - 如果创建 CDATA 部分失败,
createCDATASection()
方法会返回 false。