LinkCache - 一个灵活高效的PHP缓存工具库
LinkCache 是一个PHP编写的灵活高效的缓存工具库，提供多种缓存驱动支持，包括Memcache、Memcached、Redis、SSDB、文件缓存、APC、YAC等。通过LinkCache可以使不同缓存驱动实现操作统一，同时又可发挥不同缓存驱动各自的优势。LinkCache支持缓存 object 和 array，同时为防止产生惊群现象做了优化。, (*1)
环境要求
安装
composer 安装
LinkCache 可以通过 composer 安装，使用以下命令从 composer 下载安装 LinkCache, (*2)
$ composer require dongnan/linkcache
手动下载安装
下载地址
- 在
Git@OSC 下载 http://git.oschina.net/dongnan/LinkCache/tags
- 在
GitHub 下载 https://github.com/dongnan/LinkCache/releases
安装方法
在你的入口文件中引入, (*3)
<?php
//引入 LinkCache 的自动加载文件
include("path_to_linkcache/autoload.php");
如何使用
(提示:如果以下锚点定位的链接错误，导致页面找不到等问题，请访问 https://github.com/dongnan/LinkCache 查看文档), (*4)
-
config - 配置信息
-
instance - 缓存实例化
-
getDriver - 获取缓存驱动实例
-
set - 将参数中的
value设置为 key 的值
-
setnx - 当缓存中不存在
key 时，将参数中的 value 设置为 key 的值
-
setDE - 将参数中的
value设置为 key 的值，key 将自动延迟过期
-
get - 获取
key 对应的值
-
getDE - 获取
key 对应的值，与 setDE 配合使用
-
del - 删除
key
-
has - 判断
key 是否存在
-
hasDE - 判断延迟过期的
key 理论上是否存在
-
ttl - 获取
key 的生存时间(单位:s)
-
ttlDE - 获取延迟过期的
key 理论上的生存时间(单位:s)
-
expire - 设置一个
key 的生存时间(单位:s)
-
expireDE - 以延迟过期的方式设置一个
key 的生存时间(单位:s)
-
expireAt - 用UNIX时间戳设置一个
key 的过期时间
-
expireAtDE - 以延迟过期的方式用UNIX时间戳设置一个
key 的过期时间
-
persist - 删除一个
key 的生存时间，使其永不过期
-
lock - 对
key 设置锁标记（此锁并不对 key 做修改限制,仅为 key 的锁标记）
-
isLock - 判断
key 是否有锁标记
-
unLock - 移除
key 的锁标记
-
incr - 设置
key 的值按整数递增
-
incrByFloat - 设置
key 的值按浮点数递增
-
decr - 设置
key 的值按整数递减
-
mSet - 批量设置多个
key 对应的值
-
mSetNX - 当缓存中不存在
key 时，批量设置多个 key 对应的值
-
mGet - 获取所有给定
key 的值
-
mHas - 批量判断
key 是否存在
-
mDel - 批量删除
key
config
配置信息, (*5)
<?php
//设置缓存配置, 使用 array_merge 的方式合并到默认配置中
\linkcache\Cache::setConfig($config);
//获取配置信息
$config = \linkcache\Cache::getConfig();
//获取指定缓存驱动的配置信息
$config = \linkcache\Cache::getConfig('redis');
//默认配置信息
[
//默认使用的缓存驱动
'default' => 'files',
//当前缓存驱动失效时，使用的备份驱动
'fallback' => 'files',
'memcache' => [
'servers' => [
['host' => '127.0.0.1', 'port' => 11211, 'weight' => 1, 'persistent' => true, 'timeout' => 1, 'retry_interval' => 15, 'status' => true],
],
'compress' => ['threshold' => 2000, 'min_saving' => 0.2],
],
'memcached' => [
'servers' => [
['host' => '127.0.0.1', 'port' => 11211, 'weight' => 1],
],
//参考 Memcached::setOptions
'options' => [],
],
'redis' => [
'host' => '127.0.0.1',
'port' => 6379,
'password' => '',
'database' => '',
'timeout' => ''
],
'ssdb' => [
'host' => '127.0.0.1',
'port' => 8888,
'password' => '',
'timeoutms' => ''
],
]
instance
实例化缓存对象, (*6)
<?php
//直接new一个
$cache = new \linkcache\Cache();
//通过getInstance获取
$cache = \linkcache\Cache::getInstance();
//根据驱动类型实例化,支持的驱动:redis,memcache,memcached,ssdb,files,apc,yac
$cache = new \linkcache\Cache('files');
//或者
$cache = \linkcache\Cache::getInstance('files');
//传入配置参数实例化
$cache = new \linkcache\Cache('redis', ['host' => '127.0.0.1', 'port' => 6379]);
getDriver
获取缓存驱动实例, (*7)
所有缓存驱动都必须实现 linkcache\interfaces\driver\Base 接口的方法，获取到缓存驱动实例后，可直接使用缓存驱动的方法，包括缓存驱动中没有定义但缓存驱动扩展对象中已定义的方法。, (*8)
set
将参数中的 value 设置为 key 的值, (*9)
参数
- key - 字符串
- value - 除了
resource 类型的所有的值
- time - (可选参数)
key 的生存时间，单位是秒(s)
返回值
Boolean 如果设置成功，返回 true; 如果设置失败，返回 false, (*10)
例子
<?php
//设置不过期的缓存
$status = $cache->set($key, $value);
//设置有过期时间的缓存
$status = $cache->set($key, $value, $time);
setnx
当缓存中不存在 key 时，将参数中的 value 设置为 key 的值, (*11)
参数
- key - 字符串
- value - 除了
resource 类型的所有的值
- time - (可选参数)
key 的生存时间，单位是秒(s)
返回值
Boolean - 如果设置成功，返回 true; 如果设置失败，返回 false, (*12)
例子
<?php
//设置不过期的缓存
$status = $cache->setnx($key, $value);
//设置有过期时间的缓存
$status = $cache->setnx($key, $value, $time);
setDE
将参数中的 value设置为 key 的值，key 将自动延迟过期, (*13)
参数
- key - 字符串
- value - 除了
resource 类型的所有的值
- time -
key 的生存时间，单位是秒(s)
- delayTime - (可选参数) 延迟过期时间，如果未设置，则使用配置中的设置
返回值
Boolean - 如果设置成功，返回 true; 如果设置失败，返回 false, (*14)
例子
<?php
//设置不过期的缓存
$status = $cache->setDE($key, $value);
//设置有过期时间的缓存
$status = $cache->setDE($key, $value, $time);
//设置有过期时间的缓存并指定延迟过期时间
$status = $cache->setDE($key, $value, $time, $delayTime);
get
获取 key 对应的值, (*15)
参数
返回值
Mixed - key 对应的值; 如果获取失败或 key 不存在，返回 false, (*16)
例子
<?php
//获取key对应的值
$value = $cache->get($key);
getDE
获取 key 对应的值，与 setDE 配合使用, (*17)
参数
- key - 字符串
- isExpired -
key 理论上是否已经过期，这是一个引用变量，不需要初始化
返回值
Mixed - key 对应的值; 如果获取失败或 key 不存在，返回 false, (*18)
例子
<?php
//获取key对应的值
$value = $cache->getDE($key, $isExpired);
//如果已经过期，处理其他逻辑
if ($isExpired) {
//TODO
}
del
删除 key, (*19)
参数
返回值
Boolean - 如果删除成功，返回 true; 如果删除失败，返回 false。注意： 当 key 不存在时，也会返回 true, (*20)
例子
<?php
//删除key
$status = $cache->del($key);
has
判断 key 是否存在, (*21)
参数
返回值
Boolean - 如果 key 存在，返回 true；如果 key 不存在，返回 false, (*22)
例子
<?php
//判断key是否存在
$status = $cache->has($key);
hasDE
判断延迟过期的 key 理论上是否存在。设置自动延期的 key，过期时间实际会被修改，用方法 has 判断的话，可能 key 仍然存在，但是理论上已经过期了, (*23)
参数
返回值
Boolean - 如果 key 存在，返回 true；如果 key 不存在，返回 false, (*24)
例子
<?php
//判断key是否存在
$status = $cache->hasDE($key);
ttl
获取 key 的生存时间(单位:s), (*25)
参数
返回值
Mixed - 生存剩余时间(单位:秒) -1 表示永不过期,-2 表示 key 不存在,失败返回 false, (*26)
例子
<?php
//获取key的生存时间
$ttl = $cache->ttl($key);
ttlDE
获取延迟过期的 key 理论上的生存时间(单位:s)。, (*27)
参数
返回值
Mixed - 生存剩余时间(单位:秒) -1 表示永不过期,-2 表示 key 不存在,失败返回 false, (*28)
例子
<?php
//获取延迟过期的 key 理论上的生存时间(单位:s)
$ttl = $cache->ttlDE($key);
expire
设置一个 key 的生存时间(单位:s), (*29)
参数
- key - 字符串
- time - 整数，
key 的生存时间(单位:s)
返回值
Boolean - 如果设置成功，返回 true; 如果设置失败或 key 不存在，返回 false, (*30)
例子
<?php
//设置一个key的生存时间
$status = $cache->expire($key, $time);
expireDE
以延迟过期的方式设置一个 key 的生存时间(单位:s), (*31)
参数
- key - 字符串
- time - 整数，
key 的生存时间(单位:s)
- delayTime - (可选参数) 延迟过期时间，如果未设置，则使用配置中的设置
返回值
Boolean - 如果设置成功，返回 true; 如果设置失败或 key 不存在，返回 false, (*32)
例子
<?php
//以延迟过期的方式设置一个 key 的生存时间(单位:s)
$status = $cache->expireDE($key, $time);
//自定义延迟过期时间
$status = $cache->expireDE($key, $time, $delayTime);
expireAt
用UNIX时间戳设置一个 key 的过期时间, (*33)
参数
- key - 字符串
- time - UNIX时间戳(单位:s)
返回值
Boolean - 如果设置成功，返回 true; 如果设置失败或 key 不存在，返回 false, (*34)
例子
<?php
//用UNIX时间戳设置一个key的过期时间
$status = $cache->expireAt($key, $time);
expireAtDE
以延迟过期的方式用UNIX时间戳设置一个 key 的过期时间, (*35)
参数
- key - 字符串
- time - UNIX时间戳(单位:s)
- delayTime - (可选参数) 延迟过期时间，如果未设置，则使用配置中的设置
返回值
Boolean - 如果设置成功，返回 true; 如果设置失败或 key 不存在，返回 false, (*36)
例子
<?php
//用UNIX时间戳设置一个key的过期时间
$status = $cache->expireAtDE($key, $time);
//自定义延迟过期时间
$status = $cache->expireAtDE($key, $time, $delayTime);
persist
删除一个 key 的生存时间，使其永不过期, (*37)
参数
返回值
Boolean - 如果设置成功，返回 true; 如果设置失败或 key 不存在，返回 false, (*38)
例子
<?php
//删除一个key的生存时间，使其永不过期
$status = $cache->persist($key);
lock
对 key 设置锁标记（此锁并不对 key 做修改限制,仅为 key 的锁标记）, (*39)
参数
- key - 字符串
- time - 整数，
key锁标记 的生存时间(单位:s)
返回值
Boolean - 如果设置成功，返回 true; 如果 key 已存在或设置失败，返回 false, (*40)
例子
<?php
//对key设置锁标记
$status = $cache->lock($key, $time);
isLock
判断 key 是否有锁标记, (*41)
参数
返回值
Boolean - 如果有锁标记，返回 true; 如果没有锁标记或判断失败，返回 false, (*42)
例子
<?php
//判断key是否有锁标记
$status = $cache->isLock($key);
unLock
移除 key 的锁标记, (*43)
参数
返回值
Boolean - 如果移除成功，返回 true; 如果失败，返回 false, (*44)
例子
<?php
//移除key的锁标记
$status = $cache->unLock($key);
incr
设置 key 的值按整数递增, (*45)
参数
- key - 字符串
- step - (可选参数) 整数，递增步长，默认值为
1，可以为负值
返回值
Mixed - 递增后的值，失败返回 false，如果 key 不存在，则按 step 设置新值, (*46)
例子
<?php
//设置key的值按整数递增
$value = $cache->incr($key, $step);
incrByFloat
设置 key 的值按浮点数递增, (*47)
参数
- key - 字符串
- float - 浮点数，递增步长，可以为负值
返回值
Mixed - 递增后的值，失败返回 false，如果 key 不存在，则按 float 设置新值, (*48)
例子
<?php
//设置key的值按浮点数递增
$value = $cache->incrByFloat($key, $float);
decr
设置 key 的值按整数递减, (*49)
参数
- key - 字符串
- step - (可选参数) 整数，递减步长，默认值为
1，可以为负值
返回值
Mixed - 递减后的值，失败返回 false，如果 key 不存在，则按 -step 设置新值, (*50)
例子
<?php
//设置key的值按整数递减
$value = $cache->decr($key, $step);
mSet
批量设置多个 key 对应的值, (*51)
参数
- sets -
key 和 value 组成的键值对数组
返回值
Boolean - 如果设置成功，返回 true; 如果设置失败，返回 false, (*52)
例子
<?php
$sets = [
'key1' => 'value1',
'key2' => 'value2',
'key3' => 'value3',
];
//批量设置多个key对应的值
$status = $cache->mSet($sets);
mSetNX
当缓存中不存在 key 时，批量设置多个 key 对应的值, (*53)
参数
- sets -
key 和 value 组成的键值对数组
返回值
Boolean - 如果设置成功，返回 true; 如果设置失败，返回 false, (*54)
例子
<?php
$sets = [
'key1' => 'value1',
'key2' => 'value2',
'key3' => 'value3',
];
//当缓存中不存在key时，批量设置多个key对应的值
$status = $cache->mSetNX($sets);
mGet
获取所有给定 key 的值, (*55)
参数
返回值
array - 参数 keys 中的所有 key 与对应的 value 组成的数组，如果 key 不存在或是获取失败，对应的 value 值为 false, (*56)
例子
<?php
$keys = ['key1', 'key2', 'key3'];
//获取所有给定key的值
$status = $cache->mGet($keys);
mHas
批量判断 key 是否存在, (*57)
参数
返回值
array - 返回存在的 key 的数组，如果判断失败返回 false, (*58)
例子
<?php
$keys = ['key1', 'key2', 'key3'];
//批量判断key是否存在
$hasKeys = $cache->mHas($keys);
mDel
批量删除 key, (*59)
参数
返回值
Boolean - 如果删除成功，返回 true; 如果删除失败，返回 false, (*60)
例子
<?php
$keys = ['key1', 'key2', 'key3'];
//批量删除key
$status = $cache->mDel($keys);
如何防止惊群
什么是惊群
首先，我们使用缓存的主要目的就是为了高并发情况下的高可用，换句话说，在使用了缓存的高并发的系统下，如果缓存突然都消失了，会发生什么？首先数据库的压力必然骤增，接着负载迅速升高，响应时间变慢，进程/线程由于响应时间变慢导致集压并剧增，这就是惊群。惊群的后果就是系统不可用甚至宕机。当然这是一个非常极端的例子，但是能很好的解释惊群现象。真实环境中，可能会有个一些页面是访问非常频繁的，如果这些页面的缓存在同一时间或相近的时间突然过期了，在高并发的情况下也会产生惊群现象。, (*61)
如何避免惊群
知道了什么是惊群，就不难防止惊群了。首先，避免缓存在同一时间过期；其次，如果缓存过期，不要让所有并发的进程/线程都去触发更新同一缓存数据。, (*62)
例子
LinkCache 为此专门做了优化，使用 LinkCache 提供的一些特殊方法，可以有效的防止惊群现象。以下是简单的示例(伪代码)：, (*63)
<?php
/* LinkCache专为防止惊群现象设计的方法包括：
* setDE,getDE,hasDE,ttlDE,expireDE,expireAtDE,lock,isLock,unLock
* 比较常用的是:setDE,getDE,lock
*/
//设置缓存
$cache->setDE($key,$value,$time);
//获取缓存
$value = $cache->getDE($key,$isExpired);
//情况1，$value存在，$isExpired=false，不需要更新缓存
if($value !== false){
//your code
}
//情况2，$value存在，$isExpired=true，需要更新缓存
if($value !== false){
//your code
}
//更新缓存
if($isExpired === true){
//对key加锁标记，如果成功，则处理更新缓存操作 (锁标记默认过期时间是60s，也可自定义过期时间)
if($cache->lock($key)){
//更新缓存
}
}
//情况3，$value不存在，需要更新缓存
if($value === false){
//对key加锁标记，如果成功，则处理更新缓存操作 (锁标记默认过期时间是60s，也可自定义过期时间)
if($cache->lock($key)){
//更新缓存
}
//如果失败，说明已经有进程/线程对key加了锁标记，正在更新缓存
else{
//如果并发大，建议此处做特殊处理，不要去更新缓存
//特殊处理的代码
}
}
默认情况说明
-
Cache -
\linkcache\Cache
-
drivers
-
files -
\linkcache\drivers\Files
-
memcache -
\linkcache\drivers\Memcache
-
memcached -
\linkcache\drivers\Memcached
-
redis -
\linkcache\drivers\Redis
-
ssdb -
\linkcache\drivers\Ssdb
-
apc -
\linkcache\drivers\Apc
-
yac -
\linkcache\drivers\Yac
cache
- 默认使用的缓存驱动：
files
- 默认使用的备用驱动：
files
-
memcache、redis、ssdb 等缓存驱动的默认配置均参考官方默认配置
- 自定义配置支持非驱动类型的key，但配置信息中需要有
driver_type 属性，否则会抛异常，示例如下：
<?php
use \linkcache\Cache;
$config = [
'redis_m_db_1' => [
'driver_type' => 'redis',
'host' => '127.0.0.1',
'port' => 6380,
'database' => 1
],
'redis_m_db_2' => [
'driver_type' => 'redis',
'host' => '127.0.0.1',
'port' => 6380,
'database' => 2
],
'redis_s_db' => [
'driver_type' => 'redis',
'host' => '127.0.0.1',
'port' => 6381
]
];
Cache::setConfig($config);
//根据自定义配置实例化
$redisM1 = new Cache('redis_m_db_1');
$redisM2 = new Cache('redis_m_db_2');
$redisS0 = new Cache('redis_s_db');
drivers
- 所有驱动默认使用备用缓存
- 备用缓存优先使用实例化时构造函数传入的配置
config 中的 fallback 定义，如果没有定义，则使用 \linkcache\Cache::$config 中的 fallback 定义
files
- 默认保存路径：优先使用上传文件临时目录，未定义则使用系统临时目录，并在目录下创建linkcache目录，作为
files 驱动的默认保存路径，代码如下：
(ini_get('upload_tmp_dir') ? ini_get('upload_tmp_dir') : sys_get_temp_dir()) . '/linkcache'
memcache
- 当
memcache 连接断开后，最大重连次数为3次，重新建立连接后，连接重试次数清零
memcached
- 当
memcached 连接断开后，最大重连次数为3次，重新建立连接后，连接重试次数清零
redis
- 当
redis 连接断开后，最大重连次数为3次，重新建立连接后，连接重试次数清零
ssdb
- 当
ssdb 连接断开后，最大重连次数为3次，重新建立连接后，连接重试次数清零
apc
yac
开发
如果你觉得LinkCache还不错，但又不支持你想用的缓存驱动，不妨尝试在LinkCache新增该缓存驱动的支持。, (*64)
1.增加新的缓存驱动
目前有两种方式可以方便的开发新的缓存驱动支持, (*65)
-
继承 linkcache\abstracts\DriverSimple 抽象类, (*66)
-
在 src/linkcache/drivers 目录下创建新的缓存驱动类 Example.php, (*67)
<?php
/**
* linkcache - 一个灵活高效的PHP缓存工具库
*
* @author Dong Nan <hidongnan@gmail.com>
* @copyright (c) Dong Nan http://idongnan.cn All rights reserved.
* @link http://git.oschina.net/dongnan/LinkCache
* @license BSD (http://opensource.org/licenses/BSD-3-Clause)
*/
namespace linkcache\drivers;
use linkcache\abstracts\DriverSimple;
class Example extends DriverSimple {
/**
* 构造函数
* @param array $config 配置
*/
public function __construct($config = []) {
$this->init($config);
//TODO 完善这个方法
}
/**
* 检查驱动是否可用
* @return boolean 是否可用
*/
public function checkDriver() {
//TODO 实现这个方法
}
/**
* 设置键值
* @param string $key
* @param string $value
* @return boolean
*/
protected function setOne($key, $value) {
//TODO 实现这个方法
}
/**
* 获取键值
* @param string $key
* @return mixed
*/
protected function getOne($key) {
//TODO 实现这个方法
}
/**
* 删除键值
* @param string $key
* @return boolean
*/
protected function delOne($key) {
//TODO 实现这个方法
}
}
- 实现
linkcache\abstracts\DriverSimple 抽象类中的抽象方法
-
实现接口 linkcache\interfaces\driver\Base (Base接口是必须的，你也可以实现更多的接口:Incr,Lock,Multi), (*68)
-
在 src/linkcache/drivers 目录下创建新的缓存驱动类 Example.php, (*69)
<?php
/**
* linkcache - 一个灵活高效的PHP缓存工具库
*
* @author Dong Nan <hidongnan@gmail.com>
* @copyright (c) Dong Nan http://idongnan.cn All rights reserved.
* @link http://git.oschina.net/dongnan/LinkCache
* @license BSD (http://opensource.org/licenses/BSD-3-Clause)
*/
namespace linkcache\drivers;
use linkcache\interfaces\driver\Base;
class Example implements Base {
use \linkcache\traits\CacheDriver;
/**
* 构造函数
* @param array $config 配置
*/
public function __construct($config = []) {
$this->init($config);
//TODO 完善这个方法
}
/**
* 检查驱动是否可用
* @return boolean 是否可用
*/
public function checkDriver() {
//TODO 实现这个方法
}
/**
* 设置键值
* @param string $key 键名
* @param mixed $value 键值
* @param int $time 过期时间,默认为-1,<=0则设置为永不过期
* @return boolean 是否成功
*/
public function set($key, $value, $time = -1) {
//TODO 实现这个方法
}
/**
* 当键名不存在时设置键值
* @param string $key 键名
* @param mixed $value 键值
* @param int $time 过期时间,默认为-1,<=0则设置为永不过期
* @return boolean 是否成功
*/
public function setnx($key, $value, $time = -1) {
//TODO 实现这个方法
}
/**
* 设置键值，将自动延迟过期;<br>
* 此方法用于缓存对过期要求宽松的数据;<br>
* 使用此方法设置缓存配合getDE方法可以有效防止惊群现象发生
* @param string $key 键名
* @param mixed $value 键值
* @param int $time 过期时间，<=0则设置为永不过期
* @param int $delayTime 延迟过期时间，如果未设置，则使用配置中的设置
* @return boolean 是否成功
*/
public function setDE($key, $value, $time, $delayTime = null) {
//TODO 实现这个方法
}
/**
* 获取键值
* @param string $key 键名
* @return mixed|false 键值,失败返回false
*/
public function get($key) {
//TODO 实现这个方法
}
/**
* 获取延迟过期的键值，与setDE配合使用;<br>
* 此方法用于获取setDE设置的缓存数据;<br>
* 当isExpired为true时，说明key已经过期，需要更新;<br>
* 更新数据时配合isLock和lock方法，防止惊群现象发生
* @param string $key 键名
* @param boolean $isExpired 是否已经过期
* @return mixed|false 键值,失败返回false
*/
public function getDE($key, &$isExpired = null) {
//TODO 实现这个方法
}
/**
* 删除键值
* @param string $key 键名
* @return boolean 是否成功
*/
public function del($key) {
//TODO 实现这个方法
}
/**
* 是否存在键值
* @param string $key 键名
* @return boolean 是否存在
*/
public function has($key) {
//TODO 实现这个方法
}
/**
* 判断延迟过期的键值理论上是否存在
* @param string $key 键名
* @return boolean 是否存在
*/
public function hasDE($key) {
//TODO 实现这个方法
}
/**
* 获取生存剩余时间
* @param string $key 键名
* @return int|false 生存剩余时间(单位:秒) -1表示永不过期,-2表示键值不存在,失败返回false
*/
public function ttl($key) {
//TODO 实现这个方法
}
/**
* 获取延迟过期的键值理论生存剩余时间
* @param string $key 键名
* @return int|false 生存剩余时间(单位:秒) -1表示永不过期,-2表示键值不存在,失败返回false
*/
public function ttlDE($key) {
//TODO 实现这个方法
}
/**
* 设置过期时间
* @param string $key 键名
* @param int $time 过期时间(单位:秒)。不大于0，则设为永不过期
* @return boolean 是否成功
*/
public function expire($key, $time) {
//TODO 实现这个方法
}
/**
* 以延迟过期的方式设置过期时间
* @param string $key 键名
* @param int $time 过期时间(单位:秒)。不大于0，则设为永不过期
* @param int $delayTime 延迟过期时间，如果未设置，则使用配置中的设置
* @return boolean 是否成功
*/
public function expireDE($key, $time, $delayTime = null) {
//TODO 实现这个方法
}
/**
* 移除指定键值的过期时间
* @param string $key 键名
* @return boolean 是否成功
*/
public function persist($key) {
//TODO 实现这个方法
}
}
- 实现
linkcache\interfaces\driver\Base 接口中的方法
2.测试新增的驱动
为了保证代码的可靠性，不妨对新增的驱动做个测试吧。
我使用的是PHPUnit做的测试，版本：4.8.15, (*70)
-
测试步骤, (*71)
-
在 tests 目录新增测试类 TestDriverExample.php, (*72)
<?php
/**
* linkcache - 一个灵活高效的PHP缓存工具库
*
* @author Dong Nan <hidongnan@gmail.com>
* @copyright (c) Dong Nan http://idongnan.cn All rights reserved.
* @link http://git.oschina.net/dongnan/LinkCache
* @license BSD (http://opensource.org/licenses/BSD-3-Clause)
*/
namespace linkcacheTests;
/**
* TestDriverExample
*/
class TestDriverExample extends TestDriverFiles
{
protected $cacheDriver = 'example';
}
-
进入LinkCache项目目录，执行测试命令, (*73)
phpunit --bootstrap autoload_dev.php tests/TestDriverExample
显示以下信息测试就通过啦~, (*74)
PHPUnit 4.8.15 by Sebastian Bergmann and contributors.
....................
Time: 8.24 seconds, Memory: 8.75Mb
OK (26 tests, 105 assertions)
LICENSE
使用非常灵活宽松的 New BSD License 协议, (*75)
Wallogit.com
dongnan