Templeet pas à pas

I. Fonctionnement de Templeet

Templeet est un language complet. Il associe des urls web appelés sur votre site avec des templates (ou modèles). Ces templates peuvent être de simples pages HTML agrémentées ou non de commandes Templeet, et plus généralement n'importe quel format texte (SVG, SMIL, TXT, etc).

Templeet peut être appelé de trois manières différentes:

• soit comme une page statique classique:

  http://monserveur/un/repertoire/mapage.html

• soit par l'appel à la page avec templeet.php dans le chemin:

  http://monserveur/templeet.php/un/repertoire/mapage.html

• soit par l'appel à Templeet avec le chemin passé en paramètre:

  http://monserveur/templeet.php?/un/repertoire/mapage.html

Dans les deux premiers cas il faut que le serveur web le permette.

Par défaut, pour toute page demandée, Templeet utilisera le même nom de fichier comme template. Si mapage.html est appelé, Templeet utilisera dans l'ordre le template template/mapage.tmpl ou template/mapage.html. Si le template n'existe pas, il retournera une erreur 404.

Les deux niveaux de cache de templeet

Templeet possède deux niveaux de cache principaux. Ces caches servent à augmenter de manière drastique les performances de Templeet.

Le cache de template:

Lorsque Templeet appelle un template celui-ci doit être analysé puis executé. Si le template est assez gros l'analyse peut prendre un temps non négligeable à l'échelle du serveur. Le cache de template contient le résultat de cette analyse qu'il n'est donc pas nécessaire de refaire par la suite pour une nouvelle exécution.
Lors du calcul d'un template, Templeet vérifie systématiquement que le template qui se trouve dans le cache est bien à jour par rapport au template édité par l'utilisateur.

Le cache de page:

C'est le plus important pour les performances de Templeet. C'est aussi celui qui est le plus difficile à appréhender.
Quand une page est calculée elle est stockée dans le répertoire de cache. Par défaut le répertoire de cache est la racine de templeet ce qui à pour effet qu'une page qui est calculée une fois ne le sera plus par la suite car lors d'un appel ultérieur le serveur trouvera la page immédiatement et ne fera donc pas appel à Templeet.

Il est d'une importance cruciale de bien comprendre ce fonctionnement sinon vous pourriez passer des heures à essayer de chercher pourquoi Templeet ne recalcule pas votre page alors que vous avez modifié le template correspondant.

La fonction ~dont_cache() permet de désactiver le cache pour la page en cours de calcul. Pendant la phase de mise au point d'un template il est recommandé d'utiliser cette fonction.

Il existe un troisième cache pour les includes. Nous n'en parlerons pas pour le moment.