PHP xml_set_unparsed_entity_decl_handler() 函数


PHP xml_set_unparsed_entity_decl_handler() 函数


定义和用法

xml_set_unparsed_entity_decl_handler() 函数规定当解析器在 XML 文档中找到无法解析的实体时被调用的函数。

如果成功,该函数则返回 TRUE。如果失败,则返回 FALSE。

语法

xml_set_unparsed_entity_decl_handler(parser,handler)
参数 描述
parser 必需。规定要使用的 XML 解析器。
handler 规定当解析器找到无法解析的实体时被调用的函数。

由 "handler" 参数规定的函数必须有六个参数:

参数 描述
parser 必需。规定一个变量,包含调用处理器的 XML 解析器。
name 必需。规定一个变量,包含实体名称。
base 必需。规定一个变量,包含解析实体的系统标识符(system_id)的基础。当前该参数通常都被设置为 NULL。
system_id 必需。规定一个变量,包含实体的系统标识符。
public_id 必需。规定一个变量,包含实体的公共标识符。
notation 必需。规定一个变量,包含标识实体数据类型的符号。

提示和注释

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

实例

<?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 Error: %s at line %d",  
xml_error_string(xml_get_error_code($parser)),  
xml_get_current_line_number($parser)));  
}  

xml_parser_free($parser);  
?>