您现在的位置：程式碼之家 >> 編程語言 > >> 網頁程式設計 >> PHP 程式設計 >> PHP 相關知識

PHP DOMDocument 生成 XML 完整教學：從基本結構到屬性、CDATA 與儲存

編輯：PHP 相關知識

前言

處理 XML 資料結構是後端開發常見需求。PHP 內建 DOMDocument 類提供強大、標準化的 API，能程式化建立、操作並輸出符合標準的 XML 文件。本文將由淺入深示範完整流程。

一、建立文件與 XML 宣告

<?php
$dom = new DOMDocument("1.0"); // 版本 1.0
header("Content-Type: text/plain"); // 方便瀏覽器查看原始碼
echo $dom->saveXML();
// 輸出：<?xml version="1.0"?>
?>

二、新增元素與文字節點

核心兩步驟：
1. createElement() / createTextNode() 建立節點物件。
2. appendChild() 掛載至父節點，構建樹狀結構。

<?php
$dom = new DOMDocument("1.0");
header("Content-Type: text/plain");

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

// 建立子元素 <item> 並掛載到根節點
$item = $dom->createElement("item");
$root->appendChild($item);

// 建立文字節點並掛載到 <item>
$text = $dom->createTextNode("pepperoni");
$item->appendChild($text);

echo $dom->saveXML();
// 輸出：
// <?xml version="1.0"?>
// <toppings><item>pepperoni</item></toppings>
?>

三、新增多個同層子元素

重複建立 item 並 appendChild 到同一個 root 即可。

$item2 = $dom->createElement("item");
$root->appendChild($item2);
$text2 = $dom->createTextNode("tomato");
$item2->appendChild($text2);
// 輸出會包含兩個 <item> 節點

四、為元素新增屬性

屬性也是節點，需先 createAttribute() 建立屬性節點，再建立文字節點作為屬性值，最後掛載至元素。

$price = $dom->createAttribute("price");
$item->appendChild($price);
$priceValue = $dom->createTextNode("4");
$price->appendChild($priceValue);
// 結果：<item price="4">pepperoni</item>

五、CDATA 區塊與處理指令

createCDATASection()：包含特殊字元、不需轉義的資料區塊。
createProcessingInstruction()：給 XML 解析器的指令（如樣式表關聯）。

$cdata = $dom->createCDATASection("Customer requests pizza sliced into 16 square pieces");
$root->appendChild($cdata);

$pi = $dom->createProcessingInstruction("pizza", "bake()");
$root->appendChild($pi);
// 輸出包含：<![CDATA[...]]> 和 <?pizza bake()?>

六、儲存 XML：輸出到檔案或變數

save('filename.xml')：直接寫入檔案，可搭配 $dom->formatOutput = true; 美化縮排。
saveXML()：回傳 XML 字串，存入變數或直接輸出。

$dom->formatOutput = true; // 開啟美化格式
$dom->save("order.xml");     // 存檔
$xmlString = $dom->saveXML(); // 存變數

七、實戰範例：從 MySQL 查詢資料生成 XML 檔

<?php
$conn = mysql_connect('localhost', 'root', '123456') or die('Connect failed: ' . mysql_error());
mysql_select_db('vdigital', $conn) or die('DB select failed: ' . mysql_error());

$sql = "SELECT id, username FROM `admin` GROUP BY `id` ORDER BY `id` ASC";
$result = mysql_query($sql) or die('Query failed: ' . mysql_error());

$xmlDoc = new DOMDocument();
$xmlFile = "01.xml";

if ($result) {
    // 若檔案不存在，建立基本結構
    if (!file_exists($xmlFile)) {
        $xmlStr = "<?xml version='1.0' encoding='utf-8' ?><message></message>";
        $xmlDoc->loadXML($xmlStr);
        $xmlDoc->save($xmlFile);
    } else {
        $xmlDoc->load($xmlFile);
    }

    $root = $xmlDoc->documentElement;

    while ($row = mysql_fetch_array($result)) {
        // 建立 <id> 節點
        $nodeId = $xmlDoc->createElement("id");
        $nodeId->appendChild($xmlDoc->createTextNode(iconv("GB2312", "UTF-8", $row["id"])));
        $root->appendChild($nodeId);

        // 建立 <name> 節點
        $nodeName = $xmlDoc->createElement("name");
        $nodeName->appendChild($xmlDoc->createTextNode(iconv("GB2312", "UTF-8", $row["username"])));
        $root->appendChild($nodeName);

        $xmlDoc->save($xmlFile); // 每次迴圈存檔，或迴圈結束後存一次
    }
}
mysql_close($conn);
?>

八、讀取與查詢 XML (XPath 替代方案)

<?php
$xmlDoc = new DOMDocument();
$xmlDoc->load("https://localhost/xml/xml.php"); // 或本地檔案
$names = $xmlDoc->getElementsByTagName('name');

for ($i = 0; $i < $names->length; $i++) {
    if (strpos($names->item($i)->nodeValue, "fang") !== false) {
        // 取得同層前一個節點 (id) 的值
        echo $names->item($i)->parentNode->childNodes->item(1)->nodeValue;
    }
}
?>