(PHP 4, PHP 5, PHP 7)
xml_set_unparsed_entity_decl_handler — Set up unparsed entity declaration handler
xml_set_unparsed_entity_decl_handler ( XMLParser $parser , callable $handler ) : bool
Sets the unparsed entity declaration handler function for the XML parser parser
.
The handler
will be called if the XML parser encounters an external entity declaration with an NDATA declaration, like the following:
<!ENTITY <parameter>name</parameter> {<parameter>publicId</parameter> | <parameter>systemId</parameter>} NDATA <parameter>notationName</parameter>
See » section 4.2.2 of the XML 1.0 spec for the definition of notation declared external entities.
parser
A reference to the XML parser to set up unparsed entity declaration handler function.
handler
handler
is a string containing the name of a function that must exist when xml_parse() is called for parser
.
The function named by handler
must accept six parameters:
handler ( XMLParser $parser , string $entity_name , string $base , string $system_id , string $public_id , string $notation_name )
parser
entity_name
base
systemId
) of the external entity.Currently this parameter will always be set to an empty string. system_id
public_id
notation_name
If a handler function is set to an empty string, or false
, the handler in question is disabled.
Note: Instead of a function name, an array containing an object reference and a method name can also be supplied.
Returns true
on success or false
on failure.
Version | Description |
---|---|
8.0.0 | parser expects an XMLParser instance now; previously, a resource was expected. |
© 1997–2020 The PHP Documentation Group
Licensed under the Creative Commons Attribution License v3.0 or later.
https://www.php.net/manual/en/function.xml-set-unparsed-entity-decl-handler.php