xml_set_external_entity_ref_handler

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.