Pour les amateurs du combo XML/XSL/xPath, une petite astuce lorsque l'on pousse le générique assez loin pour former une expression xPath dynamiquement.
Supposons qu'une variable xsl contienne un "bout" de l'expression xPath, cela nous donnerait ça :
<!-- - Selectionne un noeud XML à l'aide d'une expression xPath formée dynamiquement --> <xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:php="http://php.net/xsl" xmlns="http://www.w3.org/1999/xhtml"> <xsl:template match="root"> <xsl:variable name="dynamicNode" select="'user_name'" /> <!-- xPath formé = "//root/bdd/users[1]/user_name" --> <xsl:value-of select="bdd/users[1]/*[name()=$dynamicNode]" /> </xsl:template> </xsl:stylesheet>
Si vous débutez en XSL, au delà des features basiques (select, for-each, choose, if, variable), vous avez dû être surpris de ne pas trouver de simple boucle for, alors que le for-each était présent ; or le for-each ne permet pas toujours de tout faire. Ainsi, si vous souhaitez faire une petite boucle for, plusieurs solutions s'offrent à vous. Pour les illustrer, nous allons prendre un exemple simple : une note/5 d'article (en float) en partant du fait que vous avez cette note dans votre flux xml, et que vous souhaitez afficher le nombre d'étoiles correspondant à cette note.
1ère solution, vous utilisez PHP5 et à l'aide de la fonction registerPHPFunctions() de la classe XSLTProcessor(), vous pouvez simplement utiliser l'une de vos fonctions PHP pour réaliser le traitement.
<?php
$xml = new DOMDocument()
$xml->load('flux.xml');
$xsl = new DOMDocument()
$xsl->load('flux.xsl');
$proc = new XSLTProcessor();
$proc->registerPHPFunctions();
$proc->importStyleSheet($xsl);
echo $proc->transformToXML($xml);
function displayStars($note)
{
$html = "";
for($i=0 ; $i<floor($note) ; $i++)
$html .= '<img src="Public/Styles/Img/star.gif" title="'.floor($note).'/5" />';
echo $html;
}
?>
Ainsi, en XSL, vous n'avez qu'à appeler directement votre fonction PHP grâce au xmlns php, en ommettant pas l'attribut disable-output-escaping afin d'interpréter le HTML retourné pas votre fonction.
<!--
- Test passant par PHP
-->
<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:php="http://php.net/xsl" version="1.0">
<xsl:output method="xml" encoding="UTF-8" indent="yes" />
<xsl:template match="root">
<html>
<head></head>
<body>
<xsl:value-of select="php:function('displayStars',//article/note)" disable-output-escaping="yes" />
</body>
</html>
</xsl:template>
</xsl:stylesheet>
La 2eme solution se base uniquement sur XSL et consiste en l'utilisation de templates récursifs afin de simuler une boucle for.
<!--
- Template récursif
-->
<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:php="http://php.net/xsl"" version="1.0">
<xsl:template name="displayStars">
<xsl:param name="i" />
<xsl:param name="length" />
<!-- Traitement du for -->
<img src="Public/Styles/Img/star.gif" alt="{concat($length,'/5')}" title="{concat($length,'/5')}" />
<!-- /Traitement du for -->
<!-- Tant que length n'est pas atteint, l'on rappele le template pour continuer la boucle -->
<xsl:if test="$i < $length">
<xsl:call-template name="displayStars">
<xsl:with-param name="i" select="$i + 1" />
<xsl:with-param name="length" select="$length" />
</xsl:call-template>
</xsl:if>
</xsl:template>
</xsl:stylesheet>
Que l'on appellera comme ceci :
<!-- - Test d'appel du template récursif --> <xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:php="http://php.net/xsl" version="1.0"> <xsl:output method="xml" encoding="UTF-8" indent="yes" /> <xsl:template match="root"> <html> <head></head> <body> <xsl:call-template name="displayStars"> <xsl:with-param name="i" select="'1'" /> <xsl:with-param name="length" select="round(//article/note)" /> </xsl:call-template> </body> </html> </xsl:template> </xsl:stylesheet>
A noter que même si la boucle for reste exploitable en XSL, il devient vite fastidieux de rédevelopper des templates spécifiques à chaque traitement de boucles.
Une 3e solution, pour les gros projets, si l'on conserve le même exemple de la note, est de s'arranger pour modifier légèrement la structure de son flux XML formé par PHP pour pouvoir réaliser son traitement avec seulement le for-each.
Ici, au lieu de former :
<?xml version="1.0" encoding="UTF-8"?> <root> <article> <note><![CDATA[3.4]]></note> </article> </root>
On aurait pu former :
<?xml version="1.0" encoding="UTF-8"?> <root> <article> <note> <item><![CDATA[]]></item> <item><![CDATA[]]></item> <item><![CDATA[]]></item> </note> </article> </root>
où le nombre d'item correspondant au floor() php afin de pouvoir "foreacher" tranquillement sur notre note et simuler une boucle for :
<!--
- For-each détourné
-->
<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:php="http://php.net/xsl" version="1.0">
<xsl:output method="xml" encoding="UTF-8" indent="yes" />
<xsl:template match="root">
<html>
<head></head>
<body>
<xsl:variable name="note" select="count(//article/note/item)" />
<xsl:for-each select="//article/note/item">
<img src="Public/Styles/Img/star.gif" alt="{concat($note,'/5')}" title="{concat($note,'/5')}" />
</xsl:for-each>
</body>
</html>
</xsl:template>
</xsl:stylesheet>
Vous pouvez voir que plusieurs solutions vous permettent de réaliser votre boucle, libre à vous de choisir celle qui vous convient le mieux, en rapport avec votre envirronnement technique et vos choix en matière d'architecture.
Supposons le flux XML suivant listant un ensemble d'utilisateurs :
<?xml version="1.0" encoding="UTF-8"?> <users> <user> <id>1</id> <login>lo</login> <email>laurent@sillysmart.org</email> </user> <user> <id>2</id> <login>flo</login> <email>florian@sillysmart.org</email> </user> <user> <id>3</id> <login>charly</login> <email>charly@sillysmart.org</email> </user> </users>
Le css suivant :
table.bo_table_visible {
border:1px solid #000;
border-spacing: 0px;
margin-top:10px;
margin-bottom:10px;
}
table.bo_table_visible tr.summary th {
background:#2E2D2D;
color:#E45A49;
}
table.bo_table_visible tr td, table.bo_table_visible tr th {
padding:0 10px;
}
table.bo_table_visible tr.even td {
background-color:#FFF;
color:#000;
}
table.bo_table_visible tr.even:hover td {
background-color:#FF8ABC;
color:#FFF;
}
table.bo_table_visible tr.odd td {
background-color:#DFDFDF;
color:#000;
}
table.bo_table_visible tr.odd:hover td {
background-color:#64B8FE;
color:#FFF;
}
Il vous suffit d'appliquer le script XSL suivant pour appliquer les styles sur votre liste d'utilisateurs :
<!--
- Apply css with XSL
-->
<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:php="http://php.net/xsl" version="1.0">
<xsl:output method="xml" encoding="UTF-8" indent="yes" />
<xsl:template match="root">
<html>
<head></head>
<body>
<table class="bo_table_visible">
<tr>
<th>Id</th>
<th>Login</th>
<th>Email</th>
</tr>
<xsl:for-each select="//users/user">
<xsl:variable name="cssClass">
<xsl:choose>
<xsl:when test="(position() mod 2) = 0">
even
</xsl:when>
<xsl:otherwise>
odd
</xsl:otherwise>
</xsl:choose>
</xsl:variable>
<tr class="{$cssClass}">
<td><xsl:value-of select="id" /></td>
<td><xsl:value-of select="login" /></td>
<td><xsl:value-of select="email" /></td>
</tr>
</xsl:for-each>
</table>
</body>
</html>
</xsl:template>
</xsl:stylesheet>
Ce qui produira :
| Id | Login | |
|---|---|---|
| 1 | lo | laurent@sillysmart.org |
| 2 | flo | florian@sillysmart.org |
| 3 | charly | charly@sillysmart.org |
Lorsque vous affichez des images dynamiquement, si vous voulez vous assurez qu'elles existent réellement, vous pouvez le faire assez aisément directement en XSL :
<!--
- Apply css with XSL
-->
<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:php="http://php.net/xsl" version="1.0">
<xsl:output method="xml" encoding="UTF-8" indent="yes" />
<xsl:template match="root">
<html>
<head></head>
<body>
<!-- On suppose que le noeud 'id' contient une partie du nom du fichier -->
<xsl:variable name="imgSrc" select="boolean(document(string(concat('http://www.sillysmart.org/img/users/', id, '.jpg'))))" />
<xsl:choose>
<xsl:when test="$imgSrc">
<img src="{concat('http://www.sillysmart.org/img/users/', id, '.jpg')}" alt="{id}" />
</xsl:when>
<xsl:otherwise>
<img src="http://www.sillysmart.org/img/404.jpg" alt="Not found" />
</xsl:otherwise>
</xsl:choose>
</body>
</html>
</xsl:template>
</xsl:stylesheet>
Une des grandes nouveautés de PHP5 est que la classe de parsing XML/XSL XSLTProcessor permet nativement d'utiliser PHP pour effectuer des transformations lourdes et fastidieuses auparavant. Dorénavant, plus besoin de faire de template pour effectuer un ucwords(), il vous suffit d'un tout petit peu de paramétrage et on est bon.
Au niveau PHP :
<?php
$xml = new DOMDocument();
$xml->load('flux.xml');
$xsl = new DOMDocument();
$xsl->load('flux.xsl');
$proc = new XSLTProcessor();
// On précise au parseur que l'on veut utiliser des fonctions PHP en XSL
$proc->registerPHPFunctions();
$proc->importStyleSheet($xsl);
echo $proc->transformToXML($xml);
?>
Et au niveau XSL :
<!--
- Simple test pour appeler une fonction php
-->
<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:php="http://php.net/xsl"
version="1.0">
<!-- On ajoute surtout le xmlns PHP -->
<xsl:output method="xml" encoding="UTF-8" indent="yes" />
<xsl:template match="root">
<html>
<!-- On utilise le préfixe php pour appeler la fonction ucwords() -->
<xsl:value-of select="php:function('ucwords','php peut désormais être utilisé en xsl')" />
<!-- Output: 'Php Peut Désormais Etre Utilisé En Xsl' -->
</html>
</xsl:template>
</xsl:stylesheet>
On peut même utiliser des fonctions statiques de classe, au niveau PHP :
<?php
class XSL
{
/**
* Traite une chaine pour la passer dans l'url
*
* @param $string la chaine a modifier
* @param $delimiter le caractère d'implode
* @return $string la chaine modifie
* @see self::fullTrim
* @see self::removeSpecialCaracteres
* @see self::removeAccents
*/
static function stringToUrl($string,$delimiter=" ")
{
return self::fullTrim(self::removeSpecialCaracteres(strtolower(self::removeAccents($string)))
,$delimiter);
}
/**
* Enleve les caractères accentuées d'une chaine
*
* @param $string la chaine a modifier
* @return $string la chaine modifie
*/
static function removeAccents($string)
{
static $search = array ("à", "á", "â", "ã", "ä", "ç", "è", "é", "ê", "ë", "ì", "í", "î", "ï",
"ñ", "ò" ,"ó", "ô", "õ", "ö", "ù", "ú", "û", "ü", "ý", "ÿ", "À", "Á",
"Â", "Ã", "Ä", "Ç", "È", "É", "Ê", "Ë", "Ì", "Í", "Î", "Ï", "Ñ", "Ò",
"Ó", "Ô", "Õ", "Ö", "Ù", "Ú", "Û", "Ü", "Ý");
static $replac = array ("a", "a", "a", "a", "a", "c", "e", "e", "e", "e", "i", "i", "i", "i",
"n", "o", "o", "o", "o", "o", "u", "u", "u", "u", "y", "y", "A", "A",
"A", "A", "A", "C", "E", "E", "E", "E", "I", "I", "I", "I", "N", "O",
"O", "O", "O", "O", "U", "U", "U", "U", "Y");
return str_replace($search,$replac,$string);
}
/**
* Enleve les caractères spéciaux d'une chaine
*
* @param $string la chaine a modifier
* @return $string la chaine modifie
*/
static function removeSpecialCaracteres($string)
{
static $search = array ("²", "&", "~", "#", "{", "(", "[", "-", "|", "`", "\\", "^", "'", ")",
"]", "}", "^", "¨", "£", "¤", "%", "*", ",", "?", ";", ".", ":",
"/", "!", "§", "<", ">", "»", "«", "\n", "\r", " ");
static $replac = " ";
return str_replace($search,$replac,$string);
}
/**
* Enlève tous les espaces d'une chaine de caractères
*
* @param string $element la chaine dont on veut hoter les espaces
* @param $delimiter le caractère d'implode
* @return string la chaine sans espaces
*/
static function fullTrim($element,$delimiter="")
{
return implode($delimiter,self::processFunction(explode(' ',$element),'trim'));
}
}
?>
Et au niveau XSL :
<!--
- Test plus complexe pour appeler des fonctions de classe
-->
<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:php="http://php.net/xsl"
version="1.0">
<xsl:output method="html" version="XHTML 1.0" encoding="UTF-8" indent="yes" />
<xsl:template match="root">
<html>
<!-- On utilise le préfixe php pour appeler la fonction de classe stringToUrl() -->
<xsl:value-of select="php:function('XSL::stringToUrl','une_superstring-àÔ|modifier')" />
<!-- Output: 'une_superstring ao modifier' -->
</html>
</xsl:template>
</xsl:stylesheet>
On peut donc aisément appliquer des transformations PHP à même nos gabarits XSL.
