(PHP 4, PHP 5, PHP 7, PHP 8)
xml_set_external_entity_ref_handler — Valorizza il gestore dei riferimenti a entità esterne
Valorizza la funzione del gestore dei riferimenti a entità esterne per il
parser XML parser
.
parser
Un riferimento al parser XML per impostare la funzione del gestore dei riferimenti a entità esterne.
handler
handler
è una stringa contenente il nome di una
funzione che deve esistere quando xml_parse() è chiamata
per il parser
.
La funzione chiamata handler
deve accettare
cinque parametri, e dovrebbe ritornare un numero intero. Se il
valore restituito dall'handler è false
(che sarà se non è
restituito nessun valore), il parser XML fermerà il parsing e
xml_get_error_code() restituirà
XML_ERROR_EXTERNAL_ENTITY_HANDLING
.
$parser
,$open_entity_names
,$base
,$system_id
,$public_id
parser
open_entity_names
open_entity_names
, è un
elenco separato da spazi dei nomi delle entità che sono aperti per
l'analisi di queste entità (incluso il nome dell'entità
referenziata).
base
system_id
) delle entità esterne.Attualmente
questo parametro sarà sempre impostato ad una stringa vuota.
system_id
system_id
, è l'
identificatore del sistema come specificato nella dichiarazione delle entità.
public_id
public_id
, è l'
identificatore pubblico come specificato nella dichiarazione delle entità, oppure
una stringa vuota se non è stato specificato; lo spazio nell'
identificatore pubblico sarà normalizzato come richiesto dalle
specifiche di XML.
Se una funzione di gestione è impostata con una stringa vuota, oppure false
, il gestore
in questione è disabilitato.
Nota: Invece di un nome di funzione, può essere passato anche un array contenente un riferimento ad oggetto e un nome di metodo.