PHP xml_set_processing_instruction_handler() 函数

定义和用法

xml_set_processing_instruction_handler() 函数用于指定当解析器在 XML 文档中找到处理指令(PI)时要调用的函数。

处理指令(PI)被包含在 <? 和 ?> 中,并包含一个目标及其数据。

示例:在这种情况下,PI 将一个样式表与 XML 文档关联起来:

<?xml version="1.0" encoding="UTF-8"?>
<?xml-stylesheet href="default.xsl" type="text/xml"?>
<note>
<to>Tove</to>
<from>Jani</from>
<heading>Reminder</heading>
<body>Don't forget me this weekend!</body>
</note>

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

实例

创建一个 XML 解析器,设置字符数据处理程序,设置处理指令(PI)处理程序,并解析 XML 文档(note_pi.xml):

<?php
$parser = xml_parser_create();

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

function pi_handler($parser, $target, $data) {
  echo "Target: $target<br />";
  echo "Data: $data<br />";
}

xml_set_character_data_handler($parser, "char");
// 设置处理指令(PI)处理程序
xml_set_processing_instruction_handler($parser, "pi_handler");
$fp = fopen("note_pi.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);
?>

运行实例

语法

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

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

  • $parser - 包含调用处理程序的 XML 解析器的变量
  • $target - 包含处理指令目标的变量
  • $data - 包含处理指令数据的变量

技术细节

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