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 解析方式，它的效率和可控性往往比想象中更强大。