Manuale PHP
Indietro |  | Avanti

# CLXV. 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 spostato nel repository PECL e non sarà più rilascio con il PHP dalla versione 5.0.0.

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

Indietro | Partenza | Avanti
XSLTProcessor->transformToXML() | Risali | xslt_backend_info