函式: 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。