中文(繁體)
中文(繁體)
在解析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 服務、配置文件解析等場景中獲得正確的數據處理能力。
