Forum und email

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.