Hyla project - Tag - php

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.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.

Les applications Php de gestion de fichiers

hugo — Tue, 02 Sep 2008 13:08:00 +0200

Le projet Hyla est dans une phase de développement intense pour la future version 0.9. Loin d'être en version stable pour l'instant elle a vu l'ajout de nombreuses fonctionnalités ces derniers mois, tel que les Web Services, la gestion de panier, le drag and drop etc…

C'est dans l'optique de toujours vouloir le meilleur pour Hyla que nous avons voulu le comparer a d'autres gestionnaires de fichiers en ligne. Cette comparaison prend la forme d'un tableau, comprenant une liste de fonctionnalités testées pour chaque application.

Cette comparaison a était fait en essayant d'être le plus objectif possible et de trouver des critères de comparaison juste. Bref, j'espère que ça aidera certain à trouver leur gestionnaire de fichiers qu'ils attendent depuis longtemps et j'espère, bien sûr, qu'il s'agira de Hyla... :)

Le comparatif

Spécificité des applications

Voici un tableau présentant brièvement chaque projet.

	eXtplorer	Hyla 0.8.2	Hyla 0.9.0dev	Kfm	PhpFileNavigator	PhpXplorer	Relay	SorgDownloader	WebInsta	WebShare
Logo / Site				Kfm
License	Gpl / Mpl	Gpl	Gpl	Spécifique	Gpl	Gpl	Spécifique	BSD	GPL	Gpl
Auteur	Soeren Eberhardt	Charles Rincheval	Charles Rincheval	Kae Verens	Lito	Tobias Bender	Chris Iufer / David Barshow	SlashOrg.net	Vikas Patial / Ceasar Feijen / Roland Poot	Virginie Vivancos
Origine	Allemagne	France	France	?	Espagne	Allemagne	États-Unis	France	Inde / Pays-Bas	France
Version testée	2.0.0	0.8.2	0.9.0dev	1.3	2.3.3	0.9.37	B01-071706	1.0.2	0.1.4	0.6.5a
Base de données	-	Mysql (1)	Mysql (1)	mysql, pgsql, sqlite, sqlitepdo (PEAR)	Mysql	Fichiers	Mysql	Mysql	-	Fichiers (2) / Mysql
Version Php	>= 4.3	>= 4.0.4	>= 4.0.4	>= 5.2	>= 4.0.6	?	>= 4	?	>= 4.2	?

1 : Sous forme de plugin, très simple d'étendre à d'autres base de données
2 : Infos stockées dans des fichiers .param directement dans l'arborescence

Fonctionnalités sur les fichiers / dossiers

Ce tableau compare les fonctionnalités les plus importantes pour un gestionnaire de fichiers : les actions de traitements sur ces derniers.

	eXtplorer	Hyla 0.8.2	Hyla 0.9.0dev	Kfm	PhpFileNavigator	PhpXplorer	Relay	SorgDownloader	WebInsta	WebShare
Création de fichiers	Oui	Non	Non	Oui	Oui	Oui (1)	Non	Non	Oui	Oui
Création de dossiers	Oui	Oui	Oui	Oui	Oui	Oui	Oui	Oui	Oui	Oui
Édition de fichiers texte	Oui	Non	Non	Oui	Oui	Oui	Non	Non	Oui	Oui
Édition d'images	Non	Non	Non	Oui	Non	Oui	Non	Non	Non	Non
Ajout de fichiers locaux	Oui	Oui	Oui	Oui	Oui	Oui	Oui	Oui (java)	Oui	Oui
Ajout de fichiers distants	Oui	Oui	Oui	Oui	Oui	Oui	Non	Non	Non	Non
Ajout multiple de fichiers	Oui	Oui	Oui	Non	Oui	Oui	Non	Oui	Oui	Oui
Déplacement fichier	Oui	Oui	Oui	Oui	Oui	Oui	Oui	Non	Oui	Oui
Déplacement dossier	Oui	Oui	Oui	Oui	Oui	Oui	Oui	Non	Oui	Oui
Déplacement multiple	Oui	Non	Oui	Oui	Oui	Oui (2)	Non	Non	Oui	Non
Copie fichier	Oui	Oui	Oui	Oui	Oui	Oui	Non	Non	Oui	Oui
Copie dossier	Oui	Oui	Oui	Oui	Oui	Oui	Non	Non	Oui	Oui
Copie multiple	Oui	Non	Oui	Oui	Oui	Oui (2)	Non	Non	Oui	Non
Renommage fichier	Oui	Oui	Oui	Oui	Oui	Oui	Oui	Non	Oui	Oui
Renommage dossier	Oui	Oui	Oui	Oui	Oui	Oui	Oui	Non	Non	Oui
Renommage multiple	Non	Non	Non	Oui	Non	Non	Non	Non	Non	Non
Suppression fichier	Oui	Oui	Oui	Oui	Oui	Oui	Oui	Oui	Oui	Oui
Suppression dossier	Oui	Oui	Oui	Oui	Oui	Oui	Oui	Oui	Oui	Oui
Téléchargement simple	Oui	Oui	Oui	Oui	Oui	Oui	Oui	Oui	Oui	Oui
Téléchargement dossier	Non	Oui	Oui	Oui	Oui (3)	Oui	Non	Non	Non	Oui
Extraction d'archives	Oui	Oui	Oui	Non	Oui	Oui	Non	Non	Non	Oui
Gestion de panier	Oui	Non	Oui	Oui	Non	Oui (2)	Oui	Non	Non	Non
Envoie de fichier par Email	Non	Non	Oui	Non	Oui	Non	Oui	Non	Non	Oui

1 : Possibilité de créer une multitude de modèle de fichiers (css, zip...)
2 : En passant par le presse papier
3 : Ne fonctionne pas sur mon installation

Divers

Enfin, voici un comparatif de fonctionnalités supplémentaires.

	eXtplorer	Hyla 0.8.2	Hyla 0.9.0dev	Kfm	PhpFileNavigator	PhpXplorer	Relay	SorgDownloader	WebInsta	WebShare
Valide (Xhtml, Html...)	Non	Oui	Oui	Non	Oui	Non	Non	Oui	Non	Non
Fonctionne sans Javascript	Non	Oui	Oui	Non	Non	Non	Non	Oui	Oui	Non
Commentaires	Non	Oui	Oui	Non	Non	Non	Non	Non	Non	Oui
Vue arborescence	Oui	Oui	Oui	Oui	Oui	Oui	Oui	Non	Non	Oui
Modèles (Thèmes)	Non	Oui	Oui	Oui	Non	Oui	Non	Non	Non	Oui
Galeries photos	Non	Oui	Oui	Oui	Non	Oui	Non	Non	Non	Oui
Gestion des archives	Oui	Oui	Oui	Oui	Oui	Oui	Non	Non	Non	Oui
Gestion des utilisateurs	Oui	Oui	Oui	Non	Oui	Oui	Oui	Oui	Non	Non
Gestion de groupes d'utilisateurs	Non	Oui	Oui	Non	Oui	Oui	Non	Non	Non	Non
Droits d'accès	Oui (1)	Oui	Oui	Oui (2)	Oui	Oui	Oui	Oui	Oui (1)	Oui (2)
Création de miniatures	Non	Oui	Oui	Oui	Non	Oui	Oui	Non	Non	Oui
Recherche	Oui	Oui	Oui	Oui	Oui	Non	Non	Non	Non	Oui
Drag'n'Drop	Oui	Non	Oui	Oui	Non	Non	Non	Non	Non	Oui
Diaporama	Non	Oui	Oui	Non	Non	Non	Non	Non	Non	Non
Multi-langue	Oui	Non	Oui	Oui	Oui	Oui	Non	Oui	Non	Oui
UTF8	Non	Oui	Oui	Oui	Oui	Non	Oui	Non	Non	Oui
Assistant à l'installation	Non	Oui	Oui	Non	Oui	Oui	Oui	Oui	Non	Non
Partage d'espace par clef	Non	Non	Non	Non	Non	Non	Non	Oui	Non	Non
Lecture différent format de fichiers	Non	Oui	Oui	Oui (3)	Non	Oui	Oui (3)	Non	Non	Oui
Tri	Oui	Oui	Oui	Oui	Oui	Oui	Non	Oui	Non	Oui
Vue attributs fichiers	Oui	Non	Oui	Oui	Oui	Oui	Oui	Non	Oui	Oui
Lecture de fichiers audio/vidéo	Non	Oui	Oui	Non	Non	Non	Non	Non	Non	Oui
Tags	Non	Non	Oui	Oui	Non	Non	Non (4)	Non	Non	Non
Statistiques / Log	Non	Non	Oui	Non	Oui	Non	0ui		Non	Non

1 : Assez simpliste
2 : Un seul utilisateur
3 : Uniquement les images
4 : Un sytème de flag est implémenté

Commentaires sur les projets

eXtplorer

Application très bien finie, propre, fonctionnelle, mais il manque tout de même des fonctions comme une gestion un peu plus poussée des droits, une vue en miniatures et pourquoi pas un support UTF8 du système de fichiers...

Hyla 0.8.2 & Hyla 0.9.0

Serait-ce vraiment objectif de parler de Hyla ici ?
Bref, sachez tout de même que la toute prochaine version 0.9.0 est actuellement en cours de développement intensif et vous promet beaucoup de nouveautés super sympas...
Je tiens également à préciser que la structure sous forme de plugin de Hyla vous permet de combler facilement ses manques, chose qui sera encore plus marqué dans la prochaine version.

Enfin, la version actuelle de Hyla et la version en cours de développement ne gère pas l'édition de fichiers, chose prévue pour la version 1.0.

Kfm

Le plus appréciable avec Kfm, c'est son nombre de fonctionnalités qui en fait un outils puissant, c'est d'ailleurs le seul à gérer le "renommage multiple" de fichiers qui peut s'avérer fort pratique...
Mais, son apparence très austère n'en fait pas pour moi un outils plaisant à utiliser au quotidien.

PHPfileNavigator

Très simple d'utilisation et possédant une belle apparence, c'est un bon outils, un reproche tout de même : on doit choisir entre la vue arborescente ou la vue en liste des fichiers, on ne peut pas afficher les 2 en même temps...

phpXplorer

Ceux à qui l'explorateur de Redmond manque, trouveront là l'application qui leur faut...
C'est une très bonne application et la version de développement promet beaucoup !

Relay

Il est très propre, bien fini et il possède un puissant système de statistiques vous permettant de rester au courant de toutes les actions sur les fichiers, de connaitre les fichiers les plus téléchargés, les utilisateurs les plus actifs, etc...

SorgDownloader

Il possède très peu d'action sur les fichiers / dossiers, ainsi, avec ce dernier, ne comptez pas copier ou déplacer des fichiers, à vrai dire, ce n'est pas vraiment son but, il est dans ce comparatif car il dispose d'une fonctionnalité très intéressante qui est le partage de dossier / document avec restriction, ainsi, il vous est possible de mettre à disposition de n'importe qui un document durant une durée limité ou encore de n'autoriser qu'un certain nombre de visualisation ou bien de restreindre l'accès qu'à une IP...

WebInsta

Rien de révolutionnaire dans cette application qui a le mérite d'être simple et sobre.

WebShare

C'est rapide et bourré de fonctions qui en font un très bon outils...à partir du moment ou on aime l'interface et pour ma part, ce n'est pas vraiment le cas...

Conclusion

10 projets, 10 façons de voir les choses, chacun à ces avantages et inconvénients mais tout le monde n'a pas la même utilité, ainsi, chacun devrait y trouver son compte...

Merci à AxlCorp pour le coup de patte :)

Autres projets

Voici une courte liste de projets tout aussi intéressants :

Filenice Léger, trop léger, enfin, clairement suffisant pour faire ce pourquoi il a été créé: partager des fichiers.
JBC Explorer Prévu dans le test au début et finalement retiré car ne disposant pas de suffisamment de fonctions de traitement sur les fichiers / dossiers.
Pâturage Une application sympa permettant de partager fichiers, signets et galeries photos d'une manière originale.

Démonstration des web services dans Hyla

hugo — Fri, 08 Aug 2008 17:49:00 +0200

Voici une petite vidéo montrant les nouvelles fonctionnalités de la future version de Hyla.

OUI, la qualité est pitoyable mais on voit tout de même le principal : l'application est "full ajax", on ne recharge pas la page à chaque action.

Démo Ws Hyla

Démo Ws Hyla from hugo on Vimeo.

On peut y voir au début l'utilisateur qui essaie de modifier la description de l'objet courant et d'un dossier alors qu'il n'est pas authentifié, une "popup" apparait alors lui expliquant qu'il n'a pas les droits suffisant pour l'action.

Ensuite, l'utilisateur s'authentifie et peut tranquillement modifier les descriptions qu'il souhaite.

Au final, on voit un déplacement de fichier directement en glisser déposer...

ps: pas d'inquiétude, l'application fonctionne toujours très bien sans javascript... :)