萬盛學電腦網

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

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

CDATA 區塊作用

<![CDATA[ ... ]]> 讓 XML 解析器將內容視為純文本,不解析內部標籤、實體引用,適合包含 HTML、程式碼、特殊字符的資料欄位。

DOMDocument 正確建立 CDATA

<?php
$dom = new DOMDocument('1.0', 'UTF-8');
$dom->formatOutput = true; // 美化縮進

// 建立根元素
$root = $dom->createElement('toppings');
$dom->appendChild($root);

// 一般元素與屬性
$item = $dom->createElement('item');
$root->appendChild($item);

$text = $dom->createTextNode('pepperoni');
$item->appendChild($text);

$price = $dom->createAttribute('price');
$price->value = '4'; // 或 $price->appendChild($dom->createTextNode('4'));
$item->appendChild($price);

// 關鍵:createCDATASection 正確建立 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>

常見錯誤與修正

錯誤做法問題正確做法
$el->nodeValue = '<![CDATA[...]]>'實體會被轉義為 &lt;![CDATA[...]]&gt;使用 $dom->createCDATASection($data)
createTextNode() 包含 < > &自動轉義,破壞原始結構內含標籤/代碼必須用 CDATA
手動拼接 XML 字串極易產生格式錯誤、編碼問題、注入風險始終使用 DOMDocument/XMLWriter

XMLWriter 替代方案 (流式、低記憶體)

<?php
$writer = new XMLWriter();
$writer->openMemory();
$writer->setIndent(true);
$writer->startDocument('1.0', 'UTF-8');
$writer->startElement('toppings');

$writer->startElement('item');
$writer->writeAttribute('price', '4');
$writer->text('pepperoni');
$writer->endElement(); // item

$writer->writeCdata(' Customer requests that pizza be sliced into 16 square pieces ');
$writer->writePi('pizza', 'bake()');

$writer->endElement(); // toppings
$writer->endDocument();

header('Content-Type: application/xml; charset=UTF-8');
echo $writer->outputMemory();

大數據量 XML 生成最佳實踐

  • 使用 XMLWriter 流式寫入,避免 DOM 佔用大量記憶體。
  • 分批 flush() 輸出至瀏覽器或檔案:$writer->flush() (需 openUri)。
  • 關閉 formatOutput 節省 CPU/頻寬,必要時由下游格式化。
  • 嚴格驗證輸入資料編碼為 UTF-8,mb_check_encoding() 或 iconv() 強制轉換。

核心原則:永不手工拼接 XML,使用 DOMDocument (小/中文檔) 或 XMLWriter (大文檔/流式),CDATA 必須用 createCDATASection()/writeCdata() 建立。

copyright © 萬盛學電腦網 all rights reserved