萬盛學電腦網

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

PHP 生成 XML 的四種主流方法完整比較

PHP 生成 XML 的四種主流方法完整比較

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 .= '' . "\n"; } // 屬性處理需自行拼接 if (isset($attr['title'])) { // 這裡示範在 title 元素加屬性,字串拼接較繁瑣 } $xml .= ' ' . "\n"; } $xml .= '
'; return $xml; } echo buildXmlString($data, $attr); ?>

優點:無依賴、記憶體占用最低 (流式輸出)、速度最快。
缺點:極易產生格式錯誤 XML (未閉合標籤、實體未編碼、屬性未轉義)、維護困難、無結構驗證。

方法二:DOMDocument (W3C 標準、功能最完整)

<?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。

方法三:XMLWriter (流式寫入、記憶體友善、速度快)

<?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。

方法四:SimpleXML (語法最簡潔、適合中小型 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。

四大方法綜合比較表

維度字串拼接DOMDocumentXMLWriterSimpleXML
記憶體佔用極低 (流式)高 (全樹載入)極低 (流式)高 (全樹載入)
執行速度最快中等最快快
正確性保障無 (手動)高 (標準)高 (自動編碼)高 (自動編碼)
可讀/維護性差中良最佳
功能豐富度無完整 (XPath, XSLT, Schema)基本 (唯寫)良 (XPath, 簡易修改)
適用場景極簡輸出、極大檔、無依賴環境需修改/驗證/轉換既有 XML、複雜結構大檔案匯出、API 回應、串流輸出中小型 XML 生成、配置檔、快速原型
PHP 版本需求所有PHP 5+PHP 5.1.2+PHP 5.0.1+

選型建議決策樹

  1. 需讀取/修改/驗證既有 XML → DOMDocument
  2. 需產生大檔案 (>10MB) 或串流輸出 → XMLWriter
  3. 中小型、結構固定、追求開發速度 → SimpleXML
  4. 極簡、無擴充依賴、極度追求效能 → 字串拼接 (務必自行 htmlspecialchars)

最佳實踐提醒

  • 所有方法輸入值必須為 UTF-8,否則輸出會亂碼或拋錯。
  • 輸出前務必 header('Content-Type: application/xml; charset=utf-8');。
  • 生產環境建議搭配 libxml_use_internal_errors(true) 捕捉解析錯誤。
  • 若 XML 需簽名/加密,請用 XMLSecurityKey (xmlseclibs) 或 openssl_sign。
copyright © 萬盛學電腦網 all rights reserved