简体中文
简体中文
在解析 XML 文档时，命名空间的使用可以有效避免元素和属性名称的冲突，尤其是在不同 XML 规范混合使用的场景中。当我们使用 PHP 的 XML 解析器（基于 Expat）处理带有多个命名空间的 XML 文件时，合理管理命名空间的开始和结束尤为关键。
本文将重点讲解如何使用 xml_set_end_namespace_decl_handler 函数来处理多个命名空间同时结束的情况，确保 XML 的结构能够被正确地解析和追踪。
xml_set_end_namespace_decl_handler 是 PHP 提供的一个函数，用于设置解析器在遇到命名空间声明结束时所触发的处理器（回调函数）。它的原型如下：
bool xml_set_end_namespace_decl_handler(XMLParser $parser, callable $handler)
其中 $parser 是通过 xml_parser_create() 创建的解析器资源，而 $handler 是一个回调函数，当一个命名空间作用域结束时被调用。
设想一个 XML 结构如下：
<root xmlns:h="http://gitbox.net/html" xmlns:f="http://gitbox.net/form">
<h:table>
<f:input type="text"/>
</h:table>
</root>
在上面的 XML 中，h 和 f 是两个不同的命名空间。虽然它们的作用域在整个 <root> 标签中，但在更复杂的文档中，可能出现嵌套命名空间的结构，并且多个命名空间在某个元素闭合时同时结束。
我们希望在这些命名空间结束时能做一些操作，比如记录、校验或释放资源等。
下面是一个完整的示例，展示如何使用 xml_set_end_namespace_decl_handler 处理命名空间的结束：
<?php
$xml = <<<XML
<root xmlns:h="http://gitbox.net/html" xmlns:f="http://gitbox.net/form">
<h:table>
<f:input type="text"/>
</h:table>
</root>
XML;
// 创建 XML 解析器
$parser = xml_parser_create_ns();
// 设置命名空间结束处理器
xml_set_end_namespace_decl_handler($parser, function($parser, $prefix) {
echo "命名空间结束: 前缀 = $prefix\n";
});
// 设置默认的元素处理器
xml_set_element_handler($parser,
function($parser, $name, $attrs) {
echo "开始元素: $name\n";
},
function($parser, $name) {
echo "结束元素: $name\n";
}
);
// 解析 XML 数据
if (!xml_parse($parser, $xml, true)) {
die(sprintf(
"XML 错误: %s 在第 %d 行",
xml_error_string(xml_get_error_code($parser)),
xml_get_current_line_number($parser)
));
}
// 释放解析器资源
xml_parser_free($parser);
?>
运行上述代码时，你将看到类似如下的输出：
开始元素: root
开始元素: h:table
开始元素: f:input
结束元素: f:input
结束元素: h:table
结束元素: root
命名空间结束: 前缀 = h
命名空间结束: 前缀 = f
可以看到，虽然命名空间是在文档开始时声明的，但它们的作用域实际上是在 <root> 元素闭合时结束的，xml_set_end_namespace_decl_handler 成功捕获了这一行为。
命名空间处理器只在使用 xml_parser_create_ns() 创建解析器的前提下才能生效。
xml_set_end_namespace_decl_handler 的回调函数只接收两个参数：解析器资源和命名空间前缀。
多个命名空间同时结束时，回调会被依次调用，每个命名空间一次。
通过 xml_set_end_namespace_decl_handler 函数，PHP 开发者可以精确控制命名空间生命周期，尤其在处理复杂的 XML 文档时尤为重要。结合命名空间开始和结束的处理器，可以构建出稳定且可维护的 XML 解析逻辑，确保在如 Web 服务、配置文件解析等场景中获得正确的数据处理能力。
