(PHP 4, PHP 5, PHP 7, PHP 8)
xml_set_external_entity_ref_handler — Set up external entity reference handler
Sets the external entity reference handler function for the XML parser
parser
.
parser
The XML parser.
handler
If null
or an empty string is passed, the handler is reset to its default state.
If handler
is a callable,
the callable is set as the handler.
If handler
is a string,
it can be the name of a method of an object set with
xml_set_object().
The signature of the handler must be:
$parser
,$open_entity_names
,$base
,$system_id
,$public_id
parser
open_entity_names
base
system_id
) of the external entity.
system_id
public_id
The handler should return true
if the entity was handled,
false
otherwise.
When returning false
the XML parser will stop parsing and
xml_get_error_code() will return
XML_ERROR_EXTERNAL_ENTITY_HANDLING
.
Always returns true
.
Version | Description |
---|---|
8.0.0 |
parser expects an XMLParser
instance now; previously, a valid xml resource was expected.
|
7.3.0 |
The return value of the handler is no longer
ignored if the extension has been built against libxml. Formerly, the return
value has been ignored, and parsing did never stop.
|