PHP xml_parser_free() 函数释放给定的 XML 解析器。
注意:除了在解析完成时调用 xml_parser_free() 之外,在 PHP 8.0.0 之前,如果引用了解析器资源,还需要显式取消对解析器的引用以避免内存泄漏来自一个对象,并且该对象引用该解析器资源。
语法
xml_parser_free(parser)
参数
parser | <代码>必填。 指定要释放的 XML 解析器的引用。 |
返回值
成功时返回 true,失败时返回 false .
示例:
假设我们有一个名为 test.xml 的文件。该文件包含以下内容:
<?xml version="1.0" encoding="UTF-8"?>
<userlist>
<user>
<username>John123</username>
<name>John Smith</name>
<phone>+1-8054098000</phone>
<address>Brooklyn, New York, USA</address>
</user>
</userlist>
在下面的示例中,创建了一个 XML 解析器。然后打开 XML 文件,使用字符处理函数 char_print 解析其数据。解析文档后,使用xml_parser_free()函数释放解析器。
<?php
//创建XML解析器
$parser=xml_parser_create();
//XML解析器的字符处理函数
function char_print($parser, $data) {
echo $data;
}
//设置XML解析器的字符处理函数
xml_set_character_data_handler($parser,"char_print");
//打开xml文件
$fp = fopen("test.xml", "r");
while($data = fread($fp,4096)) {
//解析XML数据
xml_parse($parser,$data,feof($fp)) or
//解析错误时显示错误
die (sprintf("XML Error: %s at line %d",
//错误字符串
xml_error_string(xml_get_error_code($parser)),
//当前行
xml_get_current_line_number($parser)));
}
//免费的XML解析器
xml_parser_free($parser);
fclose($fp);
?>
上述代码的输出将是:
John123 John Smith +1-8054098000 Brooklyn, New York, USA
示例:
再考虑一个使用字符解析 XML 文档的示例处理函数和元素处理函数。解析文档后,使用xml_parser_free()函数释放解析器。
<?php
//创建XML解析器
$parser=xml_parser_create();
//名为"start_handler"的元素处理函数
//启用自定义输出
function start_handler($parser, $element, $attribs) {
switch($element) {
case "USERNAME":
echo "<b>User Name : ";
break;
case "NAME":
echo "Name : ";
break;
case "PHONE":
echo "Phone : ";
break;
case "ADDRESS":
echo "Address : ";
break;
}
}
//元素处理函数"end_handler"
function end_handler($parser, $element) {
if($element == "USERNAME")
echo "</b><br>";
else
echo "<br>";
}
// 设置元素处理程序
xml_set_element_handler($parser, "start_handler",
"end_handler");
//XML解析器的字符处理函数
function char_print($parser, $data) {
echo $data;
}
//设置XML解析器的字符处理函数
xml_set_character_data_handler($parser,"char_print");
//打开xml文件
$fp = fopen("test.xml", "r");
while($data = fread($fp,4096)) {
//解析XML数据
xml_parse($parser,$data,feof($fp)) or
//解析错误时显示错误
die (sprintf("XML Error: %s at line %d",
//错误字符串
xml_error_string(xml_get_error_code($parser)),
//当前行
xml_get_current_line_number($parser)));
}
//免费的XML解析器
xml_parser_free($parser);
fclose($fp);
?>
上述代码的输出将是:
User Name : John123
Name : John Smith
Phone : +1-8054098000
Address : Brooklyn, New York, USA