XML 仍是系統整合、API 介接、資料匯出的常用格式。PHP 提供多種生成 XML 的方式,各有優缺點。本文完整示範四種方法:字串拼接、DOMDocument、XMLWriter、SimpleXML,並附效能、記憶體、適用場景比較。
<?php
$data = [
['title' => 'title1', 'content' => 'content1', 'pubdate' => '2009-10-11'],
['title' => 'title2', 'content' => 'content2', 'pubdate' => '2009-11-11'],
];
$attr = ['title' => ['size' => 1]]; // title 元素的 size 屬性
?>
<?php
function buildXmlString(array $data, array $attr): string {
$xml = '' . "\n";
$xml .= '' . "\n";
foreach ($data as $item) {
$xml .= ' - ' . "\n";
foreach ($item as $key => $val) {
$xml .= ' <' . $key . '>';
// 必須手動編碼實體!
$xml .= htmlspecialchars($val, ENT_QUOTES | ENT_XML1, 'UTF-8');
$xml .= '' . $key . '>' . "\n";
}
// 屬性處理需自行拼接
if (isset($attr['title'])) {
// 這裡示範在 title 元素加屬性,字串拼接較繁瑣
}
$xml .= '
' . "\n";
}
$xml .= ' ';
return $xml;
}
echo buildXmlString($data, $attr);
?>
優點:無依賴、記憶體占用最低 (流式輸出)、速度最快。
缺點:極易產生格式錯誤 XML (未閉合標籤、實體未編碼、屬性未轉義)、維護困難、無結構驗證。
<?php
$dom = new DOMDocument('1.0', 'utf-8');
$dom->formatOutput = true; // 美化縮排
$article = $dom->createElement('article');
$dom->appendChild($article);
foreach ($data as $itemData) {
$item = $dom->createElement('item');
$article->appendChild($item);
foreach ($itemData as $key => $val) {
$elem = $dom->createElement($key);
$item->appendChild($elem);
$text = $dom->createTextNode($val); // 自動處理實體編碼!
$elem->appendChild($text);
// 處理屬性
if (isset($attr[$key])) {
foreach ($attr[$key] as $aKey => $aVal) {
$attrNode = $dom->createAttribute($aKey);
$attrNode->value = $aVal; // 或用 appendChild(createTextNode())
$elem->appendChild($attrNode);
}
}
}
}
echo $dom->saveXML();
// 或存檔:$dom->save('output.xml');
?>
優點:標準合規、自動實體編碼、支援 XPath、XSchema 驗證、XSLT 轉換、命名空間、CDATA、載入既有 XML 修改。
缺點:需將整棵樹載入記憶體,大檔案 (>50MB) 易 OOM。
<?php
$writer = new XMLWriter();
$writer->openUri('php://output'); // 或檔案路徑 'output.xml'
$writer->setIndent(true);
$writer->setIndentString(' ');
$writer->startDocument('1.0', 'UTF-8');
$writer->startElement('article');
foreach ($data as $itemData) {
$writer->startElement('item');
foreach ($itemData as $key => $val) {
$writer->startElement($key);
if (isset($attr[$key])) {
foreach ($attr[$key] as $aKey => $aVal) {
$writer->writeAttribute($aKey, $aVal);
}
}
$writer->text($val); // 自動實體編碼
$writer->endElement(); // $key
}
$writer->endElement(); // item
}
$writer->endElement(); // article
$writer->endDocument();
$writer->flush(); // 刷新輸出
?>
優點:流式寫入,記憶體恆定 (適合大檔案)、速度極快、API 簡潔、自動實體編碼、支援多種輸出編碼 (輸入必須 UTF-8)。
缺點:唯寫、無法回頭修改、不支援 XPath/驗證/載入既有 XML。
<?php
// 先建立一個空的根元素字串
$xmlStr = <<
XML;
$xml = simplexml_load_string($xmlStr);
foreach ($data as $itemData) {
$item = $xml->addChild('item');
foreach ($itemData as $key => $val) {
$node = $item->addChild($key, $val); // 值自動實體編碼
if (isset($attr[$key])) {
foreach ($attr[$key] as $aKey => $aVal) {
$node->addAttribute($aKey, $aVal);
}
}
}
}
echo $xml->asXML();
?>
優點:語法極簡潔、物件屬性式存取 ($xml->item[0]->title)、支援 XPath ($xml->xpath('//item'))。
缺點:同樣載入整棵樹至記憶體、命名空間處理較繁瑣、大檔案效能不如 XMLWriter。
| 維度 | 字串拼接 | DOMDocument | XMLWriter | SimpleXML |
|---|---|---|---|---|
| 記憶體佔用 | 極低 (流式) | 高 (全樹載入) | 極低 (流式) | 高 (全樹載入) |
| 執行速度 | 最快 | 中等 | 最快 | 快 |
| 正確性保障 | 無 (手動) | 高 (標準) | 高 (自動編碼) | 高 (自動編碼) |
| 可讀/維護性 | 差 | 中 | 良 | 最佳 |
| 功能豐富度 | 無 | 完整 (XPath, XSLT, Schema) | 基本 (唯寫) | 良 (XPath, 簡易修改) |
| 適用場景 | 極簡輸出、極大檔、無依賴環境 | 需修改/驗證/轉換既有 XML、複雜結構 | 大檔案匯出、API 回應、串流輸出 | 中小型 XML 生成、配置檔、快速原型 |
| PHP 版本需求 | 所有 | PHP 5+ | PHP 5.1.2+ | PHP 5.0.1+ |
htmlspecialchars)header('Content-Type: application/xml; charset=utf-8');。libxml_use_internal_errors(true) 捕捉解析錯誤。XMLSecurityKey (xmlseclibs) 或 openssl_sign。