PHP实现的Redis操作通用类示例

<?php
/**
 * redis操作类
 * 说明，任何为false的串，存在redis中都是空串。
 * 只有在key不存在时，才会返回false。
 * 这点可用于防止缓存穿透
 *
 */
class redis
{
  private $redis;
  //当前数据库id号
  protected $dbid=0;
  //当前权限认证码
  protected $auth;
  /**
   * 实例化的对象,单例模式.
   * @var \iphp\db\redis
   */
  static private $_instance=array();
  private $k;
  //连接属性数组
  protected $attr=array(
    //连接超时时间，redis配置文件中默认为300秒
    'timeout'=>30,
    //选择的数据库。
    'db_id'=>0,
  );
  //什么时候重新建立连接
  protected $expiretime;
  protected $host;
  protected $port;
  private function __construct($config,$attr=array())
  {
    $this->attr    =  array_merge($this->attr,$attr);
    $this->redis  =  new redis();
    $this->port    =  $config['port'] ? $config['port'] : 6379;
    $this->host    =  $config['host'];
    $this->redis->connect($this->host, $this->port, $this->attr['timeout']);
    if($config['auth'])
    {
      $this->auth($config['auth']);
      $this->auth  =  $config['auth'];
    }
    $this->expiretime  =  time() + $this->attr['timeout'];
  }
  /**
   * 得到实例化的对象.
   * 为每个数据库建立一个连接
   * 如果连接超时，将会重新建立一个连接
   * @param array $config
   * @param int $dbid
   * @return \iphp\db\redis
   */
  public static function getinstance($config, $attr = array())
  {
    //如果是一个字符串，将其认为是数据库的id号。以简化写法。
    if(!is_array($attr))
    {
      $dbid  =  $attr;
      $attr  =  array();
      $attr['db_id']  =  $dbid;
    }
    $attr['db_id']  =  $attr['db_id'] ? $attr['db_id'] : 0;
    $k  =  md5(implode('', $config).$attr['db_id']);
    if(! (static::$_instance[$k] instanceof self))
    {
      static::$_instance[$k] = new self($config,$attr);
      static::$_instance[$k]->k    =  $k;
      static::$_instance[$k]->dbid  =  $attr['db_id'];
      //如果不是0号库，选择一下数据库。
      if($attr['db_id'] != 0){
        static::$_instance[$k]->select($attr['db_id']);
      }
    }
    elseif( time() > static::$_instance[$k]->expiretime)
    {
      static::$_instance[$k]->close();
      static::$_instance[$k]     =   new self($config,$attr);
      static::$_instance[$k]->k  =  $k;
      static::$_instance[$k]->dbid=  $attr['db_id'];
      //如果不是0号库，选择一下数据库。
      if($attr['db_id']!=0){
        static::$_instance[$k]->select($attr['db_id']);
      }
    }
    return static::$_instance[$k];
  }
  private function __clone(){}
  /**
   * 执行原生的redis操作
   * @return \redis
   */
  public function getredis()
  {
    return $this->redis;
  }
  /*****************hash表操作函数*******************/
  /**
   * 得到hash表中一个字段的值
   * @param string $key 缓存key
   * @param string $field 字段
   * @return string|false
   */
  public function hget($key,$field)
  {
    return $this->redis->hget($key,$field);
  }
  /**
   * 为hash表设定一个字段的值
   * @param string $key 缓存key
   * @param string $field 字段
   * @param string $value 值。
   * @return bool 
   */
  public function hset($key,$field,$value)
  {
    return $this->redis->hset($key,$field,$value);
  }
  /**
   * 判断hash表中，指定field是不是存在
   * @param string $key 缓存key
   * @param string $field 字段
   * @return bool
   */
  public function hexists($key,$field)
  {
    return $this->redis->hexists($key,$field);
  }
  /**
   * 删除hash表中指定字段 ,支持批量删除
   * @param string $key 缓存key
   * @param string $field 字段
   * @return int
   */
  public function hdel($key,$field)
  {
    $fieldarr=explode(',',$field);
    $delnum=0;
    foreach($fieldarr as $row)
    {
      $row=trim($row);
      $delnum+=$this->redis->hdel($key,$row);
    }
    return $delnum;
  }
  /**
   * 返回hash表元素个数
   * @param string $key 缓存key
   * @return int|bool
   */
  public function hlen($key)
  {
    return $this->redis->hlen($key);
  }
  /**
   * 为hash表设定一个字段的值,如果字段存在，返回false
   * @param string $key 缓存key
   * @param string $field 字段
   * @param string $value 值。
   * @return bool
   */
  public function hsetnx($key,$field,$value)
  {
    return $this->redis->hsetnx($key,$field,$value);
  }
  /**
   * 为hash表多个字段设定值。
   * @param string $key
   * @param array $value
   * @return array|bool
   */
  public function hmset($key,$value)
  {
    if(!is_array($value))
      return false;
    return $this->redis->hmset($key,$value); 
  }
  /**
   * 为hash表多个字段设定值。
   * @param string $key
   * @param array|string $value string以','号分隔字段
   * @return array|bool
   */
  public function hmget($key,$field)
  {
    if(!is_array($field))
      $field=explode(',', $field);
    return $this->redis->hmget($key,$field);
  }
  /**
   * 为hash表设这累加，可以负数
   * @param string $key
   * @param int $field
   * @param string $value
   * @return bool
   */
  public function hincrby($key,$field,$value)
  {
    $value=intval($value);
    return $this->redis->hincrby($key,$field,$value);
  }
  /**
   * 返回所有hash表的所有字段
   * @param string $key
   * @return array|bool
   */
  public function hkeys($key)
  {
    return $this->redis->hkeys($key);
  }
  /**
   * 返回所有hash表的字段值，为一个索引数组
   * @param string $key
   * @return array|bool
   */
  public function hvals($key)
  {
    return $this->redis->hvals($key);
  }
  /**
   * 返回所有hash表的字段值，为一个关联数组
   * @param string $key
   * @return array|bool
   */
  public function hgetall($key)
  {
    return $this->redis->hgetall($key);
  }
  /*********************有序集合操作*********************/
  /**
   * 给当前集合添加一个元素
   * 如果value已经存在，会更新order的值。
   * @param string $key
   * @param string $order 序号
   * @param string $value 值
   * @return bool
   */
  public function zadd($key,$order,$value)
  {
    return $this->redis->zadd($key,$order,$value);  
  }
  /**
   * 给$value成员的order值，增加$num,可以为负数
   * @param string $key
   * @param string $num 序号
   * @param string $value 值
   * @return 返回新的order
   */
  public function zincry($key,$num,$value)
  {
    return $this->redis->zincry($key,$num,$value);
  }
  /**
   * 删除值为value的元素
   * @param string $key
   * @param stirng $value
   * @return bool
   */
  public function zrem($key,$value)
  {
    return $this->redis->zrem($key,$value);
  }
  /**
   * 集合以order递增排列后，0表示第一个元素，-1表示最后一个元素
   * @param string $key
   * @param int $start
   * @param int $end
   * @return array|bool
   */
  public function zrange($key,$start,$end)
  {
    return $this->redis->zrange($key,$start,$end);
  }
  /**
   * 集合以order递减排列后，0表示第一个元素，-1表示最后一个元素
   * @param string $key
   * @param int $start
   * @param int $end
   * @return array|bool
   */
  public function zrevrange($key,$start,$end)
  {
    return $this->redis->zrevrange($key,$start,$end);
  }
  /**
   * 集合以order递增排列后，返回指定order之间的元素。
   * min和max可以是-inf和+inf　表示最大值，最小值
   * @param string $key
   * @param int $start
   * @param int $end
   * @package array $option 参数
   *   withscores=>true，表示数组下标为order值，默认返回索引数组
   *   limit=>array(0,1) 表示从0开始，取一条记录。
   * @return array|bool
   */
  public function zrangebyscore($key,$start='-inf',$end="+inf",$option=array())
  {
    return $this->redis->zrangebyscore($key,$start,$end,$option);
  }
  /**
   * 集合以order递减排列后，返回指定order之间的元素。
   * min和max可以是-inf和+inf　表示最大值，最小值
   * @param string $key
   * @param int $start
   * @param int $end
   * @package array $option 参数
   *   withscores=>true，表示数组下标为order值，默认返回索引数组
   *   limit=>array(0,1) 表示从0开始，取一条记录。
   * @return array|bool
   */
  public function zrevrangebyscore($key,$start='-inf',$end="+inf",$option=array())
  {
    return $this->redis->zrevrangebyscore($key,$start,$end,$option);
  }
  /**
   * 返回order值在start end之间的数量
   * @param unknown $key
   * @param unknown $start
   * @param unknown $end
   */
  public function zcount($key,$start,$end)
  {
    return $this->redis->zcount($key,$start,$end);
  }
  /**
   * 返回值为value的order值
   * @param unknown $key
   * @param unknown $value
   */
  public function zscore($key,$value)
  {
    return $this->redis->zscore($key,$value);
  }
  /**
   * 返回集合以score递增加排序后，指定成员的排序号，从0开始。
   * @param unknown $key
   * @param unknown $value
   */
  public function zrank($key,$value)
  {
    return $this->redis->zrank($key,$value);
  }
  /**
   * 返回集合以score递增加排序后，指定成员的排序号，从0开始。
   * @param unknown $key
   * @param unknown $value
   */
  public function zrevrank($key,$value)
  {
    return $this->redis->zrevrank($key,$value);
  }
  /**
   * 删除集合中，score值在start end之间的元素　包括start end
   * min和max可以是-inf和+inf　表示最大值，最小值
   * @param unknown $key
   * @param unknown $start
   * @param unknown $end
   * @return 删除成员的数量。
   */
  public function zremrangebyscore($key,$start,$end)
  {
    return $this->redis->zremrangebyscore($key,$start,$end);
  }
  /**
   * 返回集合元素个数。
   * @param unknown $key
   */
  public function zcard($key)
  {
    return $this->redis->zcard($key);
  }
  /*********************队列操作命令************************/
  /**
   * 在队列尾部插入一个元素
   * @param unknown $key
   * @param unknown $value
   * 返回队列长度
   */
  public function rpush($key,$value)
  {
    return $this->redis->rpush($key,$value); 
  }
  /**
   * 在队列尾部插入一个元素 如果key不存在，什么也不做
   * @param unknown $key
   * @param unknown $value
   * 返回队列长度
   */
  public function rpushx($key,$value)
  {
    return $this->redis->rpushx($key,$value);
  }
  /**
   * 在队列头部插入一个元素
   * @param unknown $key
   * @param unknown $value
   * 返回队列长度
   */
  public function lpush($key,$value)
  {
    return $this->redis->lpush($key,$value);
  }
  /**
   * 在队列头插入一个元素 如果key不存在，什么也不做
   * @param unknown $key
   * @param unknown $value
   * 返回队列长度
   */
  public function lpushx($key,$value)
  {
    return $this->redis->lpushx($key,$value);
  }
  /**
   * 返回队列长度
   * @param unknown $key
   */
  public function llen($key)
  {
    return $this->redis->llen($key); 
  }
  /**
   * 返回队列指定区间的元素
   * @param unknown $key
   * @param unknown $start
   * @param unknown $end
   */
  public function lrange($key,$start,$end)
  {
    return $this->redis->lrange($key,$start,$end);
  }
  /**
   * 返回队列中指定索引的元素
   * @param unknown $key
   * @param unknown $index
   */
  public function lindex($key,$index)
  {
    return $this->redis->lindex($key,$index);
  }
  /**
   * 设定队列中指定index的值。
   * @param unknown $key
   * @param unknown $index
   * @param unknown $value
   */
  public function lset($key,$index,$value)
  {
    return $this->redis->lset($key,$index,$value);
  }
  /**
   * 删除值为vaule的count个元素
   * php-redis扩展的数据顺序与命令的顺序不太一样，不知道是不是bug
   * count>0 从尾部开始
   * >0　从头部开始
   * =0　删除全部
   * @param unknown $key
   * @param unknown $count
   * @param unknown $value
   */
  public function lrem($key,$count,$value)
  {
    return $this->redis->lrem($key,$value,$count);
  }
  /**
   * 删除并返回队列中的头元素。
   * @param unknown $key
   */
  public function lpop($key)
  {
    return $this->redis->lpop($key);
  }
  /**
   * 删除并返回队列中的尾元素
   * @param unknown $key
   */
  public function rpop($key)
  {
    return $this->redis->rpop($key);
  }
  /*************redis字符串操作命令*****************/
  /**
   * 设置一个key
   * @param unknown $key
   * @param unknown $value
   */
  public function set($key,$value)
  {
    return $this->redis->set($key,$value);
  }
  /**
   * 得到一个key
   * @param unknown $key
   */
  public function get($key)
  {
    return $this->redis->get($key);
  }
  /**
   * 设置一个有过期时间的key
   * @param unknown $key
   * @param unknown $expire
   * @param unknown $value
   */
  public function setex($key,$expire,$value)
  {
    return $this->redis->setex($key,$expire,$value);
  }
  /**
   * 设置一个key,如果key存在,不做任何操作.
   * @param unknown $key
   * @param unknown $value
   */
  public function setnx($key,$value)
  {
    return $this->redis->setnx($key,$value);
  }
  /**
   * 批量设置key
   * @param unknown $arr
   */
  public function mset($arr)
  {
    return $this->redis->mset($arr);
  }
  /*************redis　无序集合操作命令*****************/
  /**
   * 返回集合中所有元素
   * @param unknown $key
   */
  public function smembers($key)
  {
    return $this->redis->smembers($key);
  }
  /**
   * 求2个集合的差集
   * @param unknown $key1
   * @param unknown $key2
   */
  public function sdiff($key1,$key2)
  {
    return $this->redis->sdiff($key1,$key2);
  }
  /**
   * 添加集合。由于版本问题，扩展不支持批量添加。这里做了封装
   * @param unknown $key
   * @param string|array $value
   */
  public function sadd($key,$value)
  {
    if(!is_array($value))
      $arr=array($value);
    else
      $arr=$value;
    foreach($arr as $row)
      $this->redis->sadd($key,$row);
  }
  /**
   * 返回无序集合的元素个数
   * @param unknown $key
   */
  public function scard($key)
  {
    return $this->redis->scard($key);
  }
  /**
   * 从集合中删除一个元素
   * @param unknown $key
   * @param unknown $value
   */
  public function srem($key,$value)
  {
    return $this->redis->srem($key,$value);
  }
  /*************redis管理操作命令*****************/
  /**
   * 选择数据库
   * @param int $dbid 数据库id号
   * @return bool
   */
  public function select($dbid)
  {
    $this->dbid=$dbid;
    return $this->redis->select($dbid);
  }
  /**
   * 清空当前数据库
   * @return bool
   */
  public function flushdb()
  {
    return $this->redis->flushdb();
  }
  /**
   * 返回当前库状态
   * @return array
   */
  public function info()
  {
    return $this->redis->info();
  }
  /**
   * 同步保存数据到磁盘
   */
  public function save()
  {
    return $this->redis->save();
  }
  /**
   * 异步保存数据到磁盘
   */
  public function bgsave()
  {
    return $this->redis->bgsave();
  }
  /**
   * 返回最后保存到磁盘的时间
   */
  public function lastsave()
  {
    return $this->redis->lastsave();
  }
  /**
   * 返回key,支持*多个字符，?一个字符
   * 只有*　表示全部
   * @param string $key
   * @return array
   */
  public function keys($key)
  {
    return $this->redis->keys($key);
  }
  /**
   * 删除指定key
   * @param unknown $key
   */
  public function del($key)
  {
    return $this->redis->del($key);
  }
  /**
   * 判断一个key值是不是存在
   * @param unknown $key
   */
  public function exists($key)
  {
    return $this->redis->exists($key);
  }
  /**
   * 为一个key设定过期时间 单位为秒
   * @param unknown $key
   * @param unknown $expire
   */
  public function expire($key,$expire)
  {
    return $this->redis->expire($key,$expire);
  }
  /**
   * 返回一个key还有多久过期，单位秒
   * @param unknown $key
   */
  public function ttl($key)
  {
    return $this->redis->ttl($key);
  }
  /**
   * 设定一个key什么时候过期，time为一个时间戳
   * @param unknown $key
   * @param unknown $time
   */
  public function exprieat($key,$time)
  {
    return $this->redis->expireat($key,$time);
  }
  /**
   * 关闭服务器链接
   */
  public function close()
  {
    return $this->redis->close();
  }
  /**
   * 关闭所有连接
   */
  public static function closeall()
  {
    foreach(static::$_instance as $o)
    {
      if($o instanceof self)
        $o->close();
    }
  }
  /** 这里不关闭连接，因为session写入会在所有对象销毁之后。
  public function __destruct()
  {
    return $this->redis->close();
  }
  **/
  /**
   * 返回当前数据库key数量
   */
  public function dbsize()
  {
    return $this->redis->dbsize();
  }
  /**
   * 返回一个随机key
   */
  public function randomkey()
  {
    return $this->redis->randomkey();
  }
  /**
   * 得到当前数据库id
   * @return int
   */
  public function getdbid()
  {
    return $this->dbid;
  }
  /**
   * 返回当前密码
   */
  public function getauth()
  {
    return $this->auth;
  }
  public function gethost()
  {
    return $this->host;
  }
  public function getport()
  {
    return $this->port;
  }
  public function getconninfo()
  {
    return array(
      'host'=>$this->host,
      'port'=>$this->port,
      'auth'=>$this->auth
    );
  }
  /*********************事务的相关方法************************/
  /**
   * 监控key,就是一个或多个key添加一个乐观锁
   * 在此期间如果key的值如果发生的改变，刚不能为key设定值
   * 可以重新取得key的值。
   * @param unknown $key
   */
  public function watch($key)
  {
    return $this->redis->watch($key);
  }
  /**
   * 取消当前链接对所有key的watch
   * exec 命令或 discard 命令先被执行了的话，那么就不需要再执行 unwatch 了
   */
  public function unwatch()
  {
    return $this->redis->unwatch();
  }
  /**
   * 开启一个事务
   * 事务的调用有两种模式redis::multi和redis::pipeline，
   * 默认是redis::multi模式，
   * redis::pipeline管道模式速度更快，但没有任何保证原子性有可能造成数据的丢失
   */
  public function multi($type=\redis::multi)
  {
    return $this->redis->multi($type);
  }
  /**
   * 执行一个事务
   * 收到 exec 命令后进入事务执行，事务中任意命令执行失败，其余的命令依然被执行
   */
  public function exec()
  {
    return $this->redis->exec();
  }
  /**
   * 回滚一个事务
   */
  public function discard()
  {
    return $this->redis->discard();
  }
  /**
   * 测试当前链接是不是已经失效
   * 没有失效返回+pong
   * 失效返回false
   */
  public function ping()
  {
    return $this->redis->ping();
  }
  public function auth($auth)
  {
    return $this->redis->auth($auth);
  }
  /*********************自定义的方法,用于简化操作************************/
  /**
   * 得到一组的id号
   * @param unknown $prefix
   * @param unknown $ids
   */
  public function hashall($prefix,$ids)
  {
    if($ids==false)
      return false;
    if(is_string($ids))
      $ids=explode(',', $ids);
    $arr=array();
    foreach($ids as $id)
    {
      $key=$prefix.'.'.$id;
      $res=$this->hgetall($key);
      if($res!=false)
        $arr[]=$res;
    }
    return $arr;
  }
  /**
   * 生成一条消息，放在redis数据库中。使用0号库。
   * @param string|array $msg
   */
  public function pushmessage($lkey,$msg)
  {
    if(is_array($msg)){
      $msg  =  json_encode($msg);
    }
    $key  =  md5($msg);
    //如果消息已经存在，删除旧消息，已当前消息为准
    //echo $n=$this->lrem($lkey, 0, $key)."\n";
    //重新设置新消息
    $this->lpush($lkey, $key);
    $this->setex($key, 3600, $msg);
    return $key;
  }
  /**
   * 得到条批量删除key的命令
   * @param unknown $keys
   * @param unknown $dbid
   */
  public function delkeys($keys,$dbid)
  {
    $redisinfo=$this->getconninfo();
    $cmdarr=array(
      'redis-cli',
      '-a',
      $redisinfo['auth'],
      '-h',
      $redisinfo['host'],
      '-p',
      $redisinfo['port'],
      '-n',
      $dbid,
    );
    $redisstr=implode(' ', $cmdarr);
    $cmd="{$redisstr} keys \"{$keys}\" | xargs {$redisstr} del";
    return $cmd;
  }
}