ThinkPHP函数详解:cache方法


cache方法是3.0版本开始新增的缓存管理方法。
注意:3.1.2版本后因cache方法并入原S方法,所以cache方法不再建议使用,用S方法即可。
cache 用于缓存设置、获取、删除操作
用法 cache($name, $value='',$options=null)
参数 name(必须):如果传入数组 则表示进行缓存初始化,如果是字符串则表示缓存赋值、获取或者删除操作。
Value(可选):要设置的缓存值,如果传入null表示删除缓存,默认为空字符串。
options(可选):要设置的缓存参数,如果是数字则表示仅设置有效期
返回值 见详(根据具体的用法返回不同的值)

缓存初始化

cache方法传入数组即表示进行缓存初始化,例如:
cache(array('type'=>'xcache','prefix'=>'think','expire'=>600));
支持的配置参数根据不同的缓存方式(由type参数设置),通用的缓存参数包括:
参数名 说明
expire 缓存有效期(时间为秒)
length 缓存队列长度
prefix 缓存标识前缀
type 缓存类型
如果没有设置type参数,则默认为文件缓存,cache方法目前可以支持的缓存类型包括File、Apachenote、Apc、Eaccelerator、Memcache、Shmop、Sqlite、Db、Redis、Xcache和WinCache,不同缓存类型的缓存参数可以参考这里:动态缓存
缓存初始化操作后返回的是一个缓存实例化对象。
如果你没有进行缓存初始化的话,cache方法会在你进行缓存操作之前自动初始化(用系统默认的缓存方式和缓存参数),默认缓存配置参数包括:
/* 数据缓存设置 */
'DATA_CACHE_TIME'       => 0,      // 数据缓存有效期 0表示永久缓存
'DATA_CACHE_COMPRESS'   => false,   // 数据缓存是否压缩缓存
'DATA_CACHE_CHECK'      => false,   // 数据缓存是否校验缓存
'DATA_CACHE_PREFIX'     => '',     // 缓存前缀
'DATA_CACHE_TYPE'       => 'File',  // 数据缓存类型
'DATA_CACHE_PATH'       => TEMP_PATH,// 缓存路径设置 (仅对File方式有效)
'DATA_CACHE_SUBDIR'     => false,  // 使用子目录缓存 (根据缓存标识的哈希创建子目录)
'DATA_PATH_LEVEL'       => 1,        // 子目录缓存级别
这些具体的缓存参数的用法,我们以后会在快速入门:缓存中详细描述。

缓存设置

缓存初始化之后,就可以进行缓存操作了,
cache('name','value');
会使用当前配置的缓存方式用name标识来缓存value值。
可以单独设置该缓存数据的有效期,例如:
cache('name','value',3600);
缓存数据一个小时。
为了保证缓存的安全,建议对返回值做出判断,如果缓存设置失败,则返回false,否则返回true。
3.1.2版本开始也可以直接在设置缓存的同时传入缓存设置参数,例如:
cache('name','value',array('type'=>'xcache','prefix'=>'think','expire'=>600));

获取缓存

$value = cache('name');
如果缓存标识不存在或者已经过期,则返回false,否则返回缓存值。

删除缓存

cache('name',NULL);
删除缓存标识为name的缓存数据。


如果要切换缓存方式,可以再次进行缓存初始化操作。
或者使用下面的方式:
$cache = cache(array('type'=>'xcache','prefix'=>'think','expire'=>600));
$cache->name = 'value'; // 设置缓存
$value = $cache->name; // 获取缓存
unset($cache->name); // 删除缓存
如果你设置了缓存前缀的话,对应的缓存操作只是对应该缓存前缀标识的,不会影响其他的缓存。