xml_set_unparsed_entity_decl_handler
(PHP 4, PHP 5)
xml_set_unparsed_entity_decl_handler — Imposta il gestore delle dichiarazioni di entità non analizzate
Descrizione
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 ilparser.La funzione indicata da
handlerdeve 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.
