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