ThinkPHP函数详解:cache方法

cache方法是3.0版本开始新增的缓存管理方法。
注意:3.1.2版本后因cache方法并入原S方法,所以cache方法不再建议使用,用S方法即可。

cache 用于缓存设置、获取、删除操作

用法
cache($name, $value='',$options=null)

参数
name(必须):如果传入数组 则表示进行缓存初始化,如果是字符串则表示缓存赋值、获取或者删除操作。
Value(可选):要设置的缓存值,如果传入null表示删除缓存,默认为空字符串。
options(可选):要设置的缓存参数,如果是数字则表示仅设置有效期

返回值
见详(根据具体的用法返回不同的值)

缓存初始化
cache方法传入数组即表示进行缓存初始化,例如:
  1. 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方法会在你进行缓存操作之前自动初始化(用系统默认的缓存方式和缓存参数),默认缓存配置参数包括:

  1. /* 数据缓存设置 */
  2. 'DATA_CACHE_TIME' => 0, // 数据缓存有效期 0表示永久缓存
  3. 'DATA_CACHE_COMPRESS' => false, // 数据缓存是否压缩缓存
  4. 'DATA_CACHE_CHECK' => false, // 数据缓存是否校验缓存
  5. 'DATA_CACHE_PREFIX' => '', // 缓存前缀
  6. 'DATA_CACHE_TYPE' => 'File', // 数据缓存类型
  7. 'DATA_CACHE_PATH' => TEMP_PATH,// 缓存路径设置 (仅对File方式有效)
  8. 'DATA_CACHE_SUBDIR' => false, // 使用子目录缓存 (根据缓存标识的哈希创建子目录)
  9. 'DATA_PATH_LEVEL' => 1, // 子目录缓存级别

复制代码

这些具体的缓存参数的用法,我们以后会在快速入门:缓存中详细描述。

缓存设置
缓存初始化之后,就可以进行缓存操作了,
  1. cache('name','value');

复制代码

会使用当前配置的缓存方式用name标识来缓存value值。
可以单独设置该缓存数据的有效期,例如:

  1. cache('name','value',3600);

复制代码

缓存数据一个小时。
为了保证缓存的安全,建议对返回值做出判断,如果缓存设置失败,则返回false,否则返回true。
3.1.2版本开始也可以直接在设置缓存的同时传入缓存设置参数,例如:

  1. cache('name','value',array('type'=>'xcache','prefix'=>'think','expire'=>600));

复制代码

获取缓存
  1. $value = cache('name');

复制代码

如果缓存标识不存在或者已经过期,则返回false,否则返回缓存值。

删除缓存
  1. cache('name',NULL);

复制代码

删除缓存标识为name的缓存数据。
如果要切换缓存方式,可以再次进行缓存初始化操作。
或者使用下面的方式:

  1. $cache = cache(array('type'=>'xcache','prefix'=>'think','expire'=>600));
  2. $cache->name = 'value'; // 设置缓存
  3. $value = $cache->name; // 获取缓存
  4. unset($cache->name); // 删除缓存

复制代码

如果你设置了缓存前缀的话,对应的缓存操作只是对应该缓存前缀标识的,不会影响其他的缓存。