support-webinphp-kanouni

Transcription

1 ZEND Studio 1. Installation Progression de l'installation

2 2. Prise en main L'interface Cration d'un projet Le document PHP

3 Excution Compltion Une aide est disponible lors de la saisie de code utile pour pour la syntaxe et la dcouverte de l'api.

4 Dbogueur ZEND Studio 3. Installation

5 Progression de l'installation 1. Prise en main

6 L'interface Cration d'un projet Le document PHP

7 Excution Compltion Une aide est disponible lors de la saisie de code utile pour pour la syntaxe et la dcouverte de l'api.

8 Dbogueur Script PHP Organisation d'un script Intgration HTML Les pages de codes PHP sont compltement intgres aux pages HTML. Le code du PHP est introduit par la syntaxe suivante: Blocks de code PHP

9 <?php...?> Standard <?...?> Version lgre <%... %> Syntaxe proche de ASP <SCRIPT LANGUAGE="PHP"> Au moyen du tag SCRIPT Modles Forme simple <html> <head> <title>premiere page PHP</title> </head> <body> Texte HTML <?php echo "Code du PHP";?> </body> </html> <?php echo("envoyer ce texte au client");?><br> <? echo ("Envoyer ce texte au client ");?><br> <?="Envoyer ce texte au client "?><br> <? $variable="toto"; echo ($variable);?> Forme alterne HTML/PHP <?php $expression=false; if ($expression)?> <strong>ecrire en gras : TRUE</strong> <?php else?> <strong>ecrire en gras : FALSE</strong> <?php?> Excutions En ligne de commande Il est possible de lancer l'interprteur PHP la faon d'un PERL ou d'un SHELL. Mais la plupart du temps PHP est un module intgr APACHE. Les options php -h

10 Usage: php [options] [-f] <file> [--] [args...] php [options] -r <code> [--] [args...] php [options] [-B <begin_code>] -R <code> [-E <end_code>] [--] [args...] php [options] [-B <begin_code>] -F <file> [-E <end_code>] [--] [args...] php [options] -- [args...] php [options] -a -a Run interactively -c <path> <file> Look for php.ini file in this directory -n No php.ini file will be used -d foo[=bar] Define INI entry foo with value 'bar' -e Generate extended information for debugger/profiler -f <file> Parse and execute <file>. -h This help -i PHP information -l Syntax check only (lint) -m Show compiled in modules -r <code> Run PHP <code> without using script tags <?..?> -B <begin_code> Run PHP <begin_code> before processing input lines -R <code> Run PHP <code> for every input line -F <file> Parse and execute <file> for every input line -E <end_code> Run PHP <end_code> after processing all input lines -H Hide any passed arguments from external tools. -s Display colour syntax highlighted source. -v Version number -w Display source with stripped comments and whitespace. -z <file> Load Zend extension <file>. args... --rf <name> --rc <name> --re <name> Arguments passed to script. Use -- args when first argument starts with - or script is read from stdin Show information about function <name>. Show information about class <name>. Show information about extension <name>. Version php -v PHP (cli) (built: Feb :11:26) Copyright (c) The PHP Group Zend Engine v2.2.0, Copyright (c) Zend Technologies Syntaxe uniquement <?php for ($i=0; $i<10; $i++) print "Je compte ". $i. "\n";?>

11 Liste des modules intgrs l'interprteur php -m [PHP Modules] bcmath calendar com_dotnet ctype date dom filter ftp hash iconv json libxml mbstring mysql mysqli odbc pcre PDO pdo_sqlite Reflection session SimpleXML SPL SQLite standard tokenizer wddx xml xmlreader xmlwriter zlib [Zend Modules] php -q exo1.php Je compte 0<br> Je compte 1<br> Je compte 2<br> Je compte 3<br> Je compte 4<br> Je compte 5<br> Je compte 6<br> Je compte 7<br> Je compte 8<br>

12 Je compte 9<br> php -l exo1.php No syntax errors detected in exo1.php Via client Internet On peut solliciter l'interprteur PHP via un browser : URL = Arguments Les arguments peuvent tre transmis : En ligne de commande Mthode GET/POST Gestion des URLs Encodage Description base64_decode Dcoder la donne avec MIME base64 base64_encode Coder la donne avec MIME base64 get_meta_tags Extraire les tags Meta depuis un fichier vers un tableau parse_url Analyse le contenu d'une URL rawurldecode Dcode une chane URL rawurlencode Code une chane URL RFC 1738 urldecode Dcode une chane URL urlencode Code une chane URL array parse_url ( string url) host port user pass path query - after the question mark? fragment - after the hashmark # $ php -r 'print_r( parse_url(" Array ( [scheme] => http [host] => hostname [user] => username [pass] => password [path] => /path [qfuery] => arg=value [fragment] => anchor ) $ php -r 'print_r( parse_url(" Array ( [scheme] => http

13 ) [host] => invalid_host..name [path] => / array pathinfo ( string path) <?php $path_parts = pathinfo("/www/htdocs/index.html"); echo "dirname = ". $path_parts["dirname"]. "\n"; echo "basename = ". $path_parts["basename"]. "\n";; echo "extension = ". $path_parts["extension"]. "\n";?> Affichage de l'explorateur : php exo.php dirname = /www/htdocs basename = index.html extension = html string urldecode ( string str) Dcode n'importe quel codage bas %## dans une string. La chane dcode est retourne. <?php $a = explode('&',$_server['query_string']); $i = 0; while ($i < count($a)) $b = split('=', $a[$i]); echo 'texte ', htmlspecialchars(urldecode($b[0])), ' est ', htmlspecialchars(urldecode($b[1])), "<br />\n"; $i++;?> texte a est aa texte b est bb string htmlspecialchars ( string string [, int quote_style [, string charset]]) Conversion '&' (ampersand) '"' double quote) ''' (single quote) '<' (less than) '>' (greater than) '&' '"' when ENT_NOQUOTES is not set. ''' only when ENT_QUOTES is set. '<' '>' <?php $new = htmlspecialchars("<a href='test'>test</a>", ENT_QUOTES); echo $new;

14 ?> Affichage de l'explorateur <a href='test'>test</a> ( Chane convertie en <a href='test'>test</a>) string htmlentities ( string string [, int quote_style [, string charset]]) Nom de constante ENT_COMPAT ENT_QUOTES ENT_NOQUOTES Description Convertit un " mais pas '. Convertit un " et un '. Ne convertit pas " ni '. <?php $str = "Une 'quote' est <b>bold</b>"; echo htmlentities($str). "\n"; echo htmlentities($str, ENT_QUOTES). "\n";?> Sortie Une 'quote' est <b>bold</b> Une 'quote' est <b>bold</b> Programmation Oriente objet Encapsulation Donnes et mthodes membres class Personne public $nom="vide"; public $prenom="vide"; public $age=1; public function affichertout () return "Nom = ". $this->nom. " Prenom = ". $this->prenom. " Age = ". $this->age ; Exemple <html> <body> <h1>une classe avec des donnes membres et mthodes membres</h1> <?php class Personne public $nom="vide"; public $prenom="vide";

15 ; public $age=1; public function affichertout () return "Nom = ". $this->nom. " Prenom = ". $this->prenom. " Age = ". $this->age?> <html> $p1 = new Personne (); echo "<p>". $p1->nom. "<p>"; echo "<p>". $p1->prenom. "<p>"; echo "<p>". $p1->age. "<p>"; echo "<p>". $p1->affichertout (). "<p>"; Comment PHP voir une instance? object(personne)#1 (3) ["nom"]=> NULL ["prenom"]=> NULL ["age"]=> NULL Rfrences L'appartenance des donnes et des fonctions membres l'objet se fait par la rfrence nommes $this. $this n'est utilis que dans le code de la classe. Protection public, protected, private Il est possible de protger les membres d'une classe au moyen des attributs : public : accessible tout le monde protected : accessible par hritage private : accessible uniquement pour les membres de la classe Si le membre $ affichertout() tait priv, il y aurait erreur <?php class Personne public $nom; public $prenom; public $age; private function affichertout () return "Nom = ". $this->nom. " Prenom = ". $this->prenom. " Age = ". $this->age ;

16 $p1 = new Personne (); // provoque l'erreur?> echo "<p>". $p1->affichertout (). "<p>"; Sortie Fatal error: Call to private method Personne::afficherTout() from context '' in D:\wamp\www\formation_ricoh\exo6.php on line 31 Constructeur et destructeur class Personne public function construct () public function destruct () <html> <body> <h1>une classe avec constructeur et destructeur</h1> <?php ; class Personne public $nom; public $prenom; public $age; public function affichertout () return "Nom = ". $this->nom. " Prenom = ". $this->prenom. " Age = ". $this->age public function construct () echo "Le contructeur"; $this->nom="vide"; $this->prenom="vide"; $this->age=0; public function destruct () echo "Le destructeur"; $this->nom="vide"; $this->prenom="vide";

17 $this->age=0; $p1 = new Personne (); echo "<p>". $p1->affichertout (). "<p>";?> <html> Setter et getter class Personne public $nom=""; public $prenom=""; public $age=0; public function getnom () return $this->nom; public function setnom ($nom ) $this->nom= $nom; public function getprenom () return $this->prenom; public function setprenom ($prenom ) $this->prenom= $prenom; public function getage () return $this->age; <html> <body> <h1>getter / Setter</h1> <?php class Personne public $nom=""; public $prenom=""; public $age=0; public function getnom () return $this->nom; public function setnom ($nom ) $this->nom= $nom; public function getprenom () return $this->prenom; public function setprenom ($prenom ) $this->prenom= $prenom; public function getage () return $this->age; public function affichertout () return "Nom = ". $this->nom. " Prenom = ". $this->prenom. " Age = ". $this->age ; $p1 = new Personne ();

18 $p1->setnom ("Nouveau nom"); $p1->setprenom ("Nouveau prenom"); echo "<p>". $p1->affichertout (). "<p>";?> <html> Fonction liste d'arguments variable func_num_args() : nombre d'arguments func_get_arg(index) : les arguments un un <?php?> function f() print "Nb arg = ". func_num_args(). "\n"; for ($i=0; $i<func_num_args(); $i++) print func_get_arg($i). "\n"; print " \n"; f(1,2,3); print " \n"; f(1,2,3,4,5); Sortie Nb arg = Nb arg = Paramtres par dfaut class Personne public $nom=""; public $prenom=""; public $age=0; public function settout ($nom="vide", $prenom="vide", $age=0) $this->nom = $nom; $this->prenom = $prenom; $this->age = $age;

19 public function affichertout () return "Nom = ". $this->nom. " Prenom = ". $this->prenom. " Age = ". $this->age ; <html> <body> <h1>surcharge</h1> <?php ; class Personne public $nom=""; public $prenom=""; public $age=0; public function settout ($nom="vide", $prenom="vide", $age=0) $this->nom = $nom; $this->prenom = $prenom; $this->age = $age; public function affichertout () return "Nom = ". $this->nom. " Prenom = ". $this->prenom. " Age = ". $this->age $p1 = new Personne (); $p1->settout ("Nouveau nom", "Nouveau prenom", 10); echo "<p>". $p1->affichertout (). "<p>"; $p1->settout (); echo "<p>". $p1->affichertout (). "<p>";?> <html> Surcharge La surcharge se fait en travaillant sur la liste des arguments public function settout () $num_args=func_num_args(); switch ($num_args) case 3 :

20 $this->nom = func_get_arg(0); $this->prenom = func_get_arg(0); $this->age = func_get_arg(0); break; case 0 : $this->nom = "vide"; $this->prenom = "vide"; $this->age = 0; break; <html> <body> <h1>surcharge</h1> <?php ; class Personne public $nom=""; public $prenom=""; public $age=0; public function settout () $num_args=func_num_args(); switch ($num_args) case 3 : $this->nom = func_get_arg(0); $this->prenom = func_get_arg(1); $this->age = func_get_arg(2); break; case 0 : $this->nom = "vide"; $this->prenom = "vide"; $this->age = 0; break; public function affichertout () return "Nom = ". $this->nom. " Prenom = ". $this->prenom. " Age = ". $this->age $p1 = new Personne ();

21 $p1->settout ("Nouveau nom", "Nouveau prenom", 10); echo "<p>". $p1->affichertout (). "<p>"; $p1->settout (); echo "<p>". $p1->affichertout (). "<p>";?> <html> Hritage class Salarie extends Personne public $anciennete=0; public function affichertout () return Personne::afficherTout (). " Anciennete = ". $this->anciennete ; <html> <body> <h1>hritage</h1> <?php ; class Personne public $nom="vide"; public $prenom="vide"; public $age=1; public function affichertout () return "Nom = ". $this->nom. " Prenom = ". $this->prenom. " Age = ". $this->age class Salarie extends Personne $p1 = new Salarie (); echo "<p>". $p1->affichertout (). "<p>";?>

22 <html> Redfinition La classe drive reprend une fonction de classe de base. <html> <body> <h1>hritage</h1> <?php class Personne public $nom="vide"; public $prenom="vide"; public $age=1; public function affichertout () return "Nom = ". $this->nom. " Prenom = ". $this->prenom. " Age = ". $this->age ; class Salarie extends Personne public $anciennete=0; public function affichertout () return Personne::afficherTout (). " Anciennete = ". $this->anciennete ; $p1 = new Salarie (); echo "<p>". $p1->affichertout (). "<p>";?> <html> Interface interface IAfficher public function affichertout (); <html> <body> <h1>interface </h1> <?php

23 interface IAfficher public function affichertout (); ; class Personne implements IAfficher public $nom="vide"; public $prenom="vide"; public $age=1; public function affichertout () return "Nom = ". $this->nom. " Prenom = ". $this->prenom. " Age = ". $this->age $o = new Personne (); IAfficher $i = $o; echo "<p>". $i->affichertout (). "<p>";?> <html> Mots cls METHODE $self = classe courante $this = objet courant Classe parent = get_parent_class($o) Classe de l'objet = get_class($o) Instanceof class_exists() tostring() <html> <body> <h1>oprateurs</h1> <?php class Personne public $nom="vide"; public $prenom="vide"; public $age=1; public function affichertout ()

24 ; return "Nom = ". $this->nom. " Prenom = ". $self->prenom. " Age = ". $this->age $o = new Personne (); echo "<p>classe = ". get_class($o). "<p>"; echo "<p>parent =". get_parent_class($o). "<p>"; $ret = $o instanceof Personne; echo "<p>instance of =". (string) $ret. "<p>"; echo "<p>exist =". class_exists("personne"). "<p>";?> <html> Eval Permet d'valuer dynamiquement un texte par l'interprteur. Une variable <?php eval ("\$a=10;"); print $a;?> Sortie 10 Une fonction <?php eval ("function f() return 10;"); print f();?> Sortie 10 Build-ins CLASS METHOD FILE LINE construct, destruct, call, get, set, isset, unset, sleep, wakeup, tostring, set_state, clone and autoload are magical in PHP classes. You Introduction XML & XSLT 1. XML Modle de donnes Ascii Il est possible de stocker des donnes au format texte ascii avec une structure propritaire. Mais cela

25 prsente quelques inconvnients: Structure non documente Difficult dfinir un vocabulaire et une grammaire Obligation de dfinir des moyens de gestion XML A la manire dun fichier ascii, le format XML est bas sur des tags applicatifs issus dun vocabulaire et dune grammaire tablis dans un modle de dfinition appel DTD. reconnaissance en tant que standard par la W3C et OMG dploiement doutils (parsers, traduction vers RDB) Gestion aise par la programmation grce aux interfaces. XML est une considr comme l'ascii du WEB mais contrairement la description des donnes ascii, il prsente les avantages suivants : bas sur des tags donc pas de problme de sparateurs les tags constituent un vocabulaire de domaine tablit dans un fichier joint appel DTD contenu du document XML valid par sa DTD lors du parsing Les tags sont imbriqus et constituent une description objet du document Disponibilit de parser pour diffrents langages par le biais d'interfaces. Structure dun document Prologue <?xml version="1.0"?> <?xml version="1.0"encoding="utf-8" standalone="yes"?> body Structure du document en tant que tags imbriqus enrichis par des attributs. Epilogue Pouvant contenir des section PI et des commentaires <CATALOGUE> <LIVRES> <LIVRE titre="programmation C" auteur="bk" annee="2000"/> <LIVRE titre="programmation JAVA" auteur="fb" annee="2000"/> <LIVRE titre="administration NT2000" auteur="jj" annee="2000"/> <LIVRE titre="programmation PERL" auteur="bk" annee="2000"/> </LIVRES> </CATALOGUE> La DTD Le DTD dfinit le vocabulaire et la smantique des lments utiliss dans un document XML. vocabulaire rgles de grammaire Cest le parser qui exploite de DTD pour valider le contenu du document. Mot cl ELEMENT Signification Dclaration dun lment

26 ATTLIST ENTITY NOTATION Les lments <! Element Nom catgorie> La catgorie peut tre EMPTY ELEMENT MIXED ANY #REQUIRED #IMPLIED #FIXED Valeurs par dfaut Dclaration des attributs Dclaration dun contenu rutilisable Dclaration dun contenu externe pour viter de le voir interprter Ni texte ni lment enfant Contient un lment enfant mais pas de texte Combinaison de ELEMENT, de #PCDATA, de texte ou contenu. Contenu libre mais conforme XML ( viter) Apparition dans toutes les instances de llment Apparition optionnelle Lattribut doit toujours avoir les valeurs par dfaut. Si la valeur nest pas prsente alors valeur par dfaut prise. <!ELEMENT CATALOGUE (LIVRES) #REQUIRED> <!ELEMENT LIVRES (LIVRE MAGASINE) #REQUIRED> Analyseur syntaxique XML (Parser) Modle SAX Le document XML est valid par la DTD laquelle il est associ. Mais un document XML nest pas forcment associ un DTD, on dit quil nest pas valid. Le document XML est analys par un programme pour organiser en mmoire son hirarchie le rendant ainsi accessible la programmation. Le parser SAX intervient dans le code de l'application sous forme d'vnements (fonction php). Fichier traiter <?xml version= "1.0" encoding= "UTF-8" standalone= "yes"?> <CATALOGUE> <LIVRES> <LIVRE titre= " Programmation C" auteur= " BK" annee= " 2000"/> <LIVRE titre= " Programmation JAVA" auteur= " FB" annee= " 2000"/> <LIVRE titre= " Administration NT2000" auteur= " JJ" annee= " 2000">AAAAA</LIVRE> <LIVRE titre= " Programmation PERL" auteur= " BK" annee= " 2000"/> </LIVRES> </CATALOGUE> Programme PHP <? // Prparation des vnements SAX function startelement ($parser, $name, $attr)

27 printf ("Dbut de tag : Nom = %s Attribs = %s<br>", $name, implode ($attr)); function endelement ($parser, $name) printf ("Fin de tag : Nom = %s <br>", $name); function characterdata ($parser, $data) $info = strlen (trim($data))? $data : "rien"; printf ("Entre le tag, je trouve %s<br>", $info); // Instancier un parser SAX $parser = xml_parser_create (); // Mettre en place les vnments xml_set_element_handler ($parser, "startelement", "endelement"); xml_set_character_data_handler ($parser, "characterdata"); // Ouvrir et traiter un fichier if (!($fp = fopen ("livres.xml", "r"))) die ("Impossible de trouver le fichier livres.xml"); while (($data = fread ($fp, 4096))) if (!xml_parse ($parser, $data, feof ($fp))) die (sprintf ("XML erreur ligne = %d colonne = %d", xml_get_current_line_number($parser), xml_get_current_column_number($parser)));?> Sortie Dbut de tag : Nom = CATALOGUE Attribs = Entre le tag, je trouve rien Dbut de tag : Nom = LIVRES Attribs = Entre le tag, je trouve rien Entre le tag, je trouve rien Dbut de tag : Nom = LIVRE Attribs = Programmation C BK 2000 Fin de tag : Nom = LIVRE Entre le tag, je trouve rien Entre le tag, je trouve rien Dbut de tag : Nom = LIVRE Attribs = Programmation JAVA FB 2000 Fin de tag : Nom = LIVRE Entre le tag, je trouve rien

28 Entre le tag, je trouve rien Dbut de tag : Nom = LIVRE Attribs = Administration NT2000 JJ 2000 Entre le tag, je trouve AAAAA Fin de tag : Nom = LIVRE Entre le tag, je trouve rien Entre le tag, je trouve rien Dbut de tag : Nom = LIVRE Attribs = Programmation PERL BK 2000 Fin de tag : Nom = LIVRE Entre le tag, je trouve rien Fin de tag : Nom = LIVRES Entre le tag, je trouve rien Fin de tag : Nom = CATALOGUE Modle DOM 2. SCHEMA Introduction Le schema est un langage description de types de donnes. Il est crit en XML est valid et son vocabulaire est donn par site : Le schma est un document quivalent celui de la DTD. On y dcrit des types de donnes avec leurs rgles et contraintes. Il reprsente une amlioration par rapport la DTD car il est volutif. On peut crire son propre schma pour tous les lments que l'on trouve dans son document. Mais si on utilise un vocabulaire dj existant alors autant utiliser les schma disponibles : biologie, mathmatique, lectronique Notre schma doit son tour respecter le vocabulaire de base renferm dans Structure d'un document schema <?xml version="1.0" encoding="utf-8"?> <xs:schema xmlns:xs=" </xs:schema> Les types de donnes peuvent tre simples (scalaires) ou complexes (agrgs). type simple : string <xs:element name="title" type="xs:string"/> <xs:element name="author" type="xs:string"/> type complexe : sequence <xs:element name="book"> <xs:complextype> <xs:sequence>.../...

29 </xs:sequence>.../... </xs:complextype> </xs:element> Ceci est une cration d'un type de donnes "character" <xs:element name="character" minoccurs="0" maxoccurs="unbounded"> <xs:complextype> <xs:sequence>.../... </xs:sequence> </xs:complextype> </xs:element> Ceci est une cration d'un type de donnes "lment" bas string <xs:element name="name" type="xs:string"/> <xs:element name="friend-of" type="xs:string" minoccurs="0" maxoccurs="unbounded"/> <xs:element name="since" type="xs:date"/> <xs:element name="qualification" type="xs:string"/> Exemple complet <?xml version="1.0" encoding="utf-8"?> <xs:schema xmlns:xs=" <xs:element name="book"> <xs:complextype> <xs:sequence> <xs:element name="title" type="xs:string"/> <xs:element name="author" type="xs:string"/> <xs:element name="character" minoccurs="0" maxoccurs="unbounded"> <xs:complextype> <xs:sequence> <xs:element name="name" type="xs:string"/> <xs:element name="friend-of" type="xs:string" minoccurs="0" maxoccurs="unbounded"/> <xs:element name="since" type="xs:date"/> <xs:element name="qualification" type="xs:string"/> </xs:sequence> </xs:complextype> </xs:element> </xs:sequence> <xs:attribute name="isbn" type="xs:string"/> </xs:complextype> </xs:element> </xs:schema> Autre exemple <?xml version="1.0" encoding="utf-8"?>

30 <xs:schema xmlns:xs="  <xs:element name="title" type="xs:string"/> <xs:element name="author" type="xs:string"/> <xs:element name="name" type="xs:string"/> <xs:element name="friend-of" type="xs:string"/> <xs:element name="since" type="xs:date"/> <xs:element name="qualification" type="xs:string"/>  <xs:attribute name="isbn" type="xs:string"/>  <xs:element name="character"> <xs:complextype> <xs:sequence> <xs:element ref="name"/> <xs:element ref="friend-of" minoccurs="0" maxoccurs="unbounded"/> <xs:element ref="since"/> <xs:element ref="qualification"/>   </xs:sequence> </xs:complextype> </xs:element> <xs:element name="book"> <xs:complextype> <xs:sequence> <xs:element ref="title"/> <xs:element ref="author"/> <xs:element ref="character" minoccurs="0" maxoccurs="unbounded"/> </xs:sequence> <xs:attribute ref="isbn"/> </xs:complextype> </xs:element> </xs:schema> Types nomms <xs:simpletype name="nametype"> <xs:restriction base="xs:string"> <xs:maxlength value="32"/> </xs:restriction> </xs:simpletype> <xs:simpletype name="isbntype"> <xs:restriction base="xs:string"> <xs:pattern value="[0-9]10"/> </xs:restriction> </xs:simpletype>

31 Exemple complet <?xml version="1.0" encoding="utf-8"?> <xs:schema xmlns:xs="  <xs:simpletype name="nametype"> <xs:restriction base="xs:string"> <xs:maxlength value="32"/> </xs:restriction> </xs:simpletype> <xs:simpletype name="sincetype"> <xs:restriction base="xs:date"/> </xs:simpletype> <xs:simpletype name="desctype"> <xs:restriction base="xs:string"/> </xs:simpletype> <xs:simpletype name="isbntype"> <xs:restriction base="xs:string"> <xs:pattern value="[0-9]10"/> </xs:restriction> </xs:simpletype>  <xs:complextype name="charactertype"> <xs:sequence> <xs:element name="name" type="nametype"/> <xs:element name="friend-of" type="nametype" minoccurs="0" maxoccurs="unbounded"/> <xs:element name="since" type="sincetype"/> <xs:element name="qualification" type="desctype"/> </xs:sequence> </xs:complextype> <xs:complextype name="booktype"> <xs:sequence> <xs:element name="title" type="nametype"/> <xs:element name="author" type="nametype"/> <xs:element name="character" type="charactertype" minoccurs="0"/>  </xs:sequence> <xs:attribute name="isbn" type="isbntype" use="required"/> </xs:complextype>  <xs:element name="book" type="booktype"/> </xs:schema> 3. XPath Introduction XPath est un langage permettant de reprer des nuds (lments) dans un document hirarchique XML.

32 C'est lui qui est utilis par XSLT pour localiser des parties de documents contenant des lments et leurs attributs. XPath est un standard du W3C : Un emplacement XPath est form de trois parties : Un axe : qui spcifie la relation hirarchique entre le contexte et les noeuds slectionns Le test du noeud : spcifiant le type de noeud recherch Le prdicat : expression boolenne devant tre satisfaite par le noeud pour faire partie de la slection. Contexte Lorsqu'on travaille avec XSLT le contexte est le noeud dans le document XML en cours de traitement. Le contexte consiste en : Un noeud (the context node) Une paire d'entiers poisitifs (context position + context size) Un ensembre de variables bindings Des espace de noms Le contexte "racine ou /" veut dire tout le document. <xsl:template match="/"> Le contexte de la boucle for est chaque lment sur le quel on se positionne avec for. <xsl:for-each loop> Il faut toujours se poser la question sur le contexte en cours de traitement. Chemin Le chemin XPath est une expression du langage XPath initialise pour trouver le contexte. Le chemin reconnat les nuds suivants root = racine du document XML element = un lment du document XML text = Texte d'un lment XML attribute = Attribut d'un lements XML namespace = espace de nom associ un lment XML (attribut commenant par xmlns) processing = PI comment Afin de simplifier les expressions les parsers XPath supportent des abrviations telles que. = nud courant.. = noeud parent chapitre//sparagraphe = child::chapitre//sparagraphe::sparagraphe [@type="warning"] = child::para[attribute::type="warning"] //para = /descendant-or-self::node()/child::para para[3] = para[position()=3]

33 para the para element children of the context node * all element children of the context node text() all text node children of the context the name attribute of the context all the attributes of the context node para[1] the first para child of the context node para[last()] the last para child of the context node */para all para grandchildren of the context node /doc/chapter[5]/section[2] the second section of the fifth chapter of the doc chapter//para the para element descendants of the chapter element children of the context node //para all the para descendants of the document root and thus = all para elements in the same document as the context node //olist/item all the item elements in the same document as the context node that have an olist parent. the context node.//para the para element descendants of the context node.. the parent of the context node../@lang the lang attribute of the parent of the context node para[@type="warning"] all para children of the context node that have a type attribute with value warning para[@type="warning"][5] the fifth para child of the context node that has a type attribute with value warning para[5][@type="warning"] the fifth para child of the context node if that child has a type attribute with value warning "Introduction"] the chapter children of the context node that have one or more title children with string-value equal to Introduction chapter[title] the chapter children of the context node that have one or more title children employee[@secretary all the employee children of the context node that have both a secretary attribute and an assistant attribute Predicate Un prdicat est un filtre qui permet d'isoler un ensemble de nuds partir d'un axe donn. Il s'agit d'une expression qui est value vraie pour le nud considr. [expression] paragraphe[titre='compte utilisateur'] paragraphe[position() = 1] paragraphe[starts-with(titre, "Gestion")] XPath: Expressions Les filtres de nuds sont forms d'expressions logiques

34 and, or logical and, or = equal to!= not equal to >, >= greater than, greater than or equal to <, <= less than, less than or equal to Remember to code the < character as the XML entity < in the XSL file. +, -, *, div addition, subtraction, multiply, divide mod modular, returns the integer remainder of a division Computes (unions) two node sets Filtre sur les positions paragraphe[position() >=2 and position() <=4] L'un ou l'autre des noeuds. paragraphe sparagraphe XPath: Functions XSLT dispose d'une grande liste de fonctions pouvant tre utilises dans les expressions Xpath. count Permet de compter le nombre de noeuds dans une liste de noeuds retourne par une expression Xpath. count(nodes) <xsl:value-of select="count(chapitre/paragraphe[id=1])"/> number Permet de convertir une valeur en un numrique. Si la conversion choue alors le rsultat est "NaN" (Not a Numbre) <xsl:value-of select="number(books/book/price)"/></p> position Retourne la position d'un lment dans son contexte. <xsl:number substring Retourne une partie d'une chane de caractres avec un index bas 1. substring(value, start) substring(value, start, length) <xsl:value-of select="substring(name, 1, 3)"/> sum Permet d'effectuer la somme des valeurs de nuds <xsl:value-of select="sum(//price)"/> Gestion de string string string(object?) = convertit des donnes en chane de caractres.

35 Donne Chane zero 0 +infini Infinity -infini -Infinity entier dcimal Boolen True / false string concat(string, string, string*) = Concatnation des chanes passes en argument. boolean starts-with(string, string) = Vrifie qu'une chane commence bien par une occurrence. Le rsultat est boolen. string substring-before(string, string) = retourne la chane aprs l'occurrence string substring-after(string, string) = retourne la chane avant l'occurrence boolean contains(string, string) = rechecher d'occurrence string substring(string, number, number?) = extrait de chane number string-length(string?) = retourne le nombre de caractres string normalize-space(string?) = enlve les espaces en dbut et en fin. Gestion de boolen boolean boolean(object) = permet la conversion d'objets en boolen un nombre est vrai un node-set est vrai une chane est vraie s'il n'est pas positif ni NaN s'il est non vide si la longueur est non nulle boolean not(boolean) = ngation de la proposition logique boolean true() = retourne vrai toujours boolean false() = retourne faux toujours Gestion de nombre number number(object?) une string contenant un numrique est convertie en numrique boolen true est converti en 1 boolen false est converti en 0 un node-set est converti d'abord en chane number sum(node-set) = la valeur de chaque noeud est convertie en un numrique et le cumule est effectu number floor(number) = convertir le nombre en un entier suprieur immdiat number ceiling(number) = convertir le nombre en un entier infrieur immdiat number round(number) = donne un arrondi du nombre. Gestion des Node-set

36 number last() =retourne un nombre gal au context size evaluation context. number position() = retourne un nombre gal au contexte position number count(node-set) = retourne le nombre de noeud dans le node-set node-set id(object) = slectionne un objet par son ID. id("foo") id("foo")/child::para[position()=5] string local-name(node-set?) string namespace-uri(node-set?) string name(node-set?) 4. XSL Modle de donnes Le modle de donnes est similaire celui de Xpath. Le traitement XSLT se fait conjointement sur les trois documents suivants: source XML rsultat XML document XSL Le rootnode peut contenir n'importe quelle squence d'lments. Chaque nud est repr par son URI qui peut tre relative ou absolue. para any para element * any element chapter appendix any chapter element and any appendix element olist/item any item element with an olist parent appendix//para any para element with an appendix ancestor element / the root node text() any text node processing-instruction() any processing instruction node() any node other than an attribute node and the root node id("w11") the element with unique ID W11 para[1] any para element that is the first para child element of its parent *[position()=1 and self::para] any para element that is the first child element of its parent para[last()=1] any para element that is the only para child element of its parent items/item[position()>1] any item element that has a items parent and that is not the first item child of its parent div[@class="appendix"]//p any p element with a div ancestor element that has a class attribute with value any class attribute (not any element that has a

37 @* Application des templates  <xsl:apply-templates select = node-set-expression mode = qname>  </xsl:apply-templates> Rgles prdfinies Pour les root nodes et les lments node. <xsl:template match="* /"> <xsl:apply-templates/> </xsl:template> class attribute) any attribute Pour les root nodes et les lments node. On poursuit dans le mme mode <xsl:template match="* /" mode="m"> <xsl:apply-templates mode="m"/> </xsl:template> Pour les textes et attributs nodes <xsl:template <xsl:value-of select="."/> </xsl:template> Pour une processing instructions et comments <xsl:template match="processing-instruction() comment()"/> Templates nommes Les templates peuvent tre invoques par nom la manire d'une fonction  <xsl:call-template name = qname>  </xsl:call-template> Cration d'lments et attributs Cration d'lment  <xsl:element name = qname namespace = uri-reference use-attribute-sets = qnames>  </xsl:element> Cration d'attributs  <xsl:attribute name = qname namespace = uri-reference >

38  </xsl:attribute> Cration de Texte Une template peut contenir un texte noeud.  <xsl:text disable-output-escaping = "yes" "no">  </xsl:text> Cration d'une Processing Instructions  <xsl:processing-instruction name = ncname >  </xsl:processing-instruction> <xsl:processing-instruction name="xml-stylesheet">href="book.css" type="text/css"</xsl:processing-instruction> produira <?xml-stylesheet href="book.css" type="text/css"?> Cration d'un Commentaire  <xsl:comment>  </xsl:comment> <xsl:comment>this file is automatically generated. Do not edit!</xsl:comment> Produira  Copier un noeud  <xsl:copy use-attribute-sets = qnames>  </xsl:copy> xsl:copy permet de copier le noeud courant. Mais les attributs et les noeuds enfant ne sont pas copis automatiquement. Seuls les noeuds pouvant possder des attributs et de noeuds enfants sont copis. Le noeud racine est trait spcialement car il est cr de manire implicite par xslt. <xsl:template match="@* node()">

39 <xsl:copy> <xsl:apply-templates node()"/> </xsl:copy> </xsl:template> Le noeud courant copier peut tre de type attribut <xsl:template name="apply-templates-copy-lang"> <xsl:for-each <xsl:copy/> </xsl:for-each> <xsl:apply-templates/> </xsl:template> On peut simplement faire <xsl:call-template name="apply-templates-copy-lang"/> au lieu <xsl:apply-templates/> Calcul et gnration de texte Avec xsl:value-of peut extraire du texte depuis la source ou depuis le contenu d'une variable. Les valeurs littrales sont encapsules dans (). Gnration de texte avec xsl:value-of  <xsl:value-of select = string-expression disable-output-escaping = "yes" "no" /> xsl:value-of va crer un noeud de type texte dans l'arbre rsultat. L'attribut select est une expression. Cette expression est value et le rsultat est converti en chane de caractres. Le texte gnr est automatiquement fusionn avec les textes adjacents. xsl:copy-of peut utilis pour copier un ensemble de noeuds sur l'arbre sans passer par une conversion texte. <xsl:template match="person"> <p> <xsl:value-of select="@given-name"/> <xsl:text> </xsl:text> <xsl:value-of select="@family-name"/> </p> </xsl:template> <xsl:template match="person"> <p> <xsl:value-of select="given-name"/> <xsl:text> </xsl:text>

40 <xsl:value-of select="family-name"/> </p> </xsl:template> Attribute Value Templates La valeur d'un attribut peut tre value avant l'affectation. Pour cela on utilise L'exemple suivant cre un lment img depuis un noeud <photograph du source. L'emplacement de l'image est compos du contenu de la variable $image-dir et de la string-value de l'lment enfant <href> <xsl:variable name="image-dir">/images</xsl:variable> <xsl:template match="photograph"> <img src="$image-dir/href" </xsl:template> Le source <photograph> <href>headquarters.jpg</href> <size width="300"/> </photograph> Le rsultat est <img src="/images/headquarters.jpg" width="300"/> On n'aime pas les imbrications de... <a N'est pas permis, on utilise plutt <a Les nombres  <xsl:number level = "single" "multiple" "any" count = pattern from = pattern value = number-expression format = string lang = nmtoken letter-value = "alphabetic" "traditional" grouping-separator = char grouping-size = number /> xsl:number est utilis pour insrer un nombre format dans l'arbre rsultat. Le nombre est spcifi dans une expression.

41 La valeur de l'attribut contient l'expression devant tre value. Le nombre est converti en entier naturel puis en chane de caractres. <xsl:template match="items"> <xsl:for-each select="item"> <xsl:sort select="."/> <p> <xsl:number value="position()" format="1. "/> <xsl:value-of select="."/> </p> </xsl:for-each> </xsl:template> Si aucune valeur de l'attribut n'est spcifie alors la valeur de position() du noeud courant est fournie. <xsl:template match="ol/item"> <fo:block> <xsl:number/><xsl:text>. </xsl:text><xsl:apply-templates/> </fo:block> <xsl:template> <xsl:template match="title"> <fo:block> <xsl:number level="multiple" count="chapter section subsection" format="1.1 "/> <xsl:apply-templates/> </fo:block> </xsl:template> <xsl:template match="appendix//title" priority="1"> <fo:block> <xsl:number level="multiple" count="appendix section subsection" format="a.1 "/> <xsl:apply-templates/> </fo:block> </xsl:template> L'exemple suivant numrote squentiellement les notes du chapitre. <xsl:template match="note"> <fo:block> <xsl:number level="any" from="chapter" format="(1) "/> <xsl:apply-templates/> </fo:block> </xsl:template> The following example would number H4 elements in HTML with a three-part label: <xsl:template match="h4">

42 <fo:block> <xsl:number level="any" from="h1" count="h2"/> <xsl:text>.</xsl:text> <xsl:number level="any" from="h2" count="h3"/> <xsl:text>.</xsl:text> <xsl:number level="any" from="h3" count="h4"/> <xsl:text> </xsl:text> <xsl:apply-templates/> </fo:block> </xsl:template> Conversion nombre/chane de caractres Grce l'attribut format, il est possible de convertir une liste de numriques en chane de caractres. La valeur par dfaut est 1. format spare en squence de mots et chaque mot est une valeur maximale de squence alphanumrique : Nd, Nl, No, Lu, Ll, Lt, Lm or Lo. format token squence A A B C... Z AA AB AC... a a b c... z aa ab ac... i i ii iii iv v vi vii viii ix x... I I II III IV V VI VII VIII IX X... Rptition  <xsl:for-each select = node-set-expression>  </xsl:for-each> xsl:for-each contient une template qui est instancie pour chaque noeud slectionn. L'attribut select est requis et contient l'expression valuer pour retourner un node-set. Les nuds sont traits dans l'ordre du document moins que une spcification de tri ne soit demande. XML <customers> <customer> <name>...</name> <order>...</order> <order>...</order> </customer> <customer> <name>...</name> <order>...</order>

43 <order>...</order> </customer> </customers> XSL <xsl:template match="/"> <html> <head> <title>customers</title> </head> <body> <table> <tbody> <xsl:for-each select="customers/customer"> <tr> <th> <xsl:apply-templates select="name"/> </th> <xsl:for-each select="order"> <td> <xsl:apply-templates/> </td> </xsl:for-each> </tr> </xsl:for-each> </tbody> </table> </body> </html> </xsl:template> Les conditions XSLT support deux types de conditions : xsl:if = avec un seul if-then xsl:choose = avec plusieurs possibilits xsl:if  <xsl:if test = boolean-expression>  </xsl:if> xsl:if possde un attribut test dans lequel une expression boolenne est value. <xsl:template match="namelist/name"> <xsl:apply-templates/> <xsl:if test="not(position()=last())">, </xsl:if> </xsl:template>

44 <xsl:template match="item"> <tr> <xsl:if test="position() mod 2 = 0"> <xsl:attribute name="bgcolor">yellow</xsl:attribute> </xsl:if> <xsl:apply-templates/> </tr> </xsl:template> xsl:choose  <xsl:choose>  </xsl:choose> <xsl:when test = boolean-expression>  </xsl:when> <xsl:otherwise>  </xsl:otherwise> xsl:choose slectionne la possibilit pour laquelle le test est valu vrai. <xsl:template match="orderedlist/listitem"> <fo:list-item indent-start='2pi'> <fo:list-item-label> <xsl:variable name="level" select="count(ancestor::orderedlist) mod 3"/> <xsl:choose> <xsl:when test='$level=1'> <xsl:number format="i"/> </xsl:when> <xsl:when test='$level=2'> <xsl:number format="a"/> </xsl:when> <xsl:otherwise> <xsl:number format="1"/> </xsl:otherwise> </xsl:choose> <xsl:text>. </xsl:text> </fo:list-item-label> <fo:list-item-body> <xsl:apply-templates/> </fo:list-item-body> </fo:list-item> </xsl:template> Tri avec sort <xsl:sort

45 select = string-expression lang = nmtoken data-type = "text" "number" qname-but-not-ncname order = "ascending" "descending" case-order = "upper-first" "lower-first" /> xsl:sort est un lment enfant de xsl:apply-templates ou de xsl:for-each. Lorsqu'il y a plus d'un lment, xsl:sort alors se comportent comme cl premire et cl secondaire. xsl:sort force xsl:apply-templates ou xsl:for-each trier la liste de noeuds avant de les traiter. Les attributs de xsl:sort permettent de contrler le tri. Attributs Valeurs possibles order ascending(defaut) ou descending data-type texte (dfaut), numbre ou QNames case-order upper-first ou lower-first Soit une base de donnes d'employs. <employees> <employee> <name> <given>james</given> <family>clark</family> </name>... </employee> </employees> La liste d'employs est trie par nom: <xsl:template match="employees"> <ul> <xsl:apply-templates select="employee"> <xsl:sort select="name/family"/> <xsl:sort select="name/given"/> </xsl:apply-templates> </ul> </xsl:template> <xsl:template match="employee"> <li> <xsl:value-of select="name/given"/> <xsl:text> </xsl:text> <xsl:value-of select="name/family"/> </li> </xsl:template> Variables et Parameters

46 <xsl:variable name = qname select = expression>  </xsl:variable>  <xsl:param name = qname select = expression>  </xsl:param> Une variable est un nom associ une valeur. En XSLT il y a deux faons d'associer un nom une valeur : xsl:variable xsl:param Les deux lments ont un attribut "name" qui est un QName. Valeur de Variables et Paramtres Trois manires d'affecter une valeur: Si l'attribut select est prsent alors la valeur est donne par l'expression Si l'attribut select n'est pas prsent alors la template doit donner la valeur aprs valuation Si l'attribut select n'est pas prsent et possde un contenu vide alors la valeur est une chane vide. <xsl:variable name="x"/> est quivalent <xsl:variable name="x" select="''"/> Variables et Parameters avec xsl:copy-of  <xsl:copy-of select = expression /> xsl:copy-of peut tre utilis pour insrer un fragment d'arbre rsultat dans l'arbre rsult sans passer par une conversion en chane de caractres. Variables et parameters Top-level xsl:variable et xsl:param sont autoriss au niveau global pour tre vus dans tous les blocs de code. Le paramtre variable para-font-size est dclar en global pour tre utilis par la template <xsl:variable name="para-font-size">12pt</xsl:variable> <xsl:template match="para">

47 <fo:block font-size="$para-font-size"> <xsl:apply-templates/> </fo:block> </xsl:template> Variables and parameters dans une Template xsl:variable et xsl:param sont autorises dans une template. xsl:variable est possible n'importe o dans la template tandis que xsl:param n'est permis que immdiatement aprs xsl:template. Attention au conflit de noms et la visibilit des entits dclares. Ceci est une erreur <xsl:template name="foo"> <xsl:param name="x" select="1"/> <xsl:variable name="x" select="2"/> </xsl:template> Ceci est correcte <xsl:param name="x" select="1"/> <xsl:template name="foo"> <xsl:variable name="x" select="2"/> </xsl:template> Passer des paramtres aux Templates <xsl:with-param name = qname select = expression>  </xsl:with-param> Les paramtres sont passs aux templates au moyen xsl:with-param. La valeur du nom de param est un Qname. On peut utiliser xsl:with-param aussi bien dans xsl:call-template que dans xsl:applytemplates. <xsl:template name="numbered-block"> <xsl:param name="format">1. </xsl:param> <fo:block> <xsl:number format="$format"/> <xsl:apply-templates/> </fo:block> </xsl:template> <xsl:template match="ol//ol/li"> <xsl:call-template name="numbered-block"> <xsl:with-param name="format">a. </xsl:with-param> </xsl:call-template> </xsl:template>

48 Autres fonctions node-set document(object, node-set?) Permet d'extraire un node-set depuis un document XML extrieur. Le rsultat est fusionn avec le node-set courant. Keys Keys fonctionne avec les documents possdant des rfrences croises explicites : ID, IDREF et IDREFS XSLT supporte cela au travers de XPath avec id() mais il y a certaines limitations. Les attributs ID sont dclars dans la DTD et doivent respecter : L'unicit Un nom valide (pas d'espace) L'lment key possde trois parties : Le noeud possdant la key Le nom du key (QName) La valeur du key Stylesheet dclare implicitement un ID au moyen de xsl:key pour chaque lment rencontr en se basant sur l'unicit du nom ainsi un lment de nom x aura un ID=x  <xsl:key name = qname match = pattern use = expression /> <xsl:key permet de dclarer les keys. L'expression est value une seule fois pour chaque nud. <xsl:key name="idkey" match="div" use="@id"/> Une expression key("idkey",@ref) retournera le mme rsultat que id(@ref) en supposant la dclaration suivante dans la DTD. <!ATTLIST div id ID #IMPLIED> Supposant l'lment suivant. <prototype name="key" return-type="node-set"> <arg type="string"/> <arg type="object"/> </prototype> et une fonction y faisant rfrence <function>key</function>

49 Alors le stylesheet gnrera un hyperlien comme cela <xsl:key name="func" match="prototype" <xsl:template match="function"> <b> <a href="#generate-id(key('func',.))"> <xsl:apply-templates/> </a> </b> </xsl:template> <xsl:template match="prototype"> <p><a name="generate-id()"> <b>function: </b>... </a></p> </xsl:template> Key peut servir extraire une key depuis un autre document Soit un document contenant <bibref>xslt</bibref> Soit un autre document XML bib.xml possdant une entre <entry name="xslt">...</entry> Alors le stylesheet effectuera la transformation comme cela. <xsl:key name="bib" match="entry" <xsl:template match="bibref"> <xsl:variable name="name" select="."/> <xsl:for-each select="document('bib.xml')"> <xsl:apply-templates select="key('bib',$name)"/> </xsl:for-each> </xsl:template> Formater un nombre string format-number(number, string, string?) On convertit le nombre selon un modle (string) et avec un format dcimal (string).  <xsl:decimal-format name = qname decimal-separator = char grouping-separator = char infinity = string minus-sign = char

50 NaN = string percent = char per-mille = char zero-digit = char digit = char pattern-separator = char /> xsl:decimal-format est inspir du modle : classe DecimalFormatSymbols de la JDK 1.1 decimal-separator grouping-separator percent per-mille zero-digit the character used for the decimal sign; the default value is the period character (.) the character used as a grouping (e.g. thousands) separator; the default value is the comma character (,) the character used as a percent sign; the default value is the percent character (%) the character used as a per mille sign; the default value is the Unicode per-mille character (#x2030) the character used as the digit zero; the default value is the digit zero (0) The following attributes control the interpretation of characters in the format pattern: digit the character used for a digit in the format pattern; the default value is the number sign character (#) pattern-separator the character used to separate positive and negative sub patterns in a pattern; the default value is the semi-colon character (;) Les attributs suivant sont utiliss pour le rsultat infinity the string used to represent infinity; the default value is the string Infinity NaN the string used to represent the NaN value; the default value is the string NaN minus-sign the character used as the default minus sign; the default value is the hyphen-minus character (-, #x2d) Fonctions utiles node-set current()=retourne un node-set ne contenant que le noeud courant comme membre. <xsl:value-of select="current()"/> Est quivalent <xsl:value-of select="."/> Le noeud courant est en principe diffrent de celui qui est spcifi entre [] <xsl:apply-templates select="//glossary/item[@name=current()/@ref]"/>

Montrer encore