概述

ThinkPHP采用think\Cache类提供缓存功能支持。

版本 新增功能
5.0.11 缓存设置方法有效期支持指定过期时间(DateTime
5.0.2 增加remember方法

设置

缓存支持采用驱动方式,所以缓存在使用之前,需要进行连接操作,也就是缓存初始化操作。

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

或者通过定义配置参数的方式,在应用配置文件中添加:

'cache'  => [
    'type'   => 'File',
    'path'   => CACHE_PATH,
    'prefix' => '',
    'expire' => 0,
],

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

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

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

使用

缓存初始化之后,就可以进行相关缓存操作了。

如果通过配置文件方式定义缓存参数的话,可以无需手动进行缓存初始化操作,可以直接进行缓存读取和设置等操作。

设置缓存

设置缓存(有效期一个小时)

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

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

V5.0.11版本开始,缓存有效期支持指定过期时间,用法:

Cache::set('name',$value,new DateTime('2017-10-1 12:00'));

表示缓存数据到2017年10月1日中午12点过期。

缓存自增

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

// 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(); 

不存在则写入缓存数据后返回(v5.0.2+

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('test', $value, $options); 

缓存标签

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

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');

同时使用多个缓存类型

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

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

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

当使用

Cache::set('name', 'value');
Cache::get('name');

的时候,其实使用的是default缓存标识的缓存配置,如果需要切换到其它的缓存标识操作,可以使用:

// 切换到file操作
Cache::store('file')->set('name','value');
Cache::get('name');
// 切换到redis操作
Cache::store('redis')->set('name','value');
Cache::get('name');