xml_set_unparsed_entity_decl_handler
(PHP 3 >= 3.0.6, PHP 4, PHP 5)
xml_set_unparsed_entity_decl_handler -- Valorizza il gestore delle dichiarazioni di entità non analizzateDescrizione
bool xml_set_unparsed_entity_decl_handler ( resource parser, callback gestore )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:
gestore ( resource parser, string nome_entità, string base, string system_id, string public_id, string nome_notazione )
- 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 è possibile passare un vettore contenente un riferimento ad un oggetto e un nome di metodo.