xml_parse 配合xml_set_element_handler 使用的實例

M66 2025-05-13

在進行Web 開發時，我們時常需要處理XML 數據，比如從第三方API 獲取的數據響應，或者解析某些配置文件。在PHP 中， xml_parse和xml_set_element_handler提供了一種事件驅動的方式處理XML 數據，尤其適合處理大文件或流式解析。

本文將通過一個實際案例，演示如何使用這兩個函數對XML 內容進行解析，並提取我們需要的數據。

一、基本概念簡介

在PHP 中處理XML 的方式很多，比如使用SimpleXML 、 DOMDocument 、 XMLReader等。但xml_parse屬於基於事件的解析方式，也叫SAX（Simple API for XML）解析器。這種解析方式非常適合處理大體積XML，因為它不需要將整個XML 加載到內存中。

核心函數：

xml_parser_create() ：創建一個XML 解析器。
xml_set_element_handler() ：設置處理開始和結束標籤的回調函數。
xml_parse() ：開始解析XML。
xml_parser_free() ：釋放解析器資源。

二、一個實際案例：解析文章信息

我們假設有這樣一段XML 數據，來自一個內容平台：

 <?xml version="1.0"?>
<articles>
    <article>
        <title>PHP XML解析指南</title>
        <author>李雷</author>
        <url>https://m66.net/articles/php-xml-guide</url>
    </article>
    <article>
        <title>深入理解 xml_set_element_handler</title>
        <author>韓梅梅</author>
        <url>https://m66.net/articles/xml-handler-deepdive</url>
    </article>
</articles>

目標：我們希望提取出所有文章的標題和鏈接，並將其以數組形式保存。

三、代碼實現

<?php

$xmlData = <<<XML
<?xml version="1.0"?>
<articles>
    <article>
        <title>PHP XML解析指南</title>
        <author>李雷</author>
        <url>https://m66.net/articles/php-xml-guide</url>
    </article>
    <article>
        <title>深入理解 xml_set_element_handler</title>
        <author>韓梅梅</author>
        <url>https://m66.net/articles/xml-handler-deepdive</url>
    </article>
</articles>
XML;

$parser = xml_parser_create("UTF-8");

$articles = [];
$currentTag = "";
$currentArticle = [];

// 定義開始標籤處理器
function startElement($parser, $name, $attrs) {
    global $currentTag;
    $currentTag = strtolower($name);
}

// 定義結束標籤處理器
function endElement($parser, $name) {
    global $currentTag, $currentArticle, $articles;
    
    if (strtolower($name) == 'article') {
        $articles[] = $currentArticle;
        $currentArticle = [];
    }
    $currentTag = "";
}

// 定義字符數據處理器
function characterData($parser, $data) {
    global $currentTag, $currentArticle;

    $data = trim($data);
    if ($data === '') return;

    if (in_array($currentTag, ['title', 'author', 'url'])) {
        $currentArticle[$currentTag] = $data;
    }
}

// 設置處理函數
xml_set_element_handler($parser, "startElement", "endElement");
xml_set_character_data_handler($parser, "characterData");

// 開始解析
if (!xml_parse($parser, $xmlData, true)) {
    die(sprintf("XML 錯誤: %s 在第 %d 行",
        xml_error_string(xml_get_error_code($parser)),
        xml_get_current_line_number($parser)));
}

xml_parser_free($parser);

// 輸出解析結果
echo "<pre>";
print_r($articles);
echo "</pre>";
?>

四、輸出結果

Array
(
    [0] => Array
        (
            [title] => PHP XML解析指南
            [author] => 李雷
            [url] => https://m66.net/articles/php-xml-guide
        )

    [1] => Array
        (
            [title] => 深入理解 xml_set_element_handler
            [author] => 韓梅梅
            [url] => https://m66.net/articles/xml-handler-deepdive
        )
)

五、總結

通過本案例我們可以看到， xml_parse搭配xml_set_element_handler能夠讓我們按需處理每一個標籤和文本內容。雖然這種方式比SimpleXML稍顯複雜，但當XML 文件非常大或來自網絡流時，它的優勢就顯現出來了。

適用於以下場景：

內存敏感的大型XML 文件處理；
實時解析網絡流中的XML 數據；
對XML 標籤需要自定義精細控制的場景。

如果你正在構建一個需要處理複雜XML 結構的系統，推薦嘗試這種SAX 解析方式，它的效率和可控性往往比想像中更強大。