中文(繁體)
中文(繁體)
在處理XML 數據時，尤其是帶有命名空間（Namespace）的文檔，使用PHP 的XML 解析器（基於Expat）是一種靈活高效的方式。本文將重點講解xml_set_end_namespace_decl_handler函數的用途，並結合完整示例說明如何正確地利用該函數，在解析過程中處理命名空間聲明的結束。
PHP 提供了一系列基於事件驅動的XML 解析函數，比如xml_parser_create 、 xml_parse 、 xml_set_element_handler等。在命名空間相關的處理上， xml_set_start_namespace_decl_handler和xml_set_end_namespace_decl_handler分別對應命名空間的聲明開始和結束。
雖然命名空間開始的處理更為常用，但結束處理同樣重要，尤其在嵌套複雜或需要維護作用域棧的情況下。通過xml_set_end_namespace_decl_handler ，我們可以在命名空間結束時執行清理操作、維護命名空間棧，或者記錄日誌以調試。
bool xml_set_end_namespace_decl_handler ( resource $parser , callable $handler )
$parser : 由xml_parser_create創建的解析器資源。
$handler : 回調函數，形式為function handler(resource $parser, string $prefix) ，在命名空間聲明結束時被調用。
以下是一個使用xml_set_end_namespace_decl_handler的完整示例：
<?php
$xml = <<<XML
<?xml version="1.0"?>
<root xmlns:h="http://gitbox.net/hello" xmlns:f="http://gitbox.net/foo">
<h:child>Content</h:child>
<f:child>Another</f:child>
</root>
XML;
$parser = xml_parser_create();
// 設置命名空間處理
xml_parser_set_option($parser, XML_OPTION_CASE_FOLDING, 0);
xml_parser_set_option($parser, XML_OPTION_SKIP_WHITE, 1);
// 命名空間開始聲明處理器
xml_set_start_namespace_decl_handler($parser, function($parser, $prefix, $uri) {
echo "Namespace Start: prefix = {$prefix}, uri = {$uri}\n";
});
// 命名空間結束聲明處理器
xml_set_end_namespace_decl_handler($parser, function($parser, $prefix) {
echo "Namespace End: prefix = {$prefix}\n";
});
// 元素處理器
xml_set_element_handler($parser,
function($parser, $name, $attrs) {
echo "Start Element: {$name}\n";
},
function($parser, $name) {
echo "End Element: {$name}\n";
}
);
// 執行解析
if (!xml_parse($parser, $xml, true)) {
$error = xml_error_string(xml_get_error_code($parser));
$line = xml_get_current_line_number($parser);
die("XML Error: {$error} at line {$line}\n");
}
xml_parser_free($parser);
運行上面的腳本，將輸出如下內容：
Namespace Start: prefix = h, uri = http://gitbox.net/hello
Namespace Start: prefix = f, uri = http://gitbox.net/foo
Start Element: root
Start Element: h:child
End Element: h:child
Start Element: f:child
End Element: f:child
End Element: root
Namespace End: prefix = f
Namespace End: prefix = h
從輸出可以看出：
命名空間聲明的順序與其在文檔中的定義一致；
xml_set_end_namespace_decl_handler在元素解析完畢之後，正確地捕捉到了命名空間的結束；
如果你在解析過程中維護了命名空間作用域棧，此時就是出棧的好時機。
作用域控制：當你在XML 解析中使用命名空間作用域（比如配置解析器或構建樹結構），務必同時使用start與end的命名空間聲明處理器。
調試工具：在調試命名空間衝突、嵌套混用等複雜情況時，使用xml_set_end_namespace_decl_handler可以幫助你更好地理解XML 文檔的結構。
命名空間棧設計：你可以使用PHP 的數組模擬棧結構，將start時入棧， end時出棧，以便於更準確地跟踪當前命名空間上下文。
雖然xml_set_end_namespace_decl_handler並不如元素處理器常用，但在處理複雜XML 尤其是多命名空間混用時，它能提供非常關鍵的輔助作用。掌握其用法，能讓你的XML 解析器更加強健和健壯。希望本文能幫助你在使用PHP 解析XML 時，充分利用這一強大的工具函數。
