PHP DOMDocument 類別提供符合 W3C DOM 標準的 XML 操作介面,支援建立、修改、驗證、序列化 XML 文件,比字串拼接更安全、結構化,且原生支援 XPath 查詢。
<?php
$dom = new DOMDocument('1.0', 'UTF-8'); // 版本與編碼
$dom->formatOutput = true; // 美化輸出(縮排)
// 根元素
$root = $dom->createElement('catalog');
$dom->appendChild($root);
// 子元素與文字節點
$book = $dom->createElement('book');
$root->appendChild($book);
$title = $dom->createElement('title', 'PHP 程式設計入門');
$book->appendChild($title);
$author = $dom->createElement('author', '張三');
$book->appendChild($author);
// 輸出
header('Content-Type: application/xml; charset=utf-8');
echo $dom->saveXML();
輸出:
<?xml version="1.0" encoding="UTF-8"?>
<catalog>
<book>
<title>PHP 程式設計入門</title>
<author>張三</author>
</book>
</catalog>
$book = $dom->createElement('book');
$book->setAttribute('id', 'bk101');
$book->setAttribute('category', 'programming');
$root->appendChild($book);
// 或使用 createAttribute
$isbnAttr = $dom->createAttribute('isbn');
$isbnAttr->value = '978-7-115-12345-6';
$book->appendChild($isbnAttr);
$books = [
['id' => 'bk101', 'title' => 'PHP 入門', 'author' => '張三', 'price' => 350],
['id' => 'bk102', 'title' => 'Laravel 實戰', 'author' => '李四', 'price' => 480],
];
foreach ($books as $data) {
$book = $dom->createElement('book');
$book->setAttribute('id', $data['id']);
foreach (['title', 'author', 'price'] as $field) {
$elem = $dom->createElement($field, $data[$field]);
$book->appendChild($elem);
}
$root->appendChild($book);
}
$desc = $dom->createElement('description');
// 文字節點會自動轉義 & < > 等
$desc->appendChild($dom->createTextNode('Price < 500 & in stock'));
// 若需保留原始 HTML/標記,使用 CDATASection
$cdata = $dom->createCDATASection('原始 HTML & 標記
');
$desc->appendChild($cdata);
$book->appendChild($desc);
$dom = new DOMDocument('1.0', 'UTF-8');
$dom->formatOutput = true;
// 註冊命名空間
$ns = 'https://example.com/book';
$root = $dom->createElementNS($ns, 'bk:catalog');
$dom->appendChild($root);
// 子元素同樣使用 NS
$book = $dom->createElementNS($ns, 'bk:book');
$root->appendChild($book);
// 設定命名空間前綴聲明(可選)
$root->setAttributeNS('https://www.w3.org/2000/xmlns/', 'xmlns:bk', $ns);
saveXML():回傳 XML 字串save($filename):直接寫入檔案saveHTML():輸出 HTML 格式(較寬鬆)'UTF-8',確保輸入字串為 UTF-8。$dom->substituteEntities = true; 或使用 load() 時 LIBXML_DTDLOAD。formatOutput = true 需在建立節點之前設定,且僅影響 saveXML()/save()。$dom->schemaValidate('catalog.xsd'); // 回傳 bool,錯誤存於 libxml_get_errors()
DOMDocument 是 PHP 處理 XML 的標準利器,掌握「建立元素→設定屬性/文字→掛載樹狀結構」核心流程,配合 formatOutput、CDATASection、命名空間等進階功能,即可應對複雜 XML 生成需求。大型資料建議改用 XMLWriter(流式寫入,記憶體效率更高)。