【ThinkPHP】5.1 完全开发手册 / 缓存

缓存

概述

ThinkPHP采用think\Cache类(实际使用think\facade\Cache类即可)提供缓存功能支持。

内置支持的缓存类型包括file、memcache、wincache、sqlite、redis和xcache。

设置

全局的缓存配置直接修改配置目录下面的cache.php文件。

公共的缓存配置参数包含:

参数名 描述
type 缓存类型或者缓存驱动类名
expire 缓存有效期(秒)
prefix 缓存标识前缀
serialize (非标量)是否需要自动序列化

不同的缓存驱动还需要配置额外的缓存参数。

如果你的应用只需要使用一种缓存类型,那么可以直接配置。

return [
// 缓存类型为File
'type'  =>  'file', 
// 全局缓存有效期(0为永久有效)
'expire'=>  0, 
// 缓存前缀
'prefix'=>  'think',
// 缓存目录
'path'  =>  '../runtime/cache/',
];

缓存参数根据不同的缓存方式会有所区别,通用的缓存参数如下:

参数 描述
type 缓存类型
expire 缓存有效期 (默认为0 表示永久缓存)
prefix 缓存前缀(默认为空)

使用

设置缓存

设置缓存有效期

Cache::set('name',$value,3600);

如果设置成功返回true,否则返回false。

缓存自增

针对数值类型的缓存数据,可以使用自增操作,例如:

// name自增(步进值为1)
Cache::inc('name');
// name自增(步进值为3)
Cache::inc('name',3);

缓存自减

针对数值类型的缓存数据,可以使用自减操作,例如:

// name自减(步进值为1)
Cache::dec('name');
// name自减(步进值为3)
Cache::dec('name',3);

获取缓存

获取缓存数据可以使用:

dump(Cache::get('name')); 

如果name值不存在,则默认返回 false。

支持指定默认值,例如:

dump(Cache::get('name','')); 

表示如果name值不存在,则返回空字符串。

删除缓存

Cache::rm('name'); 

获取并删除缓存

Cache::pull('name'); 

如果name值不存在,则返回null。

清空缓存

Cache::clear(); 

不存在则写入缓存数据后返回

Cache::remember('name',function(){
return time();
});

获取缓存对象

可以获取缓存对象,并且调用驱动类的高级方法,例如:

$cache = Cache::init();
// 获取缓存对象句柄
$handler = $cache->handler();

助手函数

系统对缓存操作提供了助手函数cache,用法如下:

$options = [
// 缓存类型为File
'type'   => 'File', 
// 缓存有效期为永久有效
'expire' => 0,
// 指定缓存目录
'path'   => APP_PATH . 'runtime/cache/', 
];

// 缓存初始化
// 不进行缓存初始化的话,默认使用配置文件中的缓存配置
cache($options);

// 设置缓存数据
cache('name', $value, 3600);
// 获取缓存数据
var_dump(cache('name'));
// 删除缓存数据
cache('name', NULL);

缓存标签

支持给缓存数据打标签,例如:

Cache::tag('tag')->set('name1','value1');
Cache::tag('tag')->set('name2','value2');

// 或者批量设置缓存标签
Cache::set('name1','value1');
Cache::set('name2','value2');
Cache::tag('tag',['name1','name2']);

// 清除tag标签的缓存数据
Cache::clear('tag');

同时使用多个缓存类型

如果要同时使用多个缓存类型进行操作的话,可以做如下配置:

return [
// 使用复合缓存类型
'type'  =>  'complex',
// 默认使用的缓存
'default'   =>  [
// 驱动方式
'type'   => 'file',
// 缓存保存目录
'path'   => '../runtime/default',
],
// 文件缓存
'file'   =>  [
// 驱动方式
'type'   => 'file',
// 设置不同的缓存保存目录
'path'   => '../runtime/file/',
],  
// redis缓存
'redis'   =>  [
// 驱动方式
'type'   => 'redis',
// 服务器地址
'host'       => '127.0.0.1',
],     
],

type配置为complex之后,就可以缓存多个缓存类型和缓存配置,每个缓存配置的方法和之前一样,并且你可以给相同类型的缓存类型(使用不同的缓存标识)配置不同的缓存配置参数。

return [
// 缓存配置为复合类型
'type'  =>  'complex', 
'default'	=>	[
'type'	=>	'file',
// 全局缓存有效期(0为永久有效)
'expire'=>  0, 
// 缓存前缀
'prefix'=>  'think',
// 缓存目录
'path'  =>  '../runtime/cache/',
],
'redis'	=>	[
'type'	=>	'redis',
'host'	=>	'127.0.0.1',
// 全局缓存有效期(0为永久有效)
'expire'=>  0, 
// 缓存前缀
'prefix'=>  'think',
],    
// 添加更多的缓存类型设置
];

没有指定缓存类型的话,默认读取的是default缓存配置

// 使用文件缓存
Cache::set('name','value',3600);
Cache::get('name');

// 使用Redis缓存
Cache::store('redis')->set('name','value',3600);
Cache::store('redis')->get('name');

// 切换到文件缓存
Cache::store('default')->set('name','value',3600);
Cache::store('default')->get('name');

还有一种方式是调用connect方法动态切换缓存。

$options = [
// 缓存类型为File
'type'  =>  'File', 
// 缓存有效期为永久有效
'expire'=>  0, 
//缓存前缀
'prefix'=>  'think',
// 指定缓存目录
'path'  =>  '../runtime/cache/',
];
Cache::connect($options)->set('name','value',3600);
Cache::connect($options)->get('name');

如果要返回当前缓存类型对象的句柄,可以使用

// 获取Redis对象 进行额外方法调用
Cache::store('redis')->handler();