CLXXXI. XSLT

Introduction

Cette extension PHP fourni une API indépendante pour les transformations XSLT. Actuellement, seul Sablotron est supporté. Le support d'autres bibliothèques comme Xalan ou libxslt est prévu.

XSLT (Extensible Stylesheet Language (XSL) Transformations) est un langage de transformation des documents XML en d'autres documents XML. C'est un standard défini par le consortium World Wide Web (W3C). Les informations sur le XLST et ses technologies sont disponibles à http://www.w3.org/TR/xslt.

Note : Cette extension est différente de l'extension sablotron qui était distribuée dans les versions de PHP avant la 4.1. Actuellement, seule la nouvelle extension XSLT est supportée. Si vous souhaitez un support pour les anciennes extensions, posez vos questions sur les listes de diffusion PHP.

Note : Cette extension a été déplacée dans le module PECL et ne sera plus intégrée dans PHP à partir de PHP 5.0.0.

Note : Si vous avez besoin du support xslt avec PHP 5, vous pouvez utiliser l'extension XSL.

Pré-requis

Cette extension utilise Sablotron et expat, qui sont toutes les deux disponibles à http://www.gingerall.org/sablotron.html. Les sources comme les exécutables sont proposés.

Installation

Sous UNIX, lancez configure avec l'option --with-sablot ou --with-xslt-sablot. La bibliothèque Sablotron doit être installée là où le compilateur peut la trouver.

Assurez-vous d'avoir la même bibliothèque, compilée avec Sablotron que celle qui est fournie avec PHP. Les options de configuration : --with-expat-dir=DIR --with-iconv-dir=DIR sont disponibles pour vous aider à les spécifier correctement. Lorsque vous demandez de l'aide, mentionnez toujours ces directives, ainsi que si vous avez d'autres bibliothèques installées sur votre système. Naturellement, fournissez les numéros de version.

Attention

Assurez-vous que votre bibliothèque Sablotron soit correctement reliée à -lstdc++. Dans le cas contraire, votre configuration échouera ou bien PHP refusera de fonctionner ou de se charger.

Support de JavaScript E-XSLT : Si vous compilez Sablotron avec le support JavaScript, vous devez spécifier cette option : --with-sablot-js.

Note aux utilisateurs Win32 : Afin d'activer ce module dans l'environnement Windows, vous devez copier les bibliothèques sablot.dll depuis le dossier DLL de PHP/Win32 dans le dossier système SYSTEM32 de votre machine (par exemple : C:\WINNT\SYSTEM32 or C:\WINDOWS\SYSTEM32). Pour les versions <= à 4.2.0 , copiez sablot.dll et expat.dll dans le dossier système SYSTEM32. Pour les versions >= à 4.2.1, copiez sablot.dll, expat.dll et iconv.dll dans le dossier système SYSTEM32.

Configuration à l'exécution

Cette extension ne définit aucune directive de configuration.

Types de ressources

Cette extension ne définit aucune ressource.

Constantes pré-définies

Ces constantes sont définies par cette extension, et ne sont disponibles que si cette extension a été compilée avec PHP, ou bien chargée au moment de l'exécution.

XSLT_OPT_SILENT (entier): Ignore tous les rapports d'erreurs. C'est une option générique pour toutes les interfaces qui seront ajoutées plus tard.
XSLT_SABOPT_PARSE_PUBLIC_ENTITIES (entier): Commande à Sablotron de faire l'analyse des entités publiques. Par défaut, cette option est désactivée.
XSLT_SABOPT_DISABLE_ADDING_META (entier): Ne pas ajouter le méta-tag "Content-Type" pour les générations HTML. La valeur par défaut est choisie lors de la compilation de Sablotron.
XSLT_SABOPT_DISABLE_STRIPPING (entier): Arrête la suppression des espaces (pour les fichiers de données uniquement).
XSLT_SABOPT_IGNORE_DOC_NOT_FOUND (entier): Considère les documents non résolus (la fonction document()) comme non-bloquant.
XSLT_SABOPT_FILES_TO_HANDLER (entier)
XSLT_ERR_UNSUPPORTED_SCHEME (entier): Renvoie un code d'erreur pour les erreurs de gestionnaire de Scheme.

Table des matières
xslt_backend_info -- Retourne les informations sur les paramètres de compilation du backend
xslt_backend_name -- Retourne le nom du backend
xslt_backend_version -- Retourne le numéro de version de Sablotron
xslt_create -- Crée un nouvel analyseur XSLT
xslt_errno -- Retourne le numéro d'erreur XSLT courant
xslt_error -- Retourne un message d'erreur
xslt_free -- Détruit un analyseur XSLT
xslt_getopt -- Récupère les options d'un processeur xsl donné
xslt_process -- Transforme des données XML avec XSLT
xslt_set_base -- Configure l'URI de base de toutes les transformations XSLT
xslt_set_encoding -- Configure le jeu de caractères pour l'analyse des documents XML
xslt_set_error_handler -- Configure le gestionnaire d'erreurs du processeur XSLT
xslt_set_log -- Configure le fichier d'historique pour les messages XSLT
xslt_set_object -- Définit l'objet dans lequel doivent être résolues les fonctions de callback
xslt_set_sax_handler -- Modifie les gestionnaires SAX de l'analyseur XSLT
xslt_set_sax_handlers -- Configure les gestionnaires SAX qui seront appelés pour gérer les documents XML
xslt_set_scheme_handler -- Configure les gestionnaires de Scheme du processeur XSLT
xslt_set_scheme_handlers -- Configure un gestionnaire de Scheme pour un processeur XSLT
xslt_setopt -- Définit les options d'un processeur xsl donné