萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP 生成 XML 時正確添加 CDATA 區塊的方法

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 內容特殊字元會被轉義(`<` → `&lt;`)必須用 `createCDATASection`
CDATA 內出現 `]]>`XML 解析錯誤切分為多個 CDATA:`]]>` → `]]>]]>`

處理包含 `]]>` 的內容工具函式

<?php
function createSafeCData(DOMDocument $dom, string $data): DOMCdataSection
{
    // 將 ]]> 替換為 ]]]]>
    $safe = str_replace(']]>', ']]]]>', $data);
    return $dom->createCDATASection($safe);
}
?>

永遠使用 `DOMDocument` 內建方法生成 XML,安全、標準、免維護。

copyright © 萬盛學電腦網 all rights reserved