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); // 删除缓存
复制代码
如果你设置了缓存前缀的话,对应的缓存操作只是对应该缓存前缀标识的,不会影响其他的缓存。