xml_set_unparsed_entity_decl_handler

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

xml_set_unparsed_entity_decl_handler — Imposta il gestore delle dichiarazioni di entità non analizzate

Descrizione

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

Imposta la funzione del gestore delle dichiarazioni di entità non analizzate per il parser XML parser.

L'handler sarà chiamato se il parser XML incontra una dichiarazione di un'entità esterna con una dichiarazione NDATA, come la seguente:

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

Vedere » la sezione 4.2.2 delle specifiche di XML 1.0 per la definizione della notazione di entità esterne dichiarate.

Elenco dei parametri

parser

Un riferimento al parser XML per impostare la funzione del gestore delle dichiarazioni delle entità non analizzate.

handler

handler è una stringa contenente il nome di una funzione che deve esistere quando xml_parse() è chiamata per il parser.

La funzione indicata da handler deve accettare sei parametri:

handler(
    resource $parser,
    string $entity_name,
    string $base,
    string $system_id,
    string $public_id,
    string $notation_name
)

parser: Il primo parametro, parser, è un riferimento al parser XML che chiama il gestore.
entity_name: Il nome di una entità che sta per essere definito.
base: Questa è la base per risolvere l'identificatore del sistema (system_id) delle entità esterne.Attualmente questo parametro sarà sempre impostato ad una stringa vuota.
system_id: Identificatore del sistema per le entità esterne.
public_id: Identificatore pubblico per le entità esterne.
notation_name: Nome della notazione per questa entità (vedere xml_set_notation_decl_handler()).

Se una funzione di gestione è impostata con una stringa vuota, oppure false, il gestore in questione è disabilitato.

Nota: Invece di un nome di funzione, può essere passato anche un array contenente un riferimento ad oggetto e un nome di metodo.

Valori restituiti

Restituisce true in caso di successo, false in caso di fallimento.