Utiliser smarty comme moteur de template

Lorsqu’un développeur créé son site web, il doit se poser pleins de questions avant de se lancer (enfin c’est mieux de le faire avant). L’une d’entre elle devrait être « vais-je utiliser des templates, et si oui que moteur conviendrais ? ».

Smarty est un moteur de template très connu et reconnu, et très complet. Peut être trop complet pour certains.

smarty

Idéalement, on utilise un moteur de template qui dispose des fonctionalités qu’on attend, et pas plus. Mais rien ne vous empêche d’utiliser Smarty pour tous vos projets, pour garder une trame de développement commune.

Qu’est ce qu’un template ?

Sans vous sortir une définition que vous trouverez aisément sur la toile, je vais tâcher de faire clair et simple.

Utiliser des templates vous permet de clarifier votre code, en séparant le code HTML du code PHP.

Alors oui, c’est pas sa seule fonction, mais c’est celle qui saute aux yeux. Il y a d’autres avantages, et quelques inconvénients selon votre point de vue.

La différence avec et sans template

Je prends ici en exemple une page on ne peut plus basique, et incomplète. C’est pour l’exemple.

Quand on utilise pas de template, on retrouve donc le code HTML et PHP en commun dans notre fichier

index.php

Si vous utilisez smarty, votre fichier serait découpé en 2 fichiers : index.php et index.tpl.

index.php

 

index.tpl

Et voilà le travail !

Le résultat est le même avec et sans template. Enfin le résultat visuel.

Ce que vous devez faire pour utiliser Smarty :

  • Télécharger Smarty
  • Inclure la classe smarty dans vos fichiers
  • Créer un objet smarty (ici $tpl)
  • Assigner vos variables php dans smarty avec $tpl->assign()
  • Entourer vos morceaux de code javascript avec {literal}{/literal}
  • Créer un dossier templates pour y placer vos fichiers .tpl
  • Créer un dossier templates_c pour le cache de smarty (accessible en écriture)

Référez vous à la documentation de Smarty pour des informations plus complètes.

Pour aller un peu plus loin

Il est préférable pour votre projet de créer un fichier global.php (ou un autre nom, c’est égal) qui sera inclus dans tous les autres. Ainsi, vous pouvez faire appel à la classe smarty et créer l’objet smarty dans ce fichier, et il sera inclus dans tous les autres.

Aussi, il est préférable d’avoir un fichier header.tpl (qui va contenir l’entete html, les scripts, le css et votre menu par exemple) et un fichier footer.tpl (qui va contenir notamment les fermetures de balises ouvertes dans le header).

En structurant ainsi votre site, vous n’aurez qu’a modifier les fichiers communs à toutes vos pages pour modifier toutes vos pages. Votre développement en sera grandement simplifié.

Cela devrait vous donner une structure qui ressemble à ça :

Bien entendu, Smarty est capable de plus, beaucoup plus. Gestion du cache, variables, boucles, debug… Il y a tellement de fonctionalités disponible, que je ne vais pas toutes les citer.

Laisser un commentaire