Si on place chaque template dans un fichier dédié, on obtient beaucoup de fichiers, ce qui n’est jamais très facile à gérer.. Le moteur de template offre une méthode, setBlock, pour extr
Trang 1$vue−> s e t F i l e ( " e n f a n t " , " Enfant t p l " ) ;
/ / B o u c l e p o u r i n s t a n c i e r 5 e n f a n t s
f o r ( $ i = 0 ; $ i < 5 ; $ i ++) {
$vue−>numero = $ i ;
/ / On c o n c a t è n e l ’ i n s t a n c i a t i o n d e ’ e n f a n t ’ d a n s ’ e n f a n t s ’
$vue−>append ( " e n f a n t s " , " e n f a n t " ) ;
}
/ / E t on a f f i c h e l e r é s u l t a t
echo $vue−>r e n d e r ( " p a r e n t " ) ;
? >
Le mécanisme illustré ci-dessus peut sembler relativement complexe à première vue Avec un peu de réflexion et d’usage, on comprend que les entités se manipulent comme des variables (chaỵnes de caractères) On les initialise, on les concatène et
on les affiche Cette approche permet de modifier à volonté la disposition de la page, sans qu’il soit nécessaire de toucher au code PHP, et inversement
Un défaut potentiel des templates est qu’il faut parfois en utiliser beaucoup pour construire un document final complexe Si on place chaque template dans
un fichier dédié, on obtient beaucoup de fichiers, ce qui n’est jamais très facile à gérer L’exemple ci-dessus est peu économe en nombre de fichiers puisque le template enfant tient sur 3 lignes
Le mécanisme de blocs permet de placer plusieurs templates dans un même fichier.
Le moteur de template offre une méthode, setBlock(), pour extraire un template d’un autre template, et le remplacer par une référence à une nouvelle entité Avec setBlock(), on se ramène tout simplement à la situation ó les templates sont dans des fichiers séparés
Voici une illustration avec le même exemple que précédemment Cette fois il n’y
a plus qu’un seul fichier, avec deux templates :
Exemple 6.8 exemples/ParentEnfant.tpl:Un fichier avec deux templates imbriqués
< ? xml v e r s i o n = " 1 0 " e n c o d i n g = " i s o−8959−1 " ?>
< !DOCTYPE html PUBLIC "−//W3C/ / DTD XHTML 1 0 S t r i c t / / EN"
" h t t p : / / www w3 o r g / TR / xhtml1 /DTD/ xhtml1−s t r i c t dtd ">
<html xmlns= " h t t p : / / www w3 o r g / 1 9 9 9 / xhtml " xml : l a n g = " f r " >
<head>
< t i t l e >Exemple de t e m p l a t e s < / t i t l e >
< l i n k r e l = ’ s t y l e s h e e t ’ h r e f = " f i l m s c s s " t y p e = " t e x t / c s s " / >
< / head>
<body>
< d i v >
< d i v >
Ce t e m p l a t e e s t un < i > p a r e n t < / i >
q u i d o i t ê t r e combiné a v e c un a u t r e t e m p l a t e , < i > e n f a n t < / i > ,
Trang 2d i r e c t e m e n t i n s é r é d a n s l e même f i c h i e r
< u l >
< !−− BEGIN e n f a n t −−>
< l i >
C e c i e s t l e t e m p l a t e < i > e n f a n t < / i > , a v e c l e numéro { numero }
< / l i >
< !−− END e n f a n t −−>
< / u l >
< / d i v >
< / body>
< / html>
Le bloc correspondant au template enfant est imbriqué dans le premier avec une paire de commentaires HTML, et une syntaxe BEGIN – END marquant les limites du
bloc Voici maintenant le code PHP qui produit exactement le même résultat que le
précédent
Exemple 6.9 exemples/ExTemplateBloc.php:Traitement d’un template avec bloc
<? php
/ / E x e m p l e d e c o m b i n a i s o n d e t e m p l a t e s a v e c b l o c
r e q u i r e ( " T e m p l a t e php " ) ;
/ / I n s t a n c i a t i o n d ’ un o b j e t d e l a c l a s s e T e m p l a t e
$vue = new T e m p l a t e ( " " ) ;
/ / C h a r g e m e n t d e s d e u x t e m p l a t e s
$vue−> s e t F i l e ( " p a r e n t " , " P a r e n t E n f a n t t p l " ) ;
/ / On e x t r a i t l e t e m p l a t e ’ e n f a n t ’ , e t on l e
/ / r e m p l a c e p a r l a r é f é r e n c e à l ’ e n t i t é ’ e n f a n t s ’
$vue−>s e t B l o c k ( " p a r e n t " , " e n f a n t " , " e n f a n t s " ) ;
/ / B o u c l e p o u r i n s t a n c i e r 5 e n f a n t s
f o r ( $ i = 0 ; $ i < 5 ; $ i ++) {
$vue−>numero = $ i ;
/ / On c o n c a t è n e l ’ i n s t a n c i a t i o n d e ’ e n f a n t ’ d a n s ’ e n f a n t s ’
$vue−>append ( " e n f a n t s " , " e n f a n t " ) ;
}
/ / E t on a f f i c h e l e r é s u l t a t
echo $vue−>r e n d e r ( " p a r e n t " ) ;
? >
Il faut noter qu’après l’appel à setBlock(), on se retrouve dans la même situation qu’après les deux appels à setFile() dans la version précédente Ce que l’on a gagné, c’est l’économie d’un fichier
Trang 36.3.3 Utilisation d’un moteur de templates comme vue MVC
Un moteur de templates est un bon candidat pour le composant « vue » d’une archi-tecture MVC Nous utilisons ce système de templates dans notre projet Le chapitre 9
montrera une autre solution avec le Zend Framework L’important, dans tous les cas,
est de respecter le rôle de la vue, clairement séparée des actions et du modèle Dans notre MVC, chaque contrôleur dispose, par héritage, d’un objet
$this->vue, instance de la classe Template Cet objet charge les fichiers de
templates à partir du répertoire application/vues De plus, une entité nommée page
est préchargée avec le document HTML de présentation du site Ce document est beaucoup trop long pour être imprimé ici (vous pouvez bien sûr le consulter dans le code du site) Il nous suffit de savoir qu’il contient deux références à des entités titre_page et contenu Chaque action doit donc construire un contenu pour ces entités et les affecter à la vue À titre d’exemple, voici le contrôleur index, qui contient une seule action, index, affichant la page d’accueil
Exemple 6.10 webscope/application/controleurs/IndexCtrl.php : Le contrôleur index
<? php
/∗ ∗
∗ @ c a t e g o r y w e b s c o p e
∗ @ c o p y r i g h t P h i l i p p e Rigaux , 2008
∗ @ l i c e n s e GPL
∗ @package I n d e x
∗ /
r e q u i r e _ o n c e ( " C o n t r o l e u r php " ) ;
/∗ ∗
∗ C o n t r ô l e u r p a r d é f a u t : I n d e x
∗ /
c l a s s I n d e x C t r l e x t e n d s C o n t r o l e u r
{
/∗ ∗
∗ A c t i o n p a r d é f a u t
∗ /
f u n c t i o n i n d e x ( )
{
/∗ D é f i n i t i o n du t i t r e ∗ /
$ t h i s−>vue−>t i t r e _ p a g e = " Accueil " ;
/∗ On c h a r g e l e c o d e HTML de l a p a g e d ’ a c c u e i l
∗ d a n s l ’ e n t i t é " c o n t e n u "
∗ /
$ t h i s−>vue−> s e t F i l e ( " contenu " , " i n d e x _ a c c u e i l t p l " ) ;
/ ∗ I l n ’ y a p l u s qu ’ à a f f i c h e r NB: l ’ e n t i t é ’ p a g e ’ e s t
d é f i n i e d a n s l a s u p e r −c l a s s e " C o n t r o l e u r " ∗ /
Trang 4echo $ t h i s−>vue−>r e n d e r ( " page " ) ;
}
}
? >
L’action se limite à définir les deux entités : titre_page est créé par une simple affectation, et contenu est créé par chargement du fichier templateindex_accueil.tplqui contient le texte de la page d’accueil (pour mieux se repérer, les vues seront nommées d’après le contrơleur et l’action ó elles sont utilisées) Il reste à appeler render() pour effectuer la substitution et obtenir l’affichage de la page d’accueil
Cette solution garantit la séparation de PHP et HTML, puisqu’il est impossible de mettre du code PHP dans un template Bien entendu, les choses vont se compliquer quand on va considérer des pages plus riches dans lesquelles les parties dynamiques produites par PHP vont elles-mêmes comporter une mise en forme HTML L’exemple qui suit, plus réaliste, nous donnera une idée de la manière de metre en œuvre l’assocation entre les contrơleur/actions et la vue pour une fonctionnalité réelle
6.3.4 Exemple complet
Nous allons créer, avec des templates, une fonctionnalité qui permet de rechercher
des films pour les modifier À partir de maintenant nous nous plaçons dans le cadre
de la réalisation du site WEBSCOPE et nous concevons toute l’application comme
un hiérarchie de contrơleurs et d’actions Vous pouvez ,en parallèle de votre lecture, consulter ou modifier le code fourni sur notre site ou sur le serveur de SourceForge
Le contrơleur s’appelle saisie et la fonctionnalité de recherche est composée de deux actions : form_recherche et recherche Vous savez maintenant ó trouver
le code correspondant : le contrơleur est une classe SaisieCtrl.php dans
applica-tion/controleurs, et les deux actions correspondent à deux méthodes de même nom.
La première action se déclenche avec l’URL
index.php?ctrl=saisie&action=form_recherche
ou plus simplement ?ctrl=saisie&action=form_recherche quand on est déjà dans le contexte de l’application webscope Elle affiche un formulaire pour saisir un mot-clé,
complet ou partiel, correspondant à une sous-chaỵne du titre des films recherchés (voir la figure 6.6)
La seconde action (figure 6.7) montre un tableau contenant, après recherche, les films trouvés, associés à une ancre permettant d’accéder au formulaire de mise à jour (non décrit ici) Dans notre copie d’écran, on a demandé par exemple tous les films
dont le titre contient la lettre « w » pour trouver Sleepy Hollow, Eyes Wide Shut, King
of New York, etc.
Pour chaque action nous disposons d’un template D’une manière générale, c’est une bonne habitude d’essayer de conserver un template par action et de nommer les fichiers de templates d’après l’action et le contrơleur Dans notre cas les fichiers s’appellent respectivementsaisie_form_recherche.tpletsaisie_recherche.tpl
Trang 5Figure 6.6 — Page de recherche des films
Figure 6.7 — Le résultat d’une recherche
Voici le premier :
Exemple 6.11 Le template saisie_form_recherche.tpl affichant le formulaire de recherche
<p>
Vous p o u v e z r e c h e r c h e r a v e c c e f o r m u l a i r e l e s f i l m s
que v o u s s o u h a i t e z m o d i f i e r E n t r e z l e t i t r e , ou
une p a r t i e du t i t r e , en m a j u s c u l e s ou m i n u s c u l e s ,
e t l a n c e z l a r e c h e r c h e
< / p>