xml_set_notation_decl_handler

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

xml_set_notation_decl_handler — Configura el gestor XML de notaciones

Descripción

Establece los gestores de inicio y fin del analizador XML parser.

Una notación es una parte del DTD del documento, que tiene el formato siguiente:

<!NOTATION <parameter>name</parameter>
{ <parameter>systemId</parameter> | <parameter>publicId</parameter>? }

Parámetros

parser

El analizador XML.

handler

Si null se pasa, el controlador se reinicia a su estado predeterminado.

Advertencia

Una cadena vacía también reiniciará el controlador, sin embargo esta funcionalidad está deprecada a partir de PHP 8.4.0.

Si handler es un callable , el callable se define como el controlador.

Si handler es una string , puede ser el nombre de un método de un objeto definido con xml_set_object() .

Advertencia

Esta funcionalidad está deprecada a partir de PHP 8.4.0.

Advertencia

A partir de PHP 8.4.0, se verifica la validez del callable durante la configuración del controlador, y no en el momento de su llamada. Esto significa que xml_set_object() debe ser llamado antes de definir un método como cadena como devolución de llamada. Sin embargo, como este comportamiento también está deprecado a partir de PHP 8.4.0, se recomienda utilizar un callable adecuado para el método.

La firma del gestor debe ser:

function handler(
XMLParser $parser,
string $notation_name,
string |false $base,
string $system_id,
string |false $public_id
): void

parser

El analizador XML que llama al controlador.

notation_name

El nombre de la notación, como se especifica en el formato de notación anterior.

base

La raíz para la resolución del identificador de sistema (system_id) de la entidad externa.

system_id

Identificador de sistema para esta entidad externa.

public_id

Identificador público para esta entidad externa.

Valores devueltos

Retorna siempre true .

Historial de cambios