xml_set_external_entity_ref_handler

xml_set_external_entity_ref_handler

(PHP 3 >= 3.0.6, PHP 4, PHP 5)

xml_set_external_entity_ref_handler -- Establece gestores de referencia de entidades externas

Descripci贸n

int xml_set_external_entity_ref_handler ( int parser, string handler )

Establece la funci贸n gestora de declaraciones de notaci贸n para el analizador XML parser. handler es un string que contiene el nombre de una funci贸n que debe existir cuando xml_parse() es llamado por parser.

La funci贸n llamada por handler debe aceptar cinco par谩metros, y deber铆a devolver un valor entero. Si el valor devuelto desde el gestor (handler) es falso (lo cual ocurrir谩 si no se devuelve un valor), el analizador XML dejar谩 de analizar y xml_get_error_code() devolver谩 XML_ERROR_EXTERNAL_ENTITY_HANDLING. int handler ( int parser, string openEntityNames, string base, string systemId, string publicId )

parser

El primer par谩metro, parser, es una referencia al analizador XML que llama al gestor.

openEntityNames

El segundo par谩metro, openEntityNames, es una lista, separada por espacios, de los nombres de las entidades que se abren para el an谩lisis de esta entidad (incluido el nombre de la entidad referenciada).

base

Esta es la base para resolver el identificador de sistema (systemid) de la entidad externa. En la actualidad este par谩metro es siempre la cadena vac铆a.

systemId

El cuarto par谩metro, systemId, es el identificador del sistema tal como se especific贸 en la declaraci贸n de la entidad.

publicId

El quinto par谩metro, publicId, es el identificador p煤blico como se especific贸 en la declaraci贸n de la entidad, o una cadena vac铆a si no se especific贸 ninguno; el espacio en blanco en el identificador p煤blico se habr谩 normalizado como se requiere en las especificaciones XML.

Si una funci贸n gestora se establece como la cadena vac铆a, o FALSE, el gestor en cuesti贸n se deshabilita.

Se devuelve TRUE si se estableci贸 el gestor, FALSE si parser no es un analizador.

En la actualidad no hay soporte para gestores objeto/m茅todo.