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
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, può
essere passato anche un array contenente un riferimento ad oggetto e un
nome di metodo.