What is Smarty?
Why use it?
Use Cases and Work Flow
Syntax Comparison
Template Inheritance
Best Practices
Crash Course
You may use the Smarty logo according to the trademark notice.
For sponsorship, advertising, news or other inquiries, contact us at:
Les templates peuvent provenir d'une grande variété de ressources. Quand vous
affichez (display()
) ou
récupérez (fetch()
) un
template, ou quand vous incluez un template dans un autre template, vous fournissez
un type de ressource, suivi par le chemin approprié et le nom du template.
Si une ressource n'est pas explicitement donnée, la valeur de la variable $default_resource_type
sera utilisée.
Les templates du répertoire
$template_dir
n'ont pas
besoin d'une ressource template, bien que vous puissiez utiliser
la ressource "file" pour être cohérent. Vous n'avez qu'à fournir
le chemin vers le template que vous voulez utiliser, relatif
au répertoire racine
$template_dir
.
Example 15.6. Utilisation de templates depuis $template_dir
<?php $smarty->display("index.tpl"); $smarty->display("admin/menu.tpl"); $smarty->display("file:admin/menu.tpl"); // le même que ci-dessus ?> {* le template Smarty *} {include file="index.tpl"} {include file="file:index.tpl"} {* le même que ci-dessus *}
Les templates en-dehors du répertoire
$template_dir
nécessitent le type de ressource template, suivi du chemin absolu et du nom du
template.
Example 15.7. Utilisation d'un template depuis n'importe quel répertoire
<?php $smarty->display('file:/export/templates/index.tpl'); $smarty->display('file:/path/to/my/templates/menu.tpl'); ?>
Le template Smarty :
{include file='file:/usr/local/share/templates/navigation.tpl'}
Si vous utilisez Windows, les chemins de fichiers sont la plupart
du temps sur un disque identifié par une lettre (c:) au début du chemin.
Assurez-vous de bien mettre file:
dans le chemin pour éviter des
conflits d'espace de noms et obtenir les résultats escomptés.
Example 15.8. Utilisation de templates avec des chemins de fichiers Windows
<?php $smarty->display('file:C:/export/templates/index.tpl'); $smarty->display('file:F:/path/to/my/templates/menu.tpl'); ?>
Le template Smarty :
{include file='file:D:/usr/local/share/templates/navigation.tpl'}
Vous pouvez récupérer les templates à partir de n'importe quelle source à laquelle vous avez accès avec PHP : base de données, sockets, LDAP et ainsi de suite. Il suffit d'écrire les fonctions de ressource plugins et de les enregistrer auprès de Smarty.
Reportez-vous à la section ressource plugins pour plus d'informations sur les fonctions que vous êtes censé fournir.
Notez que vous ne pouvez pas écraser la ressource file:
native,
toutefois, vous pouvez fournir une ressource qui récupère un template depuis
le système de fichier par un autre moyen en l'enregistrant sous un autre
nom de ressource.
Example 15.9. Utilisation de ressources utilisateurs
<?php // mettez ces fonctions quelque part dans votre application function db_get_template ($tpl_name, &$tpl_source, &$smarty_obj) { // requête BD pour récupérer le template // et remplir $tpl_source $sql = new SQL; $sql->query("select tpl_source from my_table where tpl_name='$tpl_name'"); if ($sql->num_rows) { $tpl_source = $sql->record['tpl_source']; return true; } else { return false; } } function db_get_timestamp($tpl_name, &$tpl_timestamp, &$smarty_obj) { // requête BD pour remplir $tpl_timestamp $sql = new SQL; $sql->query("select tpl_timestamp from my_table where tpl_name='$tpl_name'"); if ($sql->num_rows) { $tpl_timestamp = $sql->record['tpl_timestamp']; return true; } else { return false; } } function db_get_secure($tpl_name, &$smarty_obj) { // on suppose que tous les templates sont svrs return true; } function db_get_trusted($tpl_name, &$smarty_obj) { // pas utilisée pour les templates dans notre cas } // enregistre le nom de ressource "db" $smarty->register_resource("db", array("db_get_template", "db_get_timestamp", "db_get_secure", "db_get_trusted")); // utilise la ressource depuis le script PHP $smarty->display("db:index.tpl"); ?>
Le template Smarty :
{include file='db:/extras/navigation.tpl'}
Vous pouvez spécifier une fonction qui sera utilisée pour récupérer le contenu d'un template dans le cas où le template ne peut pas être récupéré depuis sa ressource. Une utilisation possible est la création de templates à la volée.
Example 15.10. utilisation de la fonction de gestion de template par défaut
<?php // mettez cette fonction quelque part dans votre application function make_template ($resource_type, $resource_name, &$template_source, &$template_timestamp, &$smarty_obj) { if( $resource_type == 'file' ) { if ( ! is_readable ( $resource_name )) { // crée le fichier de template et renvoie le contenu $template_source = "Ceci est un nouveau template."; $template_timestamp = time(); $smarty_obj->_write_file($resource_name,$template_source); return true; } } else { // pas un fichier return false; } } // règle la fonction par défaut $smarty->default_template_handler_func = 'make_template'; ?>