PHP XML解析器函数

PHP xml_set_external_entity_ref_handler() 函数为给定的 XML 解析器设置外部实体引用处理函数。

语法

xml_set_external_entity_ref_handler(parser, handler) 

参数

parser必需。 指定对 XML 解析器的引用,以设置外部实体引用处理函数。
handler必需。 指定一个字符串,其中包含要用作事件处理程序的函数名称。该函数必须接受五个参数:
handler(parser, open_entity_names, base, system_id, public_id) 
  • parser:第一个参数 parser 是对调用处理程序的 XML 解析器的引用。
  • open_entity_names:以空格分隔的实体名称列表,用于解析该实体(包括引用实体的名称)。
  • base:解析外部实体的系统标识符(system_id)的基础。目前此参数将始终设置为空字符串。
  • system_id:实体声明中指定的系统标识符。
  • public_id:实体声明中指定的公共标识符,如果未指定则为空字符串;公共标识符中的空格将按照 XML 规范的要求进行规范化。
如果处理程序函数设置为空字符串或 false,则相关处理程序将被禁用。注意:除了函数名之外,还可以使用包含对象引用和方法名的数组。

返回值

成功时返回 true,失败时返回 false。

示例:xml_set_external_entity_ref_handler() 示例

假设我们有一个名为 test.xml 的文件。在下面的示例中,使用 xml_parser_create() 函数创建 XML 解析器。然后打开 XML 文件,使用字符处理函数 char_print 解析其数据。然后,ext_ent_handler 函数被设置为给定 XML 解析器的外部实体引用处理程序。解析文档后,使用xml_parser_free()函数释放解析器。

<?php
//创建XML解析器
$parser=xml_parser_create();

//XML解析器的字符处理函数
function char_print($parser, $data) {
  echo $data;
}

//XML解析器的外部实体引用处理函数
function ext_ent_handler($parser, $not, $base, $sysID, $pubID) {
  echo "$not $sysID $pubID";
}

//设置XML解析器的字符处理函数
xml_set_character_data_handler($parser,"char_print");

//为XML解析器设置外部实体引用处理程序
xml_set_external_entity_ref_handler($parser,"ext_ent_handler");

//打开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);
?>