Manuale PHP
Indietro		Avanti

CXXXVIII. Funzioni XSLT

Introduzione

Questo modulo PHP consiste in un processore, basato su API indipendenti, per le trasformazioni XSLT. Attualmente questo modulo supporta la libreria Sablotron di Ginger Alliance. E' previsto di estendere il supporto ad altre librerie, quali Xalan o le librerie libxslt.

XSLT (Extensible Stylesheet Language (XSL) Transformations) è un linguaggio per trasformare documenti XML in altri documenti XML. E' uno standard definito dal World Wide Web consortium (W3C). Informazioni circa l' XSLT e le relative tecnologie possono essere trovate su http://www.w3.org/TR/xslt.

Nota: Questa estensione è differente dall'estensione sablotron distribuita con le versioni del PHP precedenti PHP 4.1, attualmente è supportata nel PHP 4.1 solo la nuova estensione XSLT. Se hai bisogno di supporto per le vecchie estensioni, fai la tua domanda sulla mailing list php-general@lists.php.net.

Nota: Questo modulo ` stato rimosso da PHP 5 ed inserito tra le librerie PECL.

Nota: Se occorre il supporto xslt in PHP 5 utilizzare il modulo XSL.

Requisiti

Questo modulo utilizza le librerie Sablotron e expat, che possono essere reperite all'indirizzo http://www.gingerall.com/. E' disponibile sia la versione binaria sia la versione con i sorgenti.

Installazione

Nei sistemi UNIX, eseguire configure con le opzioni --enable-xslt --with-xslt-sablot. La libreria Sablotron deve essere installata in una posizione accessibile al compilatore.

Accertarsi di utilizzare per il PHP le medesime librerie utilizzate per Sablotron. I parametri di configurazione sono: --with-expat-dir=DIR --with-iconv-dir=DIR. Quando si chiede supporto, ricordarsi di citare sempre queste impostazioni, e dove sono installate altre versioni di queste librerie nel sistema. Ovviemente fornire i numeri di versione.

Attenzione

Accertarsi che la libreria Sablot sia compilata con -lstdc++ altrimenti potrebbe fallire il processo di configurazione oppure il PHP non essere in grado di caricare la libreria.

Supporto per JavaScript E-XSLT: Se si compila Sablotron con il supporto JavaScript, occorre indicare il parametro: --with-sablot-js=DIR.

Nota per gli utenti Win32: Per potere abilitare questo modulo sui sistemi Windows, occorre copiare diversi file dalla directory PHP/Win32 del rilascio di PHP alla directory SYSTEM32 della macchina. (Es: C:\WINNT\SYSTEM32 oppure C:\WINDOWS\SYSTEM32). In PHP <= 4.2.0 copiare sablot.dll e expat.dll nella cartella SYSTEM32. In PHP >= 4.2.1 copiare sablot.dll, expat.dll e iconv.dll nella cartella SYSTEM32.

Configurazione di Runtime

Questa estensione non definisce alcuna direttiva di configurazione in php.ini

Tipi di risorse

Questa estensione non definisce alcun tipo di risorsa.

Costanti predefinite

Queste costanti sono definite da questa estensione e sono disponibili solo se l'estensione è stata compilata nel PHP o se è stata caricata dinamicamente a runtime.

XSLT_OPT_SILENT (integer): Rimuove i messaggi di log e di errore. Questa è una generica opzione che potrà essere aggiunta in futuro.
XSLT_SABOPT_PARSE_PUBLIC_ENTITIES (integer): Indica a Sablotron di considerare tutte le entità pubbliche. Per default è impostata a off.
XSLT_SABOPT_DISABLE_ADDING_META (integer): Non aggiungere i tag "Content-Type" nell'output HTML. Il default viene impostato in fase di compila di Sablotron.
XSLT_SABOPT_DISABLE_STRIPPING (integer): Sopprime la rimozione degli spazi (solo sui file di dati).
XSLT_SABOPT_IGNORE_DOC_NOT_FOUND (integer): Considera non risolti i documenti (la funzione document() ) non letali.
XSLT_SABOPT_FILES_TO_HANDLER (integer)
XSLT_ERR_UNSUPPORTED_SCHEME (integer): Codice di errore restituito da scheme handlers.

Sommario
xslt_backend_info -- Returns the information on the compilation settings of the backend
xslt_backend_name -- Returns the name of the backend
xslt_backend_version -- Returns the version number of Sablotron
xslt_create -- Crea un nuovo processore XSLT
xslt_errno -- Restituisce un numero di errore
xslt_error -- Restituisce una stringa di errore
xslt_free -- Libera un processore XSLT
xslt_getopt -- Get options on a given xsl processor
xslt_process -- Esegue una trasformazione XSLT
xslt_set_base -- Imposta l'URI di base per tuttte le trasformazioni XSLT
xslt_set_encoding -- Imposta l'encoding per il parsing dei documenti XML
xslt_set_error_handler -- Imposta un error handler per un processore XSLT
xslt_set_log -- Imposta il file di log per scrivere i messaggi di log
xslt_set_object -- Sets the object in which to resolve callback functions
xslt_set_sax_handler -- Imposta un handler SAX per un processore XSLT
xslt_set_sax_handlers -- Imposta gli handler SAX da richiamare quando il document XML viene processato
xslt_set_scheme_handler -- Imposta lo schema dell'handler per un processore XSLT
xslt_set_scheme_handlers -- Imposta lo schema degli handler per un processore XSLT
xslt_setopt -- Set options on a given xsl processor

Indietro	Partenza	Avanti
XSLTProcessor->transformToXML()	Risali	xslt_backend_info