xml_set_start_namespace_decl_handler

(PHP 4 >= 4.0.5, PHP 5, PHP 7, PHP 8)

xml_set_start_namespace_decl_handler — 设置起始命名空间声明处理程序

说明

xml_set_start_namespace_decl_handler(XMLParser $parser, callable $handler): true

设置在声明命名空间时要调用的处理程序。命名空间声明出现在开始标签内。 But the namespace declaration start handler is called before the start tag handler for each namespace declared in that start tag.

参数

parser

指向 XML 解析器。

handler

handler 是字符串，包含为 parser 调用 xml_parse() 时，必须存在的函数名。

以 handler 命名的函数必须接受三个参数，并且应该返回整数值。如果从处理程序返回的值为 false（如果没有返回值，则为 false），XML 解析器将停止解析并且 xml_get_error_code() 将返回 XML_ERROR_EXTERNAL_ENTITY_HANDLING。

handler(XMLParser $parser, string $prefix, string $uri)
parser
第一个参数 parser 指向调用处理程序的 XML 解析器。
prefix
前缀是一个字符串，用于引用 XML 对象中的命名空间。
uri
命名空间的统一资源标识符 (URI)。

如果处理函数设置为空字符串或 false，则禁用相关处理程序。

Note: 除了函数名，含有对象引用的数组和方法名也可以作为参数。

返回值

总是返回 true。

更新日志

版本 说明
8.0.0 parser 现在接受 XMLParser 实例；之前接受有效的 xml resource。

参见