xml_set_default_handler

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

xml_set_default_handler — 建立默认处理程序

说明

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

为 parser 指定的 XML 处理程序建立默认处理函数。

参数

parser

XML 解析器。

handler

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

警告

空字符串也可以重置处理程序,然而自 PHP 8.4.0 起已弃用。

如果 handler 是 callable ,设置的 callable 将作为处理程序。

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

警告

自 PHP 8.4.0 起弃用。

警告

自 PHP 8.4.0 起,在设置处理程序时会检测 callable 是否有效,而不是在调用时检测。这意味着在将字符串方法名设置为 callback 之前必须调用 xml_set_object() 。然而,由于此行为自 PHP 8.4.0 起也已弃用,因此建议为该方法使用适当的callable 。

处理程序的签名必须是:

function handler(XMLParser $parser, string $data): void

parser: XML 解析器调用的处理程序。
data: data 包含字符数据。可以是 XML 声明、文档类型声明、实体名或者其它没有已存在处理程序的数据。

返回值

总是返回 true 。

更新日志

版本	说明
8.4.0	现已弃用传递非 callable 的 string 到 `handler`,为方法使用适当的 callable 或者使用 `null` 来重置处理程序。
8.4.0	现在设置处理程序时会检测 `handler` 作为 callable 的有效性,而不是在调用时检测。
8.0.0	`parser` 现在接受 XMLParser 实例;之前接受有效的 `xml` resource 。

发现了问题?

了解如何改进此页面 • 提交拉取请求 • 报告一个错误

+添加备注

用户贡献的备注 3 notes

down

jp dot amarok at email dot cz ¶

2 years ago

For anyone who was also wondering what kind of events this function actually handles:
it's used in cases when an XML comment is found or an additional declaration like an xml-stylesheet. In such cases the data argument contains the whole string as it is, for example:
<!-- this is a comment -->
<?xml-stylesheet title="mystyle" type="text/xsl" href="style.xsl" ?>

down

-2

phillip ¶

21 years ago

it seems to me that in PHP5 the function defined as default-handler (using xml_set_default_handler()) doesen't get passed the cdata anymore:
i.e.:
xml_set_element_handler($this->parser, 'parseSTART', 'parseEND');
xml_set_default_handler($this->parser, 'parseDEFAULT');
function parseSTART() { ... }
function parseEND() { ... }
function parseDEFAULT() { ... } 
under PHP5, parseDEFAULT will NOT get passed any cdata, but unter PHP4 it will. at least that's my take on the strange stuff (not) happening after migrating to PHP5.
my solution was to add a xml_set_character_data_handler($parser, 'parseDEFAULT'). it worked for me.

down

-3

anoril at anoril dot com ¶

19 years ago

I have the same issue using two installation of PHP5: on accepts to use the default handler while the other only uses the character_data one.
Maybe a configuration problem...
;) Nonor.