控制输出缓存

通常情况下，开启缓存可以让整个最终输出的页面被缓存下来。 然而，Smarty 3提供了几种在输出缓存中控制部分区域不进行缓存的方法。

一般说明

注意在不缓存的区域内使用的全部变量，在页面每次加载时都会从PHP里重新赋值。

模板区域缓存控制

模板内的一块区域可以很容易地通过 {nocache} 和{/nocache} 标签来设置不进行缓存。


Example 15.10. 使模板的一块区域不进行缓存

  1.  
  2. 今天是：
  3. {nocache}
  4. {$smarty.now|date_format}
  5. {/nocache}
  6.  
  7.

上面的代码将在一个缓存的页面上输出当前日期时间。

标签的缓存控制

控制单个标签不进行缓存，可以为其加入"nocache"的属性。


Example 15.11. 让标签内容不进行缓存

  1. 今天是：
  2. {$smarty.now|date_format nocache}
  3.  
  4.

变量的缓存控制

你可以通过assign()来控制变量值不进行缓存。

说明

如果一个变量被设置了不缓存，那么它在页面每次加载时都会从PHP里重新赋值。

说明

变量不缓存的设置，会在编译后的代码中起效。所以如果你重新设置了某个变量不缓存，那么你需要删除已经存在的编译和缓存文件，使得模板可以重新编译并起效。


Example 15.12. 控制变量不缓存

  1. // 赋值$foo，并将其设置成不缓存的变量
  2. $smarty->assign('foo',time(),true);
  3.  
  4.  
  5. 动态的时间值是： {$foo}
  6.  
  7.

插件的缓存控制

你可以在注册一个插件时，同时控制插件的缓存。 registerPlugin() 的第三个参数是$cacheable，其默认是TRUE。

当你注册一个插件时，同时设置$cacheable=false， 那么插件会在每次页面显示的时候都被调用，即使页面整体已经被缓存了。 插件函数的这个行为和{insert}很相似。

说明

插件不缓存的设置，会在编译后的代码中起效。所以如果你重新设置了某个插件不缓存，那么你需要删除已经存在的编译和缓存文件，使得模板可以重新编译并起效。

对比{insert}也可以默认让插件不进行缓存。 它们可以通过第四个参数$cache_attrs来定义进行缓存。 $cache_attrs定义了一个需要进行缓存的属性数组， 然后这些属性会被写入缓存，以供插件每次执行的时候直接读取。


Example 15.13. 控制插件的缓存

  1. <?php
  2. $smarty->setCaching(Smarty::CACHING_LIFETIME_CURRENT);
  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->registerPlugin('function','remaining', 'remaining_seconds', false, array('endtime'));
  14.  
  15. if (!$smarty->isCached('index.tpl')) {
  16.     // 从db获取$obj 并赋值...
  17.     $smarty->assignByRef('obj', $obj);
  18. }
  19.  
  20. $smarty->display('index.tpl');
  21. ?>
  22.  
  23.

模板index.tpl 内容是： 

  1. 时间还有: {remaining endtime=$obj->endtime}
  2.  
  3.

即使页面被缓存了，$obj的倒计时也还是会在每次页面刷新的时候改变。 endtime属性仅在第一次页面显示的时候，被从db里面读取出来并写入到模板，然后就一直是直接从缓存内读取了。


Example 15.14. 使模板内一部分区域不缓存

  1. index.php:
  2.  
  3. <?php
  4. $smarty->setCaching(Smarty::CACHING_LIFETIME_CURRENT);
  5.  
  6. function smarty_block_dynamic($param, $content, $smarty) {
  7.     return $content;
  8. }
  9. $smarty->registerPlugin('block','dynamic', 'smarty_block_dynamic', false);
  10.  
  11. $smarty->display('index.tpl');
  12. ?>
  13.  
  14.

模板index.tpl的内容： 

  1. 页面创建于: {'0'|date_format:'%D %H:%M:%S'}
  2.  
  3. {dynamic}
  4.  
  5. 现在时间是: {'0'|date_format:'%D %H:%M:%S'}
  6.  
  7. ... 做些其他事情 ...
  8.  
  9. {/dynamic}
  10.  
  11.

刷新页面后你可以发现两个日期的不同。一个是“动态的”，另一个是“静态的”。 你可以像上面的代码一样把任何东西放{dynamic}…{/dynamic}标签内，来使其不缓存。

说明

上面的例子是展示了动态的区块插件是如何工作的。参见如何通过{nocache} 和 {/nocache}标签来进行模板区域缓存控制。

原文: https://www.smarty.net/docs/zh_CN/caching.cacheable.tpl