PHP Conference Japan 2024

xml_set_unparsed_entity_decl_handler

(PHP 4, PHP 5, PHP 7, PHP 8)

xml_set_unparsed_entity_decl_handler 设置未解析实体声明处理程序

描述

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

为 XML 解析器 parser 设置未解析实体声明处理程序函数。

如果 XML 解析器遇到带有 NDATA 声明的外部实体声明,则将调用 handler,例如:

<!ENTITY <parameter>name</parameter> {<parameter>publicId</parameter> | <parameter>systemId</parameter>}
        NDATA <parameter>notationName</parameter>

参见 » XML 1.0 规范的 4.2.2 节,了解已声明为外部实体的符号的定义。

参数

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 $entity_name,
    string|false $base,
    string $system_id,
    string|false $public_id,
    string|false $notation_name
): void
parser
调用处理程序的 XML 解析器。
entity_name
即将定义的实体的名称。
base
这是解析外部实体的系统标识符 (systemId) 的基准。
system_id
外部实体的系统标识符。
public_id
外部实体的公共标识符。
notation_name
此实体的符号名称(参见 xml_set_notation_decl_handler())。

返回值

始终返回 true

变更日志

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

用户贡献的注释

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