PHP xml_set_unparsed_entity_decl_handler() 函数

PHP XML Parser 函数

定义和用法

xml_set_unparsed_entity_decl_handler() 函数用于指定当解析器在 XML 文档中遇到未解析实体时要调用的函数。

注意：handler 参数也可以是一个包含对象引用和方法名称的数组。

实例

创建一个 XML 解析器，设置字符数据处理程序，设置未解析实体声明处理程序，并解析 XML 文档：

<?php
$parser = xml_parser_create();

function char($parser, $data) {
  echo $data;
}

function unparsed_ent_handler($parser, $entname, $base, $sysID, $pubID, $notname) {
  print "$entname<br>";
  print "$sysID<br>";
  print "$pubID<br>";
  print "$notname<br>";
}

xml_set_character_data_handler($parser, "char");
// 设置未解析实体声明处理程序
xml_set_unparsed_entity_decl_handler($parser, "unparsed_ent_handler");

$fp = fopen("test.xml", "r");

while ($data = fread($fp, 4096)) {
  xml_parse($parser, $data, feof($fp)) or
  die (sprintf("XML 错误：%s 在第 %d 行",
  xml_error_string(xml_get_error_code($parser)),
  xml_get_current_line_number($parser)));
}
xml_parser_free($parser);
fclose($fp);
?>

语法

xml_set_unparsed_entity_decl_handler(parser, handler)
参数 描述
parser 必需。指定要使用的 XML 解析器
handler

必需。指定当 XML 解析器遇到带有 NDATA 声明的外部实体声明时要调用的函数。

该函数必须接受六个参数：

  • $parser - 包含调用处理程序的 XML 解析器的变量
  • $entity_name - 包含实体名称的变量
  • $base - 用于解析外部实体的系统标识符（system_id）的基础。目前，这始终是空字符串
  • $system_id - 外部实体的系统标识符
  • $public_id - 外部实体的公共标识符
  • $notation_name - 此实体的符号名称

技术细节

返回值： 成功时返回 TRUE。失败时返回 FALSE。
PHP 版本： 4.0+

PHP XML Parser 函数