xml_set_unparsed_entity_decl_handler
(PHP 3>= 3.0.6, PHP 4 )
xml_set_unparsed_entity_decl_handler -- Set up unparsed entity declaration handlerDescription
bool xml_set_unparsed_entity_decl_handler ( resource parser, callback handler)Sets the unparsed entity declaration handler function for the XML parser parser . handler is a string containing the name of a function that must exist when xml_parse() is called for parser .
This 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.
The function named by
handler
must accept six parameters:
handler
( resource parser, string entity_name, string base, string system_id, string public_id, string notation_name)
The first parameter, parser , is a reference to the XML parser calling the handler.
entity_nameThe name of the entity that is about to be defined.
baseThis is the base for resolving the system identifier ( systemId ) of the external entity. Currently this parameter will always be set to an empty string.
system_idSystem identifier for the external entity.
public_idPublic identifier for the external entity.
notation_nameName of the notation of this entity (see xml_set_notation_decl_handler()).
If a handler function is set to an empty string, or FALSE , the handler in question is disabled.
TRUE is returned if the handler is set up, FALSE if parser is not a parser.
Note: Instead of a function name, an array containing an object reference and a method name can also be supplied.
