CLXXX. 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.org/sablotron.html. 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 -- Returns an error string
- 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