Les Variables

Bonjour à tous,

Je vais exposer ici le principe des variables, comment on les utilise dans Talus' TPL. Je vais tout d'abord aborder (huhu) le coté pour le code PHP, puis le coté pour le Template, et vous présenter ainsi toutes les variables qu'il y a dans ce moteur.

Commençons !

Coté PHP

Les variables "Simples"

Vous avez plusieurs façons pour déclarer des variables TPL. Une, pour juste donner une valeur à une variable TPL, se fait via la méthode Talus_TPL::set(). Elle peut prendre deux parametres en arguments : le nom de la variable, et sa valeur. Ca peut également être un array, sans valeur pour le deuxième argument.

Ainsi, vous avez déclaré une variable "ma_var", et "autre_var". Pour ne pas vous perdre, j'ai obligé dans le code que les noms des variables suivent quelques standards de PHP (même convention de nommage).

Vous pouvez également donner des array pour le paramètre "valeur" (ou alors dans la valeur dans l'array), pour avoir accès à des array dans les templates. Ceux-ci seront vu dans le chapitre des boucles, qui sera présenté plus tard.

Vous pouvez aussi définir une variable par référence (comme PHP ; je vous invite à consulter le chapitre sur les références dans la doc PHP pour plus d'informations). C'est donc la deuxième façon d'instancier une variable.

La variable TPL "ma_ref" est donc liée par référence à la variable php $var.

Auto-filtrage des variables

Si vous désirez appliquer un filtre globalement à toutes les variables (déclarées et à déclarer), vous devez passer par la méthode Talus_TPL::autoFilters(), qui prend en paramètre soit un array de filtres, soit le nom d'un filtre.

Toutes les variables déclarées seront ainsi automatiquement échapées. Notez que chaque filtre est appelé sans les paramètres optionnels qui vont avec ; il est de même probable que la syntaxe pour appliquer plusieurs filtres changent d'ici la prochaine version.

C'est tout pour le moment... Au niveau du coté PHP ;)

Du coté TPL

Les Variables "Simples"

Pour afficher la valeur de la variable (et non pas avoir la variable en elle-même, comme dans les conditions par exemple. On le verra juste après ;)), vous devez juste mettre ce bout de code (en reprenant l'exemple de tout à l'heure, la variable `ma_var`) :

Pour obtenir la variable (sans qu'elle affiche quoique ce soit, mais juste pour avoir sa valeur en quelque sortes, c'est à dire l'équivalent d'un `$ma_var` en PHP), vous devez la préfixer avec un $, comme cela :

.

Pour avoir la valeur d'un élément dans un array, que ce soit pour afficher ou obtenir la valeur de la variable, vous devez juste rajouter les [] que vous voulez (comme en PHP) avant le } fermant le nom de la variable. Exemples :

Les Variables "Foreach"

Lorsque vous utilisez un foreach sur un array (on verra plus tard la structure des foreach, et la particularité de ceux-ci), pour acceder à la valeur correspondante de l'itération actuelle, vous devez faire :

P.S > Surpris par les /**/ ? Comme en PHP, vous pouvez commenter des morceau de TPLs, commentaires qui seront ignorés par la compilation !

Les Variables "Constantes"

Vous avez déclaré une constante quelque part (via la fonction define() de PHP) dans votre code, vous pouvez également acceder ou bien à sa valeur ou elle même !

Pour cela, une syntaxe appropriée est à utiliser :

Ou MA_CONSTANTE est la constante à utiliser. Vous devez donc préfixer et "suffixer" le nom de la variable par deux underscores (touche 8 pour un clavier azerty francophone). Bien entendu, pas d'array là dedans. Le renvoi de la constante en elle-même (exemple, dans une inclusion paramétrée) se fait de manière analogue aux variables :

Dans le même esprit, depuis la version 1.12, vous pouvez également utiliser des constantes de classe :

Ce sera tout pour le moment ;)

Sommaire : Aborder la Doc'
Chapitre Précédent : Les Templates
Chapitre Suivant : Conditions

(Mise à jour pour Talus' TPL 1.12)