Hyla project - Outils

Actualité Hyla_Tpl : Nouveau site et nouvelle version 0.7.0

hugo — Mon, 21 Jun 2010 15:37:00 +0200

Pour cette nouvelle version, Hyla Tpl possède maintenant un nouveau site qui lui est dédié : http://tpl.hyla-project.org/ sur lequel se trouve tout ce qu'il faut pour développer avec Hyla Tpl et notamment :

Une introduction avec un descriptif des différences entre Hyla Tpl et la PhpLib et un comparatif de performance
Une documentation complète
Des exemples interactifs
L'actualité de Hyla Tpl centralisée

Concernant les nouveautés de cette nouvelle version de Hyla Tpl sort en version 0.7.0, les voici :

Il est dorénavant possible de définir une valeur par défaut à une variable
Ajout de la fonction import permettant de charger un fichier tpl depuis la vue
Possibilité de définir des variables directement depuis le template, très utile pour les templates inclus depuis la vue
Nouvelles méthodes
Performances améliorées

Ça se passe par ici : http://tpl.hyla-project.org/

Nouvelle version mineure de Hyla_Tpl : 0.5.2

hugo — Thu, 04 Feb 2010 10:13:00 +0100

Voici une nouvelle version mineure de Hyla_Tpl qui corrige un bug remonté par Lionel se produisant lorsqu'un bloc ( ) se trouve au tout début d'un modèle ainsi qu'une vilaine régression empêchant l'utilisation correcte de plusieurs fonctions au sein d'une variable de gabarit.

Téléchargez cette nouvelle version ici même : Hyla_Tpl 0.5.2

Un exemple d'utilisation de Hyla_Tpl : Un explorateur de fichiers

hugo — Tue, 12 Jan 2010 09:34:00 +0100

Voici un exemple de programme réalisé avec Hyla_Tpl, il liste les éléments contenus dans un dossier et permet de naviguer dans l'arborescence, avec des textes en anglais et français afin de démontrer la facilité d'incorporer des éléments à traduire dans les gabarits, en fait, c'est une sorte de mini-Hyla ;)

Le code est commenté et est assez parlant, il démontre assez bien la facilité d'utilisation de ce moteur de gabarit léger et rapide.

Voici à quoi cela ressemble :

Vous n'aurez besoin que de 2 fichiers :

Un fichier gabarit nommé main.tpl contenant le code HTML
Le fichier php

Voici le bout de code php :

<?php
 
header('Content-type: text/html; charset=UTF-8');
 
// Inclu les sources de la librairies
require 'hyla_tpl.class.php';
 
 
// Créé l'objet Hyla_Tpl
$t = new Hyla_Tpl('.');
 
 
// Import du gabarits
$t->importFile('main.tpl');
 
 
// Fonction de traduction
function traduction($var) {
    global $lang;
    if ($lang == 'en') {
        return $var;
    }
    $l10n = array(
        'Current path'  =>  'Chemin courant',
        'Size'          =>  'Taille',
        'Name'          =>  'Nom',
        'Switch lang'   =>  'Changer de langue',
    );
    return (array_key_exists($var, $l10n) ? $l10n[$var] : $var);
}
 
 
// Déclare la fonction de traduction
$t->setL10nCallback('traduction');
 
 
// Cette fonction renvoie une taille facilement lisible (ex: 1024o renverra 1ko)
function get_human_readable_size($bytes) {
    global $lang;
    $types = array(null, 'k', 'm', 'g', 't');
    for ($i = 0; $bytes >= 1024 && $i < (count($types) -1); $bytes /= 1024, $i++);
    return round($bytes, 2) . $types[$i] . ($lang == 'fr' ? 'o' : 'b');
}
 
// Enregistre la fonction get_human_readable_size en tant que humansize dans le template
$t->registerFunction('humansize', 'get_human_readable_size');
 
 
// Récupère les variables get
$dir = isset($_GET['dir']) ? $_GET['dir'] : dirname(__FILE__);
$dir = realpath($dir);
 
$lang = isset($_GET['lang']) ? $_GET['lang'] : 'fr';
 
 
// Assigne quelques variables
$t->setVars(array(
    'dir'           =>  $dir,
    'lang'          =>  $lang,
    'lang_switch'   =>  ($lang == 'en' ? 'fr' : 'en'),
));
 
 
// Ouvre le dossier
if (!$files = @scandir($dir)) {
    exit("Unable to open « $dir »");
}
 
// Parcours des dossiers / fichiers
foreach ($files as $file) {
 
    $path = realpath("$dir/$file");
 
    $file = array(
        'path'  =>  $path,
        'name'  =>  $file,
        'size'  =>  filesize($path),
    );
    $t->setVar('file', $file);
 
 
    // L'élément courant est un dossier ?
    if (is_dir($path)) {
        $t->render('table.line.dir');
    }
 
 
    // Affiche la ligne
    $t->render('table.line');
}
 
// Affiche le résultat
echo $t->render();
 
?>

Et le code HTML contenant les déclarations pour Hyla_Tpl :

<html>
 
<head>
    <title>{$title}</title>
</head>
 
<body>
 
<h1>{_Current path} : {$dir}</h1>
 
<a href="?dir={$dir}&lang={$lang_switch}">{_Switch lang} : {$lang_switch}</a>
 
<table width="50%">
    <tr>
        <th width="90%">{_Name}</th>
        <th width="10%">{_Size}</th>
    </tr>
 
    <!-- BEGIN table.line -->
    <tr style="background-color: #{!cycle:'DDD', 'AAA'};">
        <td align="left">
            <!-- BEGIN table.line.dir -->
            <a href="?dir={$file.path}&lang={$lang}"><strong>{$file.name}</strong></a>
            <!-- ELSE table.line.dir -->
            <strong>{$file.name}</strong>
            <!-- END table.line.dir -->
        </td>
        <td align="right">
            {$file.size|humansize}
        </td>
    </tr>
    <!-- END table.line -->
 
</table>
 
</body>
 
</html>

Téléchargez le tout dans la pièce jointe.

Hyla_Tpl passe en version 0.5 et vous souhaite de joyeuses fêtes de fin d'année

hugo — Mon, 28 Dec 2009 09:05:00 +0100

Voici une nouvelle version de Hyla_tpl que vous trouverez en pièce jointe de ce billet, voici les nouveautés apportées :

Ajout d'une méthode pour récupérer le contenu d'un bloc : $tpl->get('nom_du_bloc'); , il est aussi possible de récupérer le contenu du bloc non rendu : $tpl->get('nom_du_bloc', false);
Si vous utilisez la fonction de traduction intégrée ( {_XXX} ) dans vos fichiers de gabarits alors qu'aucune fonction l10n n'à été définie, Hyla_Tpl ne râlera plus en vous disant qu'aucune fonction l10n n'existe mais vous renverra tout simplement la chaine de caractère non traduite.
Un peu de ménage fait

Pour ceux qui ne saurait pas ce qu'est Hyla_Tpl, voici un lien qui vous expliquera plus en détail ce qu'est Hyla_Tpl : Un nouveau moteur de template successeur de celui de la phpLib pour Hyla

Je rappelle la présence du forum pour l'aide mais à en croire le nombre de téléchargement et le nombre de message sur le forum., j'ai tendance à croire que Hyla_Tpl est suffisamment simple pour ne pas nécessiter d'aide... ;)

Pour finir, il est dorénavant possible de télécharger Hyla_Tpl directement depuis GitHub qui est son dépôt officiel...

Nouvelle version mineure de Hyla_Tpl : 0.4.1

hugo — Fri, 20 Nov 2009 15:07:00 +0100

Voici une nouvelle version de Hyla_tpl que vous trouverez en pièce jointe de ce billet, elle corrige un problème mineure d'affichage de notice.

Pour plus d'informations concernant ce moteur de gabarits, je vous invite à lire le précédent billet : Un nouveau moteur de template successeur de celui de la phpLib pour Hyla

Un forum uniquement consacré à ce moteur à également été créé : Forum d'aide pour Hyla_Tpl.

Note: Hyla_Tpl fonctionne parfaitement bien avec Php 5.3

Attention, cliquez sur le lien suivant pour télécharger la toute dernière version de Hyla_Tpl.

Hyla_Tpl : Un nouveau moteur de template, successeur de celui de la phpLib

hugo — Fri, 23 Oct 2009 14:16:00 +0200

Introduction

Pour les besoins de la nouvelle version du gestionnaire de fichiers en ligne Hyla, j'ai cherché des solutions pour remplacer le veillissant moteur de template (de gabarit ou de modèle en bon français) de la PhpLib qui lui à rendu, tout de même, de bons services et ce, depuis les toutes premières version de Hyla...

Le moteur de la PhpLib dispose de nombreux avantages, simplicité des modèles : pas de code (foreach, if, etc...) respectant ainsi la logique qui veut que les graphistes ne touchent pas une brindille de code, les blocs sont en fait des commentaires, ils apparaissent donc cachés aux graphistes travaillant sur le modèle.

Mais ce moteur de template souffre de 2 grosses lacunes :

Sa complexité de mise en oeuvre du côté php, on arrive très vite à du code relativement lourd : il est très verbeux.
Plus aucun support depuis bien longtemps, il lui manque donc des fonctionnalités qui sont, pourtant, devenues courantes.

Mais pourquoi réécrire un nouveau moteur de modèle alors qu'il en existe beaucoup qui fonctionnent parfaitement bien ?

Je souhaite garder un maximum de compatibilité avec les modèles existants déjà dans Hyla
Aucun des moteurs de gabarits que j'ai vu ne me convient, en général, ils sont beaucoup trop lourd pour ce qu'Hyla en fera.

En gros, garder la simplicité de la vue avec quelques nouveautés et améliorer le contrôleur.

Les modèles

Nouveautés pour les variables

Pour le moteur de modèle de la phpLib, tout ce qui est entre 2 accolades (avec des caractères valides) est une variable, ainsi, {TOTO} et {ma_variable} sont des variables, Hyla apporte une petite différence, ainsi, est considéré comme variable tout ce qui est entre accolades et commence par un caractère dollar $ : « {$toto} » et « {$ma_variable} » sont des variables mais ce n'est pas tout, Hyla apporte 5 nouveaux concepts au sujet des variables :

1. Tableaux et objets dans les variables

Il est possible de spécifier des tableaux ou des objets aux variables depuis le code php à l'aide de la fonction setVar, on y accède dans le gabarit de la manière suivante : « {$user.name} », on accède au contenu des tableaux et des objets de la même manière (avec le point : .) cachant ainsi l'implémentation à la vue.

Exemple :

Code php :

$user = array('name' => 'leonardo', 'age' => 67);
$tpl->setVar('user', $user);

Dans le gabarit :

<strong>{$user.name}</strong>
<em>{$user.age}</em>

2. Les fonctions appliquées aux variables

Avant affichage de la variable dans le modèle, il est possible d'envoyer son contenu dans des fonctions.

Exemple :

Dans le gabarit :

<strong>{$user.name|toupper}</strong>

Dans l'exemple ci-dessous, le contenu de la variable sera envoyé à la fonction toupper qui se chargera de mettre tous les caractères en majuscules.

3. Les fonctions simples

Un autre type de variable permet d'appeler une fonction directement, son utilisation est simple : « {!NOM_DE_LA_FONCTION:PARAMETRE} », exemple : « {!include:fichier.tpl} » inclura le fichier nommé fichier.tpl à la place du bloc lui même, voilà, c'est aussi simple que cela...

4. La traduction

Les variables à traduire sous la forme « {_i speak english} » (commençant par un _). Hyla récuperera le contenu de la variable (« i speak english ») et l'enverra à une fonction définie afin de procéder à une traduction : « {_i speak english} » sera ainsi remplacée par « je parle français » , il est même possible de cumuler la traduction et les fonctions, ainsi, l'exemple suivant « {_i speak english|trim|toupper} » retournera « JE PARLE FRANÇAIS »

5. Les commentaires

Il est possible de placer des commentaires dans les gabarits cette manière : « {#Voici un commentaire très intéressant !} ».

Pourquoi ce nommage ? J'ai essayé de rester logique, le « $ » utilisé pour les variables dans bash ou encore php, le « _ » fait référence à la fonction gettext permettant la localisation d'applications, le « ! » qui ordonne l'exécution d'une fonction et enfin le « # » utilisé dans beaucoup de langage pour indiquer que la ligne courante est un commentaire.

Nouveautés pour les blocs

Concernant les blocs, une grosse nouveauté fait son apparition : le bloc ELSE qui sera affiché uniquement si le bloc du même nom ne s'affiche pas.
Le gros avantage d'utiliser les blocs ELSE est que vous gagnez en lisibilité dans le code car justement, il y a moins de code...

Le reste étant compatible avec les anciens modèles de la phpLib, un exemple vaut mieux que ...blablabla, voici :

<table>
  <tr>
    <td>Name</td>
  </tr>
  <!-- BEGIN line -->
  <tr>
    <td>{$user|ucfirst}>/td>
  </tr>
  <!-- ELSE line -->
  <tr>
   <td>{_No data !}</td>
  </tr>
  <!-- END line -->
</table>

{!include:toto.tpl}

Comme vous le voyez, le principe des blocs est le même :

Le bloc line possède un bloc ELSE : si line n'est pas appelé, le contenu du bloc else sera alors affiché
Le contenu de la variable $user sera remplacée par le retour à l'appel de la fonction ucfirst (il est possible de mettre autant de fonction que l'on veut, ex: « {$user|strtolower|ucfirst|escape}) »
« {_No data !} » sera remplacé par « Pas de données ! »
Le contenu du fichier toto.tpl sera ajouté à la fin du modèle

Bien entendu, il est possible d'imbriquer une multitudes de blocs les uns dans les autres...

Il est possible de travailler simultanémnent avec plusieurs fichiers de gabarits, de plusieurs manières :

- Un appel à setCurrentFile permet de spécifier le fichier gabarit courant, notez que le dernier fichier déclaré grâce à la méthode importFile est désigné fichier courant
- Utilisez la syntaxe suivante : « identifiant_du_fichier:nom_du_bloc » dans l'appel à la méthode render

Côté php

Et voici ce que cela donne du côté du code php :

<?php

require 'tpl.class.php';

$t = new Tpl();
$t->importFile('tata.tpl');

$data = array('pif', 'paf', 'pouf');

foreach ($data as $name) {
  $t->setVar('user', $name);
  $t->render('line');
}

echo $t->render();

?>

Vous remarquerez qu'il n'est pas utile de déclarer à l'avance les blocs et c'est une très bonne chose, on gagne entre autre en simplicité !

Et les performances ?

C'est bien gentil de rajouter toutes ces fonctionnalités mais si c'est pour que ce soit plus lent que l'original, c'est pas terrible...
Ce nouveau moteur est plus de 10 fois plus rapide que celui de la phpLib (ce dernier étant considéré comme le plus rapide des moteurs « non compilés ») et jusqu'à 20 fois plus rapide en utilisant les spécificités du nouveau moteur (notamment les fonctions).
Le pic d'occupation mémoire est moindre à rendu final identique.

Vous êtes donc gagnant sur toute la ligne en utilisant ce nouveau moteur de modèle si vous utilisez celui de la PhpLib.

API

Le constructeur n'attends qu'un paramètre qui est le dossier oû sont stockés les gabarits, par défaut, c'est le dossier courant.

Voici les méthodes publiques, classées par catégories avec la liste des arguments qu'elles contiennent.

Gestion des fichiers

importFile : Importe un fichier de modèles
1. Id du fichier
2. Nom du fichier
3. Le chemin du fichier si il n'est pas inclu dans le chemin défini dans le constructeur
setCurrentFile : Si vous travaillez avec plusieurs modèles, il peut être utile de spécifier celui courant
1. Le nouveau fichier courant

Gestion des variables

setVar : Déclare le contenu d'une variable
1. Le nom de la variable
2. La valeur de la variable
setVars : Déclare le contenu de plusieurs variables à l'aide d'un tableau
1. Tableau de variable sous la forme : array('var1' => 'value1', 'var2' => 'value2')
removeUnknowVar : Spécifie si vous désirez voir les variables sans valeur du modèles s'afficher ou non
1. true ou false

Gestion des blocs

render : Procède au rendu d'un bloc et retourne ce dernier
1. Le nom du bloc voulu
2. Tableau de variable (attention, paramètre peut être amené à disparaitre dans les futures version)

Gestion des fonctions

registerFunction : Ajoute une fonction utilisateur
1. Le nom de la fonction qui sera utilisé dans le modèle
2. Le nom de la fonction
getFunctionList : Renvoie la liste des fontions
1. Si true, renvoie également la liste des fonctions utilisateurs (créées avec registerFunction)

Divers

setL10nCallback : Spécifie la fonction à appeler à chaque fois que le moteur trouve une variable du type {_XXX}
1. Spécifie la fonction de callback pour la traduction

Téléchargement

Le code source est bien sûr libre et est sous license GPL.

Pour le téléchargement, téléchargez l'annexe de ce billet, il inclu la classe Hyla_Tpl, une version autonome (standalone si vous préférez, c'est à dire indépendante de Hyla, le gestionnaire de fichiers) ainsi qu'un fichier php et ces gabarits d'exemples.

Attention, cliquez sur le lien suivant pour télécharger la toute dernière version de Hyla_Tpl.

Ouverture d'un gestionnaire de projets sous Trac

hugo — Fri, 25 Apr 2008 13:20:00 +0000

Voilà, c'est fait, Hyla dispose maintenant d'un gestionnaire de projet : Trac

Ce dernier dispose de fonctionnalités très intéressante comme un "bug tracker", une excellente intégration avec le serveur de source Subversion, un système de feuille de route, et j'en passe, bref, plein de choses sympathiques !

Voici l'adresse pour accéder à cet outils : http://dev.hyla-project.org/

À noter aussi, la création d'un nouveau dépôt de sources disponible à cette adresse : http://dev.hyla-project.org/svn/

Utilisez votre client subversion favoris pour récupérer les sources, en ligne de commande, ça donne ceci :

$ svn export http://anonymous@dev.hyla-project.org/svn/ hyla