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
Valorizza la funzione del gestore dei riferimenti a entità esterne per il
parser XML parser.
Elenco dei parametri
-
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 ilparser.La funzione chiamata
handlerdeve 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.handler ( resource$parser, string$open_entity_names, string$base, string$system_id, string$public_id)-
parser - Il primo parametro, parser, è un riferimento al parser XML che chiama il gestore.
-
open_entity_names -
Il secondo parametro,
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 -
Questa è la base per risolvere l'identificatore del sistema
(
system_id) delle entità esterne.Attualmente questo parametro sarà sempre impostato ad una stringa vuota. -
system_id -
Il quarto parametro,
system_id, è l' identificatore del sistema come specificato nella dichiarazione delle entità. -
public_id -
Il quinto parametro,
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.
-
Valori restituiti
Restituisce TRUE in caso di successo, FALSE in caso di fallimento.
