PHP Conference Nagoya 2025

xml_set_unparsed_entity_decl_handler

(PHP 4, PHP 5, PHP 7, PHP 8)

xml_set_unparsed_entity_decl_handlerConfigura el manejador de declaración de entidades no analizadas

Descripción

xml_set_unparsed_entity_decl_handler(XMLParser $parser, callable $handler): bool

Configura la función del manejador de declaración de entidades no analizadas para el intérprete XML parser.

El handler será llamado si el intérprete XML encuentra una declaración de entidad externa con una declaración NDATA, como la siguiente:

<!ENTITY <parameter>name</parameter> {<parameter>publicId</parameter> | <parameter>systemId</parameter>}
        NDATA <parameter>notationName</parameter>

Para la definición de notación de NDATA ver » sección 4.2.2 de las especificaciones XML 1.0.

Parámetros

parser

Identificador del recurso del intérprete XML para el que se va a configurar la función del manejador de declaración de entidades no analizadas.

handler

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 mediante handler debe aceptar seis parámetros:

handler(
    XMLParser $parser,
    string $entity_name,
    string $base,
    string $system_id,
    string $public_id,
    string $notation_name
)
parser
El primer parámetro, parser, hace referencia al intérprete XML que llama al manejador.
entity_name
El nombre de la entidad que está a punto de definirse.
base
Esta es la base para resolver el identificador de sistema (system_id) de la declaración de notación. Actualmente este parámetro siempre se establecerá como una cadena vacia.
system_id
Identificador de sistema de la declaración de notación externa.
public_id
Identificador público de la declaración de notación externa.
notation_name
Nombre de la notación de esta entidad (ver xml_set_notation_decl_handler()).

Si la función del manejador se configura como una cadena vacia, o false, el manejador en cuestión se deshabilita.

Nota: En lugar del nombre de una función, se puede asignar un array que contenga la referencia a un objeto o el nombre de un método.

Valores devueltos

Devuelve true en caso de éxito o false en caso de error.

Historial de cambios

Versión Descripción
8.0.0 parser expects an XMLParser instance now; previously, a valid xml resource was expected.
add a note

User Contributed Notes

There are no user contributed notes for this page.
To Top