xml_set_unparsed_entity_decl_handler
(PHP 4, PHP 5)
xml_set_unparsed_entity_decl_handler — Valorizza il gestore delle dichiarazioni di entità non analizzate
Descrizione
Indica al parser XML parser la funzione per la gestione delle dichiarazioni di entità non analizzate. Il gestore è una stringa contenente il nome di una funzione che deve esistere quando viene eseguita la funzione xml_parse() per il parser .
Questo gestore viene richiamato quando il parser XML incontra una dichiarazione di entità esterna con una dichiarazione NDATA, tipo 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 di notazioni dichiarate in entità esterne.
La funzione indicata da gestore deve accettare sei parametri:
- parser
- Il primo parametro, parser, è il riferimento al parser XML chiamante il gestore.
- nome_entità
- Il nome dell'entità che sta per essere definita.
- base
- Questa è la base per la risoluzione dell'identificatore system (systemid ) delle entità esterne. Attualmente questo parametro è sempre valorizzato con una stringa vuota.
- system_id
- Identificatore system per l'entità esterna.
- public_id
- Identificatore public per l'entità esterna.
- nome_notazione
- Nome della notazione di questa entità (vedere xml_set_notation_decl_handler()).
Se il nome della funzione del gestore viene valorizzato con una stringa vuota oppure a FALSE, il gestore in questione viene disabilitato.
La funzione restituisce TRUE se il gestore viene attivato, FALSE se parser non indica un parser XML.
Nota: Invece di un nome di funzione, può essere passato anche un array contenente un riferimento ad oggetto e un nome di metodo.