DOMDocument 是 PHP 解析 XML 的標準工具,採用樹狀結構載入整份文件,支援 XPath、命名空間、節點修改。本文以圖書資料為例,示範從載入 XML 到提取書名、作者、出版社的完整流程,並解析 getElementsByTagName、childNodes、item() 的正確用法。
<?xml version="1.0" encoding="UTF-8"?>
<books>
<book>
<author>Jack Herrington</author>
<title>PHP Hacks</title>
<publisher>O'Reilly</publisher>
</book>
<book>
<author>Jack Herrington</author>
Podcasting Hacks
O'Reilly
<?php
$doc = new DOMDocument();
$doc->load('books.xml'); // 載入檔案,或 loadXML($string)
$books = $doc->getElementsByTagName('book');
foreach ($books as $book) {
// getElementsByTagName 回傳 DOMNodeList,需用 item(0) 取第一個
$authorNode = $book->getElementsByTagName('author')->item(0);
$titleNode = $book->getElementsByTagName('title')->item(0);
$pubNode = $book->getElementsByTagName('publisher')->item(0);
// 取得文字內容
$author = $authorNode ? $authorNode->textContent : '';
$title = $titleNode ? $titleNode->textContent : '';
$pub = $pubNode ? $pubNode->textContent : '';
echo "$title - $author - $pub\n";
}
/* 輸出:
PHP Hacks - Jack Herrington - O'Reilly
Podcasting Hacks - Jack Herrington - O'Reilly
*/
getElementsByTagName()、childNodes 回傳 DOMNodeList(類陣列物件)item($index) 取得具體節點,即使只有一個元素也需 item(0)$nodes[0] 或 foreach($nodes as $node)(PHP 8.0+ 可直接 foreach DOMNodeList)$xpath = new DOMXPath($doc);
// 1. 取得所有書名
$titles = $xpath->query('//book/title');
foreach ($titles as $title) {
echo $title->textContent . "\n";
}
// 2. 取得作者為 Jack Herrington 的書名
$titles = $xpath->query('//book[author="Jack Herrington"]/title');
foreach ($titles as $title) {
echo $title->textContent . "\n";
}
// 3. 取得 book 的 id 屬性(若 XML 有 id 屬性)
$books = $xpath->query('//book/@id');
foreach ($books as $attr) {
echo "ID: " . $attr->value . "\n";
}
<?php
function loadXmlSafely(string $path): ?DOMDocument
{
$dom = new DOMDocument();
// 禁止載入外部實體(安全性)
$dom->load($path, LIBXML_NOENT | LIBXML_DTDLOAD);
// 或使用 libxml_use_internal_errors(true) 捕捉錯誤
libxml_use_internal_errors(true);
$loaded = $dom->load($path);
if (!$loaded) {
$errors = libxml_get_errors();
libxml_clear_errors();
// 記錄錯誤...
return null;
}
return $dom;
}
| 需求 | 推薦 |
|---|---|
| 只需讀取、結構固定、程式碼極簡 | SimpleXML |
| 需 XPath 複雜查詢、命名空間 | DOMDocument + DOMXPath |
| 需修改 XML 結構、另存檔案 | DOMDocument |
| 超大檔案(>100MB)、低記憶體 | XMLReader (SAX) |
DOMDocument 雖然 API 較繁瑣,但功能最完整。關鍵在於記住:所有節點列表操作都要用 item()。搭配 DOMXPath 可大幅簡化查詢邏輯。實務上建議將解析邏輯封裝為 XmlParser 類別,統一錯誤處理、編碼轉換、命名空間註冊,提升專案維護性。