(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.
