未正确释放解析器资源导致内存泄漏的 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 开发者，养成“用完即释放”的习惯，将有助于你编写出更加稳定、高效的程序。