xml_set_external_entity_ref_handler
(PHP 4, PHP 5)
xml_set_external_entity_ref_handler — Establecer gestor de referencias de entidades externas
Descripción
bool xml_set_external_entity_ref_handler
( resource $analizador
, callback $gestor
)
Define la función de gestién de referencias de entidades externas para el
anazilador XML analizador
.
Lista de parámetros
-
analizador
-
-
gestor
-
gestor
es una cadena que contiene el nombre de
una función que debe existir al momento de llamar
xml_parse() para su uso con
analizador
.
La función nombrada por gestor
debe aceptar
cinco parámetros, y debería devolver un valor entero. Si el valor
devuelto desde el gestor es FALSE (lo cual ocurrirá si no se
devuelve un valor), el analizador XML dejará de trabajar y
xml_get_error_code() devolverá
XML_ERROR_EXTERNAL_ENTITY_HANDLING.
gestor
( resource $analizador
, string $nombres_entidades_abiertas
, string $base
, string $id_sistema
, string $id_publico
)
-
analizador
-
El primer parámetro, analizador, es una
referencia al analizador XML que llama al gestor.
-
nombres_entidades_abiertas
-
El segundo parámetro,
nombres_entidades_abiertas
, es una lista
separada por espacios de los nombres de las entidades que se
abren para el análisis de esta entidad (incluyendo el nombre de
la entidad referenciada).
-
base
-
Esta es la base para resolver el identificador de sistema
(id_sistema
) de la entidad externa. En la
actualidad este parámetro es siempre la cadena vacía.
-
id_sistema
-
El cuarto parámetro, id_sistema
, es el
identificador del sistema tal como se especificó en la
declaración de la entidad.
-
id_publico
-
El quinto parámetro, id_publico
, 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 la especificación de XML.
Si una función gestora se define como la cadena vacía, o FALSE,
el gestor en cuestión se deshabilita.
Note: En lugar de un nombre de
función, se puede proporcionar una matriz que contenga una
referencia a un objeto o el nombre de un
método.
Valores retornados
Devuelve TRUE si todo se
llevó a cabo correctamente, FALSE en caso
de fallo.