L'extension XSL se base sur les spécifications XSLT (XSL Transformations 1.0) édictées par le W3C.
L'extension XSL permet d'effectuer des transformations d'un document XML selon une feuille de style XSLT.
L'extension XSL s'appuie sur la bibliothèque libxslt.
Par défaut, l'extension XSL est inclut dans PHP5. Nénanmoins, il peut être nécessaire de l'activer en ajoutant l'argument --with-xsl[=répertoire_libxslt] dans les directives de compilation. Pour Windows, il faut placer le fichier php_xsl.dll dans le répertoire SYSTEM[32] et suprimer le point-virgule désactivant l'extension extension=php_xsl.dll dans le fichier de configuration php.ini.
| Fonction |
|---|
| Description |
| $procXSL = $XSLTProcessor->__construct(); |
| crée un nouvel objet XSLTProcessor à l'aide d'une instanciation de classe (ex.: $proc = new XSLTProcessor();). |
| $param = XSLTProcessor->getParameter( string URI_espace_noms, string nom_local); |
| retourne la valeur d'un paramètre précédemment défini par la fonction XSLTProcessor->setParameter(). |
| $booleen = XSLTProcessor->hasExsltSupport(); |
| indique si PHP utilise l'extension EXSLT. |
| XSLTProcessor->importStylesheet(DOMDocument styleXSL); |
| importe une feuille de style XSLT. |
| XSLTProcessor->registerPHPFunctions([mixed restriction]); |
| active l'utilisation de fonctions PHP en tant que fonctions XSLT dans les feuilles de styles XSLT. |
| $booleen = XSLTProcessor->removeParameter( string URI_espace_noms, string nom_local); |
| Efface un paramètre |
| $booleen = XSLTProcessor->setParameter( string URI_espace_noms, (string nom, string valeur)|array options); |
| définit la ou les valeurs d'un ou plusieurs paramètres pour être utilisé lors du processus de transformation. Le tableau options doit contenir des paires nom/valeur. |
| $document = XSLTProcessor->transformToDoc(DOMNode noeud); |
| transforme le noeud spécifié en un objet DOMDocument. |
| $nb_octets|false = XSLTProcessor->transformToURI(DOMDocument doc, string uri); |
| transforme le document en une URI en y appliquand la feuille de style donnée par la méthode XSLTProcessor->importStylesheet(). |
| $resultat = XSLTProcessor->transformToXML(DOMDocument doc); |
| transforme le document XML en y appliquand une feuille de style donnée par la méthode XSLTProcessor->importStylesheet(). |
| Constante | Valeur | Description |
|---|---|---|
| XSL_CLONE_AUTO | 0 | |
| XSL_CLONE_NEVER | -1 | |
| XSL_CLONE_ALWAYS | 1 |
<?php
// Chargement du document XML
$xml = new DOMDocument;
$xml->load('logitheque.xml');
// Chargement de la feuille de style
$xsl = new DOMDocument;
$xsl->load('param.xsl');
// Création du processeur XSLT
$proc = new XSLTProcessor;
//Affectation de la feuille de style
$proc->importStyleSheet($xsl);
// Transformation du document XML selon la feuille XSL
echo $proc->transformToXML($xml);
?>