PHP xml_set_external_entity_ref_handler() 函数

定义和用法

xml_set_external_entity_ref_handler() 函数用于指定当解析器在 XML 文档中找到外部实体时要调用的函数。

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

实例

创建一个 XML 解析器,设置字符数据处理程序,设置外部实体引用处理程序,并解析 XML 文档:

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

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

function ext_ent_handler($parser, $ent, $base, $sysID, $pubID)  {
  echo "$ent<br>";
  echo "$sysID<br>";
  echo "$pubID<br>";
}

// 设置字符数据处理程序
xml_set_character_data_handler($parser, "char");

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

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

while ($data = fread($fp, 4096)) {
  // 解析 XML 数据
  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_external_entity_ref_handler(parser, handler)
参数 描述
parser 必需。指定要使用的 XML 解析器
handler

必需。指定用作事件处理程序的函数。该函数必须接受五个参数:

  • $parser - 包含调用处理程序的 XML 解析器的变量
  • $name - 包含外部实体名称的变量
  • $base - 用于解析外部实体的系统标识符(system_id)的基础。目前,这始终是空字符串
  • $system_id - 实体声明中指定的系统标识符
  • $public_id - 实体声明中指定的公共标识符

技术细节

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