萬盛學電腦網

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

PHP 使用 DOMDocument 讀取圖書 XML 資料:節點遍歷與屬性存取實戰

前言

DOMDocument 是 PHP 解析 XML 的標準工具,採用樹狀結構載入整份文件,支援 XPath、命名空間、節點修改。本文以圖書資料為例,示範從載入 XML 到提取書名、作者、出版社的完整流程,並解析 getElementsByTagName、childNodes、item() 的正確用法。

一、範例 XML(books.xml)

<?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
*/

三、關鍵概念:DOMNodeList 與 item()

  • getElementsByTagName()、childNodes 回傳 DOMNodeList(類陣列物件)
  • 必須使用 item($index) 取得具體節點,即使只有一個元素也需 item(0)
  • 不可直接 $nodes[0] 或 foreach($nodes as $node)(PHP 8.0+ 可直接 foreach DOMNodeList)

四、進階:使用 XPath 精準查詢

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

六、DOMDocument vs SimpleXML 快速選擇

需求推薦
只需讀取、結構固定、程式碼極簡SimpleXML
需 XPath 複雜查詢、命名空間DOMDocument + DOMXPath
需修改 XML 結構、另存檔案DOMDocument
超大檔案(>100MB)、低記憶體XMLReader (SAX)

結語

DOMDocument 雖然 API 較繁瑣,但功能最完整。關鍵在於記住:所有節點列表操作都要用 item()。搭配 DOMXPath 可大幅簡化查詢邏輯。實務上建議將解析邏輯封裝為 XmlParser 類別,統一錯誤處理、編碼轉換、命名空間註冊,提升專案維護性。

copyright © 萬盛學電腦網 all rights reserved