xml_set_external_entity_ref_handler
(PHP 3 >= 3.0.6, PHP 4, PHP 5)
xml_set_external_entity_ref_handler -- Valorizza il gestore dei riferimenti a entitā esterneDescrizione
bool xml_set_external_entity_ref_handler ( resource parser, callback gestore )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.
gestore ( resource parser, string nomi_entita_aperte, string base, string system_id, string public_id )
- 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 č possibile passare un vettore contenente un riferimento ad un oggetto e un nome di metodo.