萬盛學電腦網

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

PHP DOMDocument 生成 XML 完整教學:從基礎到屬性、命名空間

為何選擇 DOMDocument

PHP DOMDocument 類別提供符合 W3C DOM 標準的 XML 操作介面,支援建立、修改、驗證、序列化 XML 文件,比字串拼接更安全、結構化,且原生支援 XPath 查詢。

建立基本 XML 文件

<?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);

批量建立結構:陣列轉 XML

$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);
}

處理特殊字元與 CDATA

$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()。

進階:XML Schema (XSD) 驗證

$dom->schemaValidate('catalog.xsd'); // 回傳 bool,錯誤存於 libxml_get_errors()

總結

DOMDocument 是 PHP 處理 XML 的標準利器,掌握「建立元素→設定屬性/文字→掛載樹狀結構」核心流程,配合 formatOutput、CDATASection、命名空間等進階功能,即可應對複雜 XML 生成需求。大型資料建議改用 XMLWriter(流式寫入,記憶體效率更高)。

copyright © 萬盛學電腦網 all rights reserved