PHP XML Parser (Expat) 深度解析：事件驅動解析、SAX 模式與高效能處理

PHP XML Parser 擴展基於 Expat 庫實現，採用事件驅動的 SAX (Simple API for XML) 模式，逐節點解析 XML 文件，不載入完整文件到記憶體，適合大型 XML 文件處理。本文詳細說明解析器建立、事件處理器註冊、核心函數、命名空間處理、錯誤處理與實戰範例。

核心特性與適用場景

核心函數速查

解析器選項常數

錯誤代碼常數

實戰範例：事件驅動解析大型 XML

<?php
class LargeXmlParser {
    private $parser;
    private $currentElement = '';
    private $data = [];
    private $itemCount = 0;

    public function __construct() {
        $this->parser = xml_parser_create('UTF-8');
        xml_set_object($this->parser, $this);
        xml_set_element_handler($this->parser, 'startElement', 'endElement');
        xml_set_character_data_handler($this->parser, 'characterData');
        // 可選：關閉大小寫摺疊保持原始大小寫
        xml_parser_set_option($this->parser, XML_OPTION_CASE_FOLDING, 0);
    }

    public function parseFile($filename, $chunkSize = 8192) {
        $fp = fopen($filename, 'r');
        if (!$fp) throw new Exception("無法開啟檔案: $filename");

        while (!feof($fp)) {
            $data = fread($fp, $chunkSize);
            if (!xml_parse($this->parser, $data, feof($fp))) {
                $this->handleError();
            }
        }
        fclose($fp);
        xml_parser_free($this->parser);
        return $this->data;
    }

    private function startElement($parser, $name, $attrs) {
        $this->currentElement = $name;
        if ($name === 'item') {
            $this->itemCount++;
            $this->data[$this->itemCount] = ['attrs' => $attrs];
        }
    }

    private function endElement($parser, $name) {
        $this->currentElement = '';
    }

    private function characterData($parser, $data) {
        if ($this->currentElement && $this->itemCount > 0) {
            $this->data[$this->itemCount][$this->currentElement] = 
                ($this->data[$this->itemCount][$this->currentElement] ?? '') . $data;
        }
    }

    private function handleError() {
        $code = xml_get_error_code($this->parser);
        $line = xml_get_current_line_number($this->parser);
        $col = xml_get_current_column_number($this->parser);
        throw new Exception("XML 解析錯誤 [$code]: " . xml_error_string($code) . " at line $line, col $col");
    }
}

// 使用
$parser = new LargeXmlParser();
$items = $parser->parseFile('large-feed.xml');
print_r($items);

xml_parse_into_struct 簡易結構化輸出

$xml = '<?xml version="1.0"?><root><item id="1"><name>Test</name></item></root>';
$parser = xml_parser_create();
xml_parse_into_struct($parser, $xml, $values, $index);
xml_parser_free($parser);

print_r($values);
/* 輸出結構：
Array
(
    [0] => Array
        (
            [tag] => ROOT
            [type] => open
            [level] => 1
            [attributes] => Array()
        )
    [1] => Array
        (
            [tag] => ITEM
            [type] => open
            [level] => 2
            [attributes] => Array([ID] => 1)
        )
    [2] => Array
        (
            [tag] => NAME
            [type] => complete
            [level] => 3
            [value] => Test
        )
    [3] => Array
        (
            [tag] => ITEM
            [type] => close
            [level] => 2
        )
    [4] => Array
        (
            [tag] => ROOT
            [type] => close
            [level] => 1
        )
)
*/
print_r($index); // 索引：標籤名 => 陣列索引列表

命名空間處理

$xml = '<?xml version="1.0"?><root xmlns:ns="https://example.com/ns"><ns:item/></root>';
$parser = xml_parser_create_ns('UTF-8', ':'); // 分隔符為 :

xml_set_start_namespace_decl_handler($parser, function($parser, $prefix, $uri) {
    echo "NS Start: $prefix => $uri\n";
});
xml_set_end_namespace_decl_handler($parser, function($parser, $prefix) {
    echo "NS End: $prefix\n";
});
xml_set_element_handler($parser, function($parser, $name, $attrs) {
    echo "Element: $name\n"; // 名稱格式: prefix:localname
}, function($parser, $name) {});

xml_parse($parser, $xml, true);
xml_parser_free($parser);

XML Parser vs DOMDocument vs SimpleXML vs XMLReader 比較

總結

PHP XML Parser (Expat) 是處理大型 XML 文件的高效能選擇，事件驅動模式雖需適應回呼思維，但記憶體效率極佳。現代 PHP 開發中，XMLReader 提供更直觀的 Pull API 且效能相當，建議新專案優先評估。若需 DOM 操作、XPath、修改輸出，則選擇 DOMDocument。理解各解析器特性，根據檔案大小、記憶體限制、處理模式選擇最適工具。

1. 上一篇文章： PHP Zip 壓縮檔操作完全指南：安裝、核心函數與實戰應用
2. 下一篇文章： PHP 字串函數完整參考：核心函數分類、常用操作與效能技巧

PHP 入門

PHP 實例教程 (4)：構建基於 PHP 的微博客服務 — 聚合關注用戶貼文

在前幾節課程中，我們已經建立了用戶註冊、登入以及發布貼文的基

PHP $_POST 超全域變數完整指南：表單資料接收、安全處理與最佳實踐

PHP $_POST 超全域變數完整指南 $_POST 是

.htaccess Editor：零基礎也能輕鬆產生 Apache 設定檔

什麼是 .htaccess？ .htaccess 是 Apa

PHP date() 函數完整指南：日期時間格式化、時間戳操作與實務技巧

PHP date() 函數完整指南 date() 是 PHP