Valorizza il gestore dei riferimenti a entità esterne

Descrizione

bool xml_set_external_entity_ref_handler ( resource $parser , callable $handler )

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 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.

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.