xml_set_external_entity_ref_handler
(PHP 4, PHP 5)
xml_set_external_entity_ref_handler — Valorizza il gestore dei riferimenti a entità esterne
Descrizione
Indica al parser XML parser la funzione per la gestione dei riferimenti a entità esterne. Il gestore è una stringa contenente il nome di una funzione che deve esistere quando viene eseguita la funzione xml_parse() per il parser .
La funzione indicata da gestore deve accettare cinque parametri, e dovrebbe restituire un intero. Se il valore restituito dal gestore è FALSE (valore assunto per default in caso di nessun valore restituito), il parser XML ferma l'elaborazione e xml_get_error_code() restituirà XML_ERROR_EXTERNAL_ENTITY_HANDLING.
- parser
- Il primo parametro, parser, è il riferimento al parser XML chiamante il gestore.
- nome_entita_aperte
- Il secondo parametro, nomi_entita_aperte , è una lista di nomi, separati da spazio, delle entità che saranno aperte per il parsing di questa entità (compreso il nome dell'entità indicata)
- 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
- Il quarto parametro, system_id , è l'identificatore system come specificato nella dichiarazione dell'entità.
- public_id
- Il quinto parametro, public_id , è l'identificatore public come specificato nella dichiarazione dell'entità, oppure una stringa vuota se non viene specificato; lo spazio nell'identificatore public è normalizzato come richiesto dalle specifiche XML.
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.