Manuel Smarty

Niveau superieur
Sommaire

Contrôler la mise en cache des sorties des Plugins

Depuis Smarty-2.6.0, la mise en cache des plugins peut être déclarée lors de leur inscription. Les troisièmes paramètres de register_block(), register_compiler_function() et register_function() sont appelés $cacheable et valent TRUE par défaut, ce qui est aussi le comportement par défaut des versions de Smarty précédent la 2.6.0

Lors de l'inscription d'un plugin avec $cacheable=false, le plugin est appelé à chaque fois que la page est affichée, même si la page vient du cache. La fonction plugin se comporte presque comme la fonction {insert}.

Contrairement à {insert} les attributs pour le plugin ne sont pas mis en cache par défaut. Celà peut être le cas en utilisant le quatrième paramètre $cache_attrs. $cache_attrs est un tableau de noms d'attributs qui doivent être mis en cache, pour que la fonction plugin reçoive les valeurs telles qu'elles étaient définies lorsque la page a été mise en cache, à chaque récupération à partir du cache.

Exemple 14-10. Eviter la mise en cache du résultat d'un plugin

  1. <?php
  2. $smarty->caching = 1;  
  3.  
  4. function remaining_seconds($params, &$smarty) { 
  5.    $remain = $params['endtime'] - time(); 
  6.    if ($remain >=0) { 
  7.       return $remain . " second(s)"; 
  8.    } else { 
  9.       return "done"; 
  10.    }  
  11. }  
  12.  
  13. $smarty->register_function('remaining', 'remaining_seconds', false, array('endtime'));  
  14.  
  15. if (!$smarty->is_cached('index.tpl')) { 
  16.    // récupération de $obj à partir de la page et assignation...
  17.    $smarty->assign_by_ref('obj', $obj);  
  18. }  
  19.  
  20. $smarty->display('index.tpl');  
  21. ?> 

Où index.tpl contient :

Time Remaining: {remaining endtime=$obj->endtime}

Le nombre de secondes avant que la date de fin de $obj ne soit atteinte change à chaque affichage de la page, même si la page est mise en cache. Comme l'attribut endtime est mis en cache, il n'y a que l'objet qui ait besoin d'être extrait de la base de données lors de la mise en cache de la page, mais pas lors des affichages ultérieurs de la page.

Exemple 14-11. Eviter la mise en cache d'une portion du template

  1. <?php
  2. require('Smarty.class.php');  
  3. $smarty = new Smarty;  
  4. $smarty->caching = true;  
  5.  
  6. function smarty_block_dynamic($param, $content, &$smarty) { 
  7.    return $content;  
  8. }  
  9. $smarty->register_block('dynamic', 'smarty_block_dynamic', false);  
  10.  
  11. $smarty->display('index.tpl');  
  12. ?> 

Où index.tpl contient :

Création de la page : {'0'|date_format:'%D %H:%M:%S'}

{dynamic}

Heure actuelle : {'0'|date_format:'%D %H:%M:%S'}

... faîtes quelque chose ici ...

{/dynamic}

Lors du rechargement de la page, vous remarquerez que les deux dates sont différentes. L'une est << dynamic >> et l'autre est << static >>. Vous pouvez faire ce que vous voulez entre {dynamic}...{/dynamic} et être sûrs que cela ne sera pas mis en cache comme le reste de la page.

Niveau superieur
Sommaire

Remonter Remonter
L'éditeur javascript - CSS - Gentoo - Tutoriaux PHP - Tutoriels PHP - Bretagne - php - Moto - Kit graphique