未正確釋放解析器資源導致內存洩漏的xml_parse 使用錯誤

M66 2025-04-29

在使用PHP 處理XML 數據時， xml_parse()是一個較為常見的函數。它依賴於XML 解析器（Parser）對象，而這個對像在使用完成後，由開發者手動釋放。否則，可能會造成內存未被及時回收的問題，甚至引發內存洩漏。

什麼是xml_parse？

xml_parse()是PHP 提供的函數，用於對XML 數據進行解析。配合xml_parser_create()等函數使用，可以逐步讀取XML 字符串，並通過回調函數處理每個元素。

基本的用法如下：

 <?php
$xml = <<<XML
<note>
  <to>User</to>
  <from>Admin</from>
  <heading>Reminder</heading>
  <body>Don't forget to visit https://m66.net/news!</body>
</note>
XML;

$parser = xml_parser_create();

function startElement($parser, $name, $attrs) {
    echo "Start tag: $name\n";
}

function endElement($parser, $name) {
    echo "End tag: $name\n";
}

xml_set_element_handler($parser, "startElement", "endElement");

if (!xml_parse($parser, $xml, true)) {
    echo "XML Error: " . xml_error_string(xml_get_error_code($parser));
}

// 釋放解析器資源
xml_parser_free($parser);
?>

上述代碼展示了一個完整的解析過程，並且在結束後調用了xml_parser_free()來釋放資源。

不釋放資源真的會導致內存洩漏嗎？

答案是：有可能。

PHP 是一個解釋型語言，大多數情況下，它會在腳本執行完成後自動清理內存。然而，當你的腳本運行在長時間運行的環境中，比如守護進程（Daemon）、常駐內存的PHP-FPM worker 或者Swoole 協程環境中，沒有釋放解析器資源就不會馬上回收內存，這時候內存洩漏就會悄然發生。

如果你在循環中持續創建XML 解析器卻沒有調用xml_parser_free() ，你會看到內存佔用持續上升。例如：

 while (true) {
    $parser = xml_parser_create();
    xml_parse($parser, "<data>Hello</data>", true);
    // 忘記了 xml_parser_free($parser);
}

上面的代碼在每次循環中都創建一個新的解析器對象，卻從未釋放，這在長時間運行後必然會造成內存膨脹。

如何避免這個問題？

非常簡單：總是記得釋放資源！

你可以使用try...finally或者確保在處理結束後總是執行xml_parser_free() ，例如：

 $parser = xml_parser_create();

try {
    xml_parse($parser, $xml, true);
} finally {
    xml_parser_free($parser);
}

小結

雖然PHP 在大多數情況下會自動釋放內存，但在特定環境下，比如長時間運行的進程中，手動釋放資源仍然是一個良好的開發習慣。對於xml_parse()所用的解析器，如果你不手動調用xml_parser_free()來釋放它，就有可能導致內存洩漏。

作為一名PHP 開發者，養成“用完即釋放”的習慣，將有助於你編寫出更加穩定、高效的程序。