XML 中包含特殊字元(`<` `>` `&` `'` `"`)或需保留原始格式(HTML 片段、程式碼)時,必須使用 `` 區塊。PHP `DOMDocument` 提供原生 `createCDATASection()` 方法,切勿手工拼接字串。
<?php
$dom = new DOMDocument('1.0', 'UTF-8');
$dom->formatOutput = true;
$root = $dom->createElement('toppings');
$dom->appendChild($root);
// 普通文字節點(自動轉義)
$item = $dom->createElement('item', 'pepperoni');
$root->appendChild($item);
// 屬性
$attr = $dom->createAttribute('price');
$attr->value = '4';
$item->appendChild($attr);
// CDATA 區塊:內容不被解析,可包含任意字元
$cdata = $dom->createCDATASection(' Customer requests that pizza be sliced into 16 square pieces ');
$root->appendChild($cdata);
// Processing Instruction
$pi = $dom->createProcessingInstruction('pizza', 'bake()');
$root->appendChild($pi);
header('Content-Type: application/xml; charset=UTF-8');
echo $dom->saveXML();
?>
<?xml version="1.0" encoding="UTF-8"?> <toppings> <item price="4">pepperoni</item> <![CDATA[ Customer requests that pizza be sliced into 16 square pieces ]]> <?pizza bake()?> </toppings>
| 錯誤做法 | 後果 | 正確做法 |
|---|---|---|
| 字串拼接 `` | $text 含 `]]>` 會破壞結構,且未處理編碼 | `$dom->createCDATASection($text)` |
| 用 `createTextNode` 放入 CDATA 內容 | 特殊字元會被轉義(`<` → `<`) | 必須用 `createCDATASection` |
| CDATA 內出現 `]]>` | XML 解析錯誤 | 切分為多個 CDATA:`]]>` → `]]>]]>` |
<?php
function createSafeCData(DOMDocument $dom, string $data): DOMCdataSection
{
// 將 ]]> 替換為 ]]]]>
$safe = str_replace(']]>', ']]]]>', $data);
return $dom->createCDATASection($safe);
}
?>
永遠使用 `DOMDocument` 內建方法生成 XML,安全、標準、免維護。