Plop,
Pour débuter, rien de plus simple. Vous devez vous y connaître un chouilla (mais vraiment un chouilla) dans la POO pour comprendre ce qui suit.
Tout d'abord, après avoir extrait les fichiers de l'archive téléchargée, ceux-ci sont organisés dans un répertoire Talus_TPL : Sachez que c'est ce répertoire et son contenu qui sont important au moteur. Les trois autres fichiers fournis sont juste une copie de la license (LGPL) utilisée, le changelog entre les versions, et un fichier patch pour ceux qui veulent mettre à jour depuis une version précédente.
Il y a un fichier à inclure de votre part, le moteur incluera le reste quand nécessaire : le fichier Talus_TPL/Talus_TPL.php.
Au cours de cette documentation, mes répertoires sont les suivants : ./, qui contient les classes du moteur Talus' TPL ; ./tpl/files/, qui contient mes tpls ; et enfin, ./tpl/cache/, qui lui contient le cache des tpl.
Voici comment débuter :
Code PHP
<?php
// -- Inclusion du moteur
require_once('./Talus_TPL/Talus_TPL.php');
/*
* Démarrage du moteur.
* Le premier argument situe les tpls, et le deuxième l'emplacement du cache (sans
* le / final)
*/
$tpl = new Talus_TPL('./tpl/files', './tpl/cache');
Sachez qu'en troisième paramètre, vous pouvez choisir d'autres classes pour compiler et gérer le cache des templates : leurs classes respectives doivent être inclusent avant le démarrage du moteur, et renseignée dans un array de ce type :
Code PHP
<?php
$dependencies = array(
'compiler' => new Talus_TPL_Compiler,
'cache' => new Talus_TPL_Cache
);
Si ce paramètre n'est pas renseigné, les classes Talus_TPL_Compiler & Talus_TPL_Cache seront utilisées par défaut. Sachez aussi que vos classes devront implémenter les interfaces respectives (Compiler & Cache) pour les deux classes si vous voulez que ce changement soit possible. Si vous souhaitez en savoir plus sur cette pratique (l'injection de dépendance, ou en anglais "Dependency Injection"), je vous laisse la page wikipédia. La page US vous renseignera un peu mieux (:-°) ; Sinon, je vous invite à regarder l'article de Fabien Potencier (auteur du framework symfony) à ce sujet.
A ce propos, notez que vous pouvez aussi changer en cours d'execution de classes via la méthode Talus_TPL::dependency(). Je vous invite à regarder la méthode en elle-même dans le code source pour en savoir plus.
Sommaire : Aborder la Doc'
Chapitre suivant : Les Namespaces XML
Home
» Talus' Works » Talus' TPL » Documentation » Débutons ! » Lecture du Sujet » Page 1 
#1 - Le 05/02/2008, à 14:09
