Manuale PHP
Indietro |  | Avanti

# xml_set_external_entity_ref_handler

(PHP 3 >= 3.0.6, 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 è possibile passare un vettore contenente un riferimento ad un oggetto e un nome di metodo.

Indietro | Partenza | Avanti
xml_set_end_namespace_decl_handler | Risali | xml_set_notation_decl_handler