PHP Conference Japan 2024

xml_set_notation_decl_handler

(PHP 4、PHP 5、PHP 7、PHP 8)

xml_set_notation_decl_handler设置符号声明处理程序

描述

xml_set_notation_decl_handler(XMLParser $parser, callable|string|null $handler): true

为 XML 解析器 parser 设置符号声明处理程序函数。

符号声明是文档 DTD 的一部分,具有以下格式

<!NOTATION <parameter>name</parameter>
{ <parameter>systemId</parameter> | <parameter>publicId</parameter>?>
请参阅 » XML 1.0 规范的第 4.7 节,了解符号声明的定义。

参数

parser

XML 解析器。

handler

如果传递了null,则处理程序将重置为其默认状态。

警告

空字符串也会重置处理程序,但这已自 PHP 8.4.0 起弃用。

如果 handler 是一个 callable,则该可调用对象将被设置为处理程序。

如果 handler 是一个 string,它可以是使用 xml_set_object() 设置的对象的方法名称。

警告

这已自 PHP 8.4.0 起弃用。

警告

自 PHP 8.4.0 起,可调用对象在设置处理程序时会被检查是否有效,而不是在调用时检查。这意味着必须在将方法字符串设置为回调之前调用 xml_set_object()。但是,由于此行为也已自 PHP 8.4.0 起弃用,因此建议改用适当的 callable 来表示方法。

处理程序的签名必须为

handler(
    XMLParser $parser,
    string $notation_name,
    string|false $base,
    string $system_id,
    string|false $public_id
): void
parser
调用处理程序的 XML 解析器。
notation_name
这是符号的名称,根据上面描述的符号格式。
base
这是用于解析符号声明的系统标识符 (system_id) 的基础。
system_id
外部符号声明的系统标识符。
public_id
外部符号声明的公共标识符。

返回值

始终返回true

变更日志

版本 描述
8.4.0 将非 callable string 传递给 handler 现已弃用,请对方法使用适当的可调用对象,或使用null重置处理程序。
8.4.0 现在在设置处理程序时会检查 handler 作为 callable 的有效性,而不是在调用时检查。
8.0.0 parser 现在期望一个 XMLParser 实例;以前,期望一个有效的 xml resource
添加注释

用户贡献的注释

此页面没有用户贡献的注释。
To Top