258 Chapitre 6. Architecture du site : le pattern MVC $vue−>setFile ("enfant " , "Enfant . tpl") ; // Boucle pour instancier 5 enfants for ( $i =0; $i < 5; $i ++) { $vue−>numero = $i ; // On concatène l ’ instanciation de ’enfant ’ dans ’ enfants ’ $vue−>append (" enfants " , " enfant") ; } // Et on affiche le résultat echo $vue−>render(" parent"); ?> 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 où 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 version=" 1.0" encoding=" iso −8959−1"?> <!DOCTYPE h t m l PUBLIC " −/ /W3C / / DTD XHTML 1 . 0 S t r i c t / / EN " "http ://www.w3. org/TR/xhtml1/DTD/xhtml1− strict .dtd"> <html xmlns="http ://www.w3.org/1999/xhtml" xml: lang=" fr " > <head> < title>Exemple de templates</ title> < link rel=’stylesheet ’ href="films. css" type=" text / css " /> </head> <body> <div> <div> Ce template est un <i >parent</ i > qui doit être combiné avec un autre template , <i >enfant</ i >, 6.3 Structure d’une application MVC : la vue 259 directement inséré dans le même fichier . <ul> <!−− BEGIN e n f a n t −−> < li> Ceci est le template <i>enfant</ i > , avec le numéro {numero} </ li> <!−− END e n f a n t −−> </ul> </div> </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 // Exemple de combinaison de templates avec bloc require ("Template.php"); // Instanciation d’un objet de la classe Template $vue = new Template ( " . ") ; // Chargement des deux templates $vue−>setFile ("parent" , "ParentEnfant . tpl"); // On extrait le template ’enfant ’, et on le // remplace par la référence à l’entité ’enfants ’ $vue−>setBlock ("parent" , "enfant" , "enfants"); // Boucle pour instancier 5 enfants for ( $i =0; $i < 5; $i ++) { $vue−>numero = $i ; // On concatène l ’instanciation de ’enfant ’ dans ’enfants ’ $vue−>append ( " enfants " , " enfant ") ; } // Et on affiche le résultat echo $vue−>render("parent"); ?> 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. 260 Chapitre 6. Architecture du site : le pattern MVC 6.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.Deplus,uneentiténomméepage 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 /∗∗ ∗ @category webscope ∗ @copyright Philippe Rigaux , 2008 ∗ @license GPL ∗ @package Index ∗ / require_once ("Controleur .php") ; /∗∗ ∗ Contrôleur par défaut : Index ∗ / class IndexCtrl extends Controleur { /∗∗ ∗ Action par défaut ∗ / function index () { /∗ Définition du titre ∗ / $this−>vue−>titre_page = "Accueil" ; /∗ On charge le code HTML de la page d ’ accueil ∗ dans l ’ entité "contenu" ∗ / $this−>vue−>setFile ("contenu" , "index_accueil . tpl"); /∗ Il n’y a plus qu’à afficher. NB: l ’entité ’page’ est définie dans la super−classe "Controleur" ∗ / 6.3 Structure d’une application MVC : la vue 261 echo $this−>vue−>render("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 template index_accueil.tpl qui 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 où 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 W EBSCOPE 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 où 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 respectivement saisie_form_recherche.tpl et saisie_recherche.tpl. 262 Chapitre 6. Architecture du site : le pattern MVC Figure 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 pouvez rechercher avec ce formulaire les films que vous souhaitez modifier . Entrez le titre , ou une partie du titre , en majuscules ou minuscules , et lancez la recherche. </p> . 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. Template. Cet objet charge les fichiers de templates à partir du répertoire application/vues.Deplus,uneentiténomméepage est préchargée avec le document HTML de présentation du site. Ce document. 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,