通常情况下,开启缓存可以让整个最终输出的页面被缓存下来。 然而,Smarty 3提供了几种在输出缓存中控制部分区域不进行缓存的方法。
一般说明
注意在不缓存的区域内使用的全部变量,在页面每次加载时都会从PHP里重新赋值。
模板内的一块区域可以很容易地通过
{nocache}
和{/nocache} 标签来设置不进行缓存。
Example 15.10. 使模板的一块区域不进行缓存
今天是:
{nocache}
{$smarty.now|date_format}
{/nocache}
上面的代码将在一个缓存的页面上输出当前日期时间。
控制单个标签不进行缓存,可以为其加入"nocache"的属性。
你可以通过assign()来控制变量值不进行缓存。
说明
如果一个变量被设置了不缓存,那么它在页面每次加载时都会从PHP里重新赋值。
说明
变量不缓存的设置,会在编译后的代码中起效。所以如果你重新设置了某个变量不缓存,那么你需要删除已经存在的编译和缓存文件,使得模板可以重新编译并起效。
你可以在注册一个插件时,同时控制插件的缓存。
registerPlugin()
的第三个参数是$cacheable,其默认是TRUE。
当你注册一个插件时,同时设置$cacheable=false,
那么插件会在每次页面显示的时候都被调用,即使页面整体已经被缓存了。
插件函数的这个行为和{insert}很相似。
说明
插件不缓存的设置,会在编译后的代码中起效。所以如果你重新设置了某个插件不缓存,那么你需要删除已经存在的编译和缓存文件,使得模板可以重新编译并起效。
对比{insert}也可以默认让插件不进行缓存。
它们可以通过第四个参数$cache_attrs来定义进行缓存。
$cache_attrs定义了一个需要进行缓存的属性数组,
然后这些属性会被写入缓存,以供插件每次执行的时候直接读取。
Example 15.13. 控制插件的缓存
<?php
$smarty->setCaching(Smarty::CACHING_LIFETIME_CURRENT);
function remaining_seconds($params, $smarty) {
$remain = $params['endtime'] - time();
if($remain >= 0){
return $remain . ' second(s)';
}else{
return 'done';
}
}
$smarty->registerPlugin('function','remaining', 'remaining_seconds', false, array('endtime'));
if (!$smarty->isCached('index.tpl')) {
// 从db获取$obj 并赋值...
$smarty->assignByRef('obj', $obj);
}
$smarty->display('index.tpl');
?>
模板index.tpl 内容是:
时间还有: {remaining endtime=$obj->endtime}
即使页面被缓存了,$obj的倒计时也还是会在每次页面刷新的时候改变。
endtime属性仅在第一次页面显示的时候,被从db里面读取出来并写入到模板,然后就一直是直接从缓存内读取了。
Example 15.14. 使模板内一部分区域不缓存
index.php:
<?php
$smarty->setCaching(Smarty::CACHING_LIFETIME_CURRENT);
function smarty_block_dynamic($param, $content, $smarty) {
return $content;
}
$smarty->registerPlugin('block','dynamic', 'smarty_block_dynamic', false);
$smarty->display('index.tpl');
?>
模板index.tpl的内容:
页面创建于: {'0'|date_format:'%D %H:%M:%S'}
{dynamic}
现在时间是: {'0'|date_format:'%D %H:%M:%S'}
... 做些其他事情 ...
{/dynamic}
刷新页面后你可以发现两个日期的不同。一个是“动态的”,另一个是“静态的”。
你可以像上面的代码一样把任何东西放{dynamic}...{/dynamic}标签内,来使其不缓存。
说明
上面的例子是展示了动态的区块插件是如何工作的。
参见如何通过{nocache}
和 {/nocache}标签来进行模板区域缓存控制。
