1 Star 0 Fork 31

tjloved / LinkCache

forked from 董楠 / LinkCache 
加入 Gitee
与超过 1200万 开发者一起发现、参与优秀开源项目,私有仓库也完全免费 :)
免费加入
克隆/下载
贡献代码
同步代码
取消
提示: 由于 Git 不支持空文件夾,创建文件夹后会生成空的 .keep 文件
Loading...
README

LinkCache - 一个灵活高效的PHP缓存工具库

LinkCache 是一个PHP编写的灵活高效的缓存工具库,提供多种缓存驱动支持,包括Memcache、Memcached、Redis、SSDB、文件缓存、APC、YAC等。通过LinkCache可以使不同缓存驱动实现操作统一,同时又可发挥不同缓存驱动各自的优势。LinkCache支持缓存 objectarray,同时为防止产生惊群现象做了优化。

环境要求

安装

composer 安装

LinkCache 可以通过 composer 安装,使用以下命令从 composer 下载安装 LinkCache

$ composer require dongnan/linkcache

手动下载安装

下载地址

安装方法

在你的入口文件中引入

<?php 
	//引入 LinkCache 的自动加载文件
	include("path_to_linkcache/autoload.php");

如何使用

(提示:如果以下锚点定位的链接错误,导致页面找不到等问题,请访问 https://github.com/dongnan/LinkCache 查看文档)

  • 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

配置信息

<?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

实例化缓存对象

<?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

获取缓存驱动实例

所有缓存驱动都必须实现 linkcache\interfaces\driver\Base 接口的方法,获取到缓存驱动实例后,可直接使用缓存驱动的方法,包括缓存驱动中没有定义但缓存驱动扩展对象中已定义的方法。

set

将参数中的 value 设置为 key 的值

参数

  • key - 字符串
  • value - 除了 resource 类型的所有的值
  • time - (可选参数) key 的生存时间,单位是秒(s)

返回值

Boolean 如果设置成功,返回 true; 如果设置失败,返回 false

例子

<?php
	//设置不过期的缓存
	$status = $cache->set($key, $value);
	//设置有过期时间的缓存
	$status = $cache->set($key, $value, $time);

setnx

当缓存中不存在 key 时,将参数中的 value 设置为 key 的值

参数

  • key - 字符串
  • value - 除了 resource 类型的所有的值
  • time - (可选参数) key 的生存时间,单位是秒(s)

返回值

Boolean - 如果设置成功,返回 true; 如果设置失败,返回 false

例子

<?php
	//设置不过期的缓存
	$status = $cache->setnx($key, $value);
	//设置有过期时间的缓存
	$status = $cache->setnx($key, $value, $time);

setDE

将参数中的 value设置为 key 的值,key 将自动延迟过期

参数

  • key - 字符串
  • value - 除了 resource 类型的所有的值
  • time - key 的生存时间,单位是秒(s)
  • delayTime - (可选参数) 延迟过期时间,如果未设置,则使用配置中的设置

返回值

Boolean - 如果设置成功,返回 true; 如果设置失败,返回 false

例子

<?php
	//设置不过期的缓存
	$status = $cache->setDE($key, $value);
	//设置有过期时间的缓存
	$status = $cache->setDE($key, $value, $time);
	//设置有过期时间的缓存并指定延迟过期时间
	$status = $cache->setDE($key, $value, $time, $delayTime);

get

获取 key 对应的值

参数

  • key - 字符串

返回值

Mixed - key 对应的值; 如果获取失败或 key 不存在,返回 false

例子

<?php
	//获取key对应的值
	$value = $cache->get($key);

getDE

获取 key 对应的值,与 setDE 配合使用

参数

  • key - 字符串
  • isExpired - key 理论上是否已经过期,这是一个引用变量,不需要初始化

返回值

Mixed - key 对应的值; 如果获取失败或 key 不存在,返回 false

例子

<?php
	//获取key对应的值
	$value = $cache->getDE($key, $isExpired);
	//如果已经过期,处理其他逻辑
	if ($isExpired) {
		//TODO
	}

del

删除 key

参数

  • key - 字符串

返回值

Boolean - 如果删除成功,返回 true; 如果删除失败,返回 false注意:key 不存在时,也会返回 true

例子

<?php
	//删除key
	$status = $cache->del($key);

has

判断 key 是否存在

参数

  • key - 字符串

返回值

Boolean - 如果 key 存在,返回 true;如果 key 不存在,返回 false

例子

<?php
	//判断key是否存在
	$status = $cache->has($key);

hasDE

判断延迟过期的 key 理论上是否存在。设置自动延期的 key,过期时间实际会被修改,用方法 has 判断的话,可能 key 仍然存在,但是理论上已经过期了

参数

  • key - 字符串

返回值

Boolean - 如果 key 存在,返回 true;如果 key 不存在,返回 false

例子

<?php
	//判断key是否存在
	$status = $cache->hasDE($key);

ttl

获取 key 的生存时间(单位:s)

参数

  • key - 字符串

返回值

Mixed - 生存剩余时间(单位:秒) -1 表示永不过期,-2 表示 key 不存在,失败返回 false

例子

<?php
	//获取key的生存时间
	$ttl = $cache->ttl($key);

ttlDE

获取延迟过期的 key 理论上的生存时间(单位:s)。

参数

  • key - 字符串

返回值

Mixed - 生存剩余时间(单位:秒) -1 表示永不过期,-2 表示 key 不存在,失败返回 false

例子

<?php
	//获取延迟过期的 key 理论上的生存时间(单位:s)
	$ttl = $cache->ttlDE($key);

expire

设置一个 key 的生存时间(单位:s)

参数

  • key - 字符串
  • time - 整数,key 的生存时间(单位:s)

返回值

Boolean - 如果设置成功,返回 true; 如果设置失败或 key 不存在,返回 false

例子

<?php
	//设置一个key的生存时间
	$status = $cache->expire($key, $time);

expireDE

以延迟过期的方式设置一个 key 的生存时间(单位:s)

参数

  • key - 字符串
  • time - 整数,key 的生存时间(单位:s)
  • delayTime - (可选参数) 延迟过期时间,如果未设置,则使用配置中的设置

返回值

Boolean - 如果设置成功,返回 true; 如果设置失败或 key 不存在,返回 false

例子

<?php
	//以延迟过期的方式设置一个 key 的生存时间(单位:s)
	$status = $cache->expireDE($key, $time);
	//自定义延迟过期时间
	$status = $cache->expireDE($key, $time, $delayTime);

expireAt

用UNIX时间戳设置一个 key 的过期时间

参数

  • key - 字符串
  • time - UNIX时间戳(单位:s)

返回值

Boolean - 如果设置成功,返回 true; 如果设置失败或 key 不存在,返回 false

例子

<?php
	//用UNIX时间戳设置一个key的过期时间
	$status = $cache->expireAt($key, $time);

expireAtDE

以延迟过期的方式用UNIX时间戳设置一个 key 的过期时间

参数

  • key - 字符串
  • time - UNIX时间戳(单位:s)
  • delayTime - (可选参数) 延迟过期时间,如果未设置,则使用配置中的设置

返回值

Boolean - 如果设置成功,返回 true; 如果设置失败或 key 不存在,返回 false

例子

<?php
	//用UNIX时间戳设置一个key的过期时间
	$status = $cache->expireAtDE($key, $time);
	//自定义延迟过期时间
	$status = $cache->expireAtDE($key, $time, $delayTime);

persist

删除一个 key 的生存时间,使其永不过期

参数

  • key - 字符串

返回值

Boolean - 如果设置成功,返回 true; 如果设置失败或 key 不存在,返回 false

例子

<?php
	//删除一个key的生存时间,使其永不过期
	$status = $cache->persist($key);

lock

key 设置锁标记(此锁并不对 key 做修改限制,仅为 key 的锁标记)

参数

  • key - 字符串
  • time - 整数,key锁标记 的生存时间(单位:s)

返回值

Boolean - 如果设置成功,返回 true; 如果 key 已存在或设置失败,返回 false

例子

<?php
	//对key设置锁标记
	$status = $cache->lock($key, $time);

isLock

判断 key 是否有锁标记

参数

  • key - 字符串

返回值

Boolean - 如果有锁标记,返回 true; 如果没有锁标记或判断失败,返回 false

例子

<?php
	//判断key是否有锁标记
	$status = $cache->isLock($key);

unLock

移除 key 的锁标记

参数

  • key - 字符串

返回值

Boolean - 如果移除成功,返回 true; 如果失败,返回 false

例子

<?php
	//移除key的锁标记
	$status = $cache->unLock($key);

incr

设置 key 的值按整数递增

参数

  • key - 字符串
  • step - (可选参数) 整数,递增步长,默认值为 1,可以为负值

返回值

Mixed - 递增后的值,失败返回 false,如果 key 不存在,则按 step 设置新值

例子

<?php
	//设置key的值按整数递增
	$value = $cache->incr($key, $step);

incrByFloat

设置 key 的值按浮点数递增

参数

  • key - 字符串
  • float - 浮点数,递增步长,可以为负值

返回值

Mixed - 递增后的值,失败返回 false,如果 key 不存在,则按 float 设置新值

例子

<?php
	//设置key的值按浮点数递增
	$value = $cache->incrByFloat($key, $float);

decr

设置 key 的值按整数递减

参数

  • key - 字符串
  • step - (可选参数) 整数,递减步长,默认值为 1,可以为负值

返回值

Mixed - 递减后的值,失败返回 false,如果 key 不存在,则按 -step 设置新值

例子

<?php
	//设置key的值按整数递减
	$value = $cache->decr($key, $step);

mSet

批量设置多个 key 对应的值

参数

  • sets - keyvalue 组成的键值对数组

返回值

Boolean - 如果设置成功,返回 true; 如果设置失败,返回 false

例子

<?php
	$sets = [
		'key1' => 'value1',
		'key2' => 'value2',
		'key3' => 'value3',
	];
	//批量设置多个key对应的值
	$status = $cache->mSet($sets);

mSetNX

当缓存中不存在 key 时,批量设置多个 key 对应的值

参数

  • sets - keyvalue 组成的键值对数组

返回值

Boolean - 如果设置成功,返回 true; 如果设置失败,返回 false

例子

<?php
	$sets = [
		'key1' => 'value1',
		'key2' => 'value2',
		'key3' => 'value3',
	];
	//当缓存中不存在key时,批量设置多个key对应的值
	$status = $cache->mSetNX($sets);

mGet

获取所有给定 key 的值

参数

  • keys - 多个 key 组成的数组

返回值

array - 参数 keys 中的所有 key 与对应的 value 组成的数组,如果 key 不存在或是获取失败,对应的 value 值为 false

例子

<?php
	$keys = ['key1', 'key2', 'key3'];
	//获取所有给定key的值
	$status = $cache->mGet($keys);

mHas

批量判断 key 是否存在

参数

  • keys - 多个 key 组成的数组

返回值

array - 返回存在的 key 的数组,如果判断失败返回 false

例子

<?php
	$keys = ['key1', 'key2', 'key3'];
	//批量判断key是否存在
	$hasKeys = $cache->mHas($keys);

mDel

批量删除 key

参数

  • keys - 多个 key 组成的数组

返回值

Boolean - 如果删除成功,返回 true; 如果删除失败,返回 false

例子

<?php
	$keys = ['key1', 'key2', 'key3'];
	//批量删除key
	$status = $cache->mDel($keys);

如何防止惊群

什么是惊群

首先,我们使用缓存的主要目的就是为了高并发情况下的高可用,换句话说,在使用了缓存的高并发的系统下,如果缓存突然都消失了,会发生什么?首先数据库的压力必然骤增,接着负载迅速升高,响应时间变慢,进程/线程由于响应时间变慢导致集压并剧增,这就是惊群。惊群的后果就是系统不可用甚至宕机。当然这是一个非常极端的例子,但是能很好的解释惊群现象。真实环境中,可能会有个一些页面是访问非常频繁的,如果这些页面的缓存在同一时间或相近的时间突然过期了,在高并发的情况下也会产生惊群现象。

如何避免惊群

知道了什么是惊群,就不难防止惊群了。首先,避免缓存在同一时间过期;其次,如果缓存过期,不要让所有并发的进程/线程都去触发更新同一缓存数据。

例子

LinkCache 为此专门做了优化,使用 LinkCache 提供的一些特殊方法,可以有效的防止惊群现象。以下是简单的示例(伪代码):

<?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
  • memcacheredisssdb 等缓存驱动的默认配置均参考官方默认配置
  • 自定义配置支持非驱动类型的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

  • 可自定义缓存 key 前缀,默认无 key 前缀

开发

如果你觉得LinkCache还不错,但又不支持你想用的缓存驱动,不妨尝试在LinkCache新增该缓存驱动的支持。

1.增加新的缓存驱动

目前有两种方式可以方便的开发新的缓存驱动支持

  • 继承 linkcache\abstracts\DriverSimple 抽象类

    1. src/linkcache/drivers 目录下创建新的缓存驱动类 Example.php
      <?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 实现这个方法
      	    }
      	
      	}
      
    2. 实现 linkcache\abstracts\DriverSimple 抽象类中的抽象方法
  • 实现接口 linkcache\interfaces\driver\Base (Base接口是必须的,你也可以实现更多的接口:Incr,Lock,Multi)

    1. src/linkcache/drivers 目录下创建新的缓存驱动类 Example.php
      <?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 实现这个方法
      	    }
      	
      	}
    2. 实现 linkcache\interfaces\driver\Base 接口中的方法

2.测试新增的驱动

为了保证代码的可靠性,不妨对新增的驱动做个测试吧。 我使用的是PHPUnit做的测试,版本:4.8.15

  • 测试步骤
    1. tests 目录新增测试类 TestDriverExample.php
      <?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';
      	}
    2. 进入LinkCache项目目录,执行测试命令
      phpunit --bootstrap autoload_dev.php tests/TestDriverExample
      显示以下信息测试就通过啦~
      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 协议

空文件

简介

一个灵活高效的PHP缓存工具库 展开 收起
PHP
取消

发行版

暂无发行版

贡献者

全部

近期动态

加载更多
不能加载更多了
PHP
1
https://gitee.com/tjloved/LinkCache.git
git@gitee.com:tjloved/LinkCache.git
tjloved
LinkCache
LinkCache
master

搜索帮助

14c37bed 8189591 565d56ea 8189591