redis(6) phpredis 的使用。

phpredis是php的一个扩展，效率是相当高有链表排序功能，对创建内存级的模块业务关系

很有用;以下是redis官方提供的命令使用技巧:

下载地址如下：

https://github.com/owlient/phpredis（支持redis 2.0.4）

Redis::__construct构造函数
$redis = new Redis();

connect, open 链接redis服务
参数
host: string，服务地址
port: int,端口号
timeout: float,链接时长 (可选, 默认为 0 ，不限链接时间)
注: 在redis.conf中也有时间，默认为300
$redis->connect('127.0.0.1',  '6379',  30);

pconnect, popen 不会主动关闭的链接

$redis->connect('127.0.0.1',  '6379',  30);

setOption 设置redis模式

设置客户端的选项

$redis->setOption(Redis::OPT_SERIALIZER, Redis::SERIALIZER_NONE);   // don't serialize data$redis->setOption(Redis::OPT_SERIALIZER, Redis::SERIALIZER_PHP);    // use built-in serialize/unserialize$redis->setOption(Redis::OPT_SERIALIZER, Redis::SERIALIZER_IGBINARY);   // use igBinary serialize/unserialize$redis->setOption(Redis::OPT_PREFIX, 'myAppName:'); // use custom prefix on all keys

getOption 查看redis设置的模式

$redis->getOption(Redis::OPT_SERIALIZER);   // return Redis::SERIALIZER_NONE, Redis::SERIALIZER_PHP, or Redis::SERIALIZER_IGBINARY.

ping 查看连接状态

get 得到某个$key的值（string值）
如果该$key不存在，return false

$redis->get($key);

set 写入$key 和 $value（string值）
如果写入成功，return ture

$redis->set($key, $value);

setex 带生存时间的写入值,存在则覆盖
$redis->setex('key', 3600, 'value'); // sets key → value, with 1h TTL.

setnx 判断是key是否存在，存在则不写。
$redis->setnx('key', 'value'); /* TRUE*/
$redis->setnx('key', 'value'); /* FALSE*/

delete  删除指定key的值
返回已经删除key的个数（长整数）
$redis->delete('key1', 'key2');
$redis->delete(array('key3', 'key4', 'key5'));

ttl
得到一个key的生存时间

$time = $redis->ttl($key);

persist
移除生存时间到期的key
如果key到期 true 如果不到期 false

$redis->persist('key');

mset （redis版本1.1以上才可以用）

同时给多个key赋值
$redis->mset(array('key0' => 'value0', 'key1' => 'value1'));

multi, exec, discard
进入或者退出事务模式
参数可选Redis::MULTI或Redis::PIPELINE. 默认是 Redis::MULTI
Redis::MULTI：将多个操作当成一个事务执行
Redis::PIPELINE:让（多条）执行命令简单的，更加快速的发送给服务器，但是没有任何原子性的保证
discard:删除一个事务
返回值
multi()，返回一个redis对象，并进入multi-mode模式，一旦进入multi-mode模式，以后调用的所有方法都会返回相同的对象，只到exec(）方法被调用。

$ret = $redis->multi()    ->set('key1', 'val1')    ->get('key1')    ->set('key2', 'val2')    ->get('key2')    ->exec();/*$ret == array(    0 => TRUE,    1 => 'val1',    2 => TRUE,    3 => 'val2');*/
watch, unwatch （代码测试后，不能达到所说的效果）

监测一个key的值是否被其它的程序更改。如果这个key在watch 和 exec （方法）间被修改，这个 MULTI/EXEC 事务的执行将失败（return false）
unwatch  取消被这个程序监测的所有key
参数，一对key的列表
$redis->watch('x');

$ret = $redis->multi() ->incr('x') ->exec();

/*$ret = FALSE if x has been modified between the call to WATCH and the call to EXEC.*/

subscribe
方法回调。注意，该方法可能在未来里发生改变

Parameterschannels: an array of channels to subscribe tocallback: either a string or an array($instance, 'method_name'). The callback function receives 3 parameters: the redis instance, the channel name, and the message.Examplefunction f($redis, $chan, $msg) {    switch($chan) {        case 'chan-1':            ...            break;        case 'chan-2':            ...            break;        case 'chan-2':            ...            break;    }}$redis->subscribe(array('chan-1', 'chan-2', 'chan-3'), 'f'); // subscribe to 3 chans

publish

发表内容到某一个通道。注意，该方法可能在未来里发生改变

Parameterschannel: a channel to publish tomesssage: string

Example$redis->publish('chan-1', 'hello, world!'); // send message.

这个时候f() 方法就就能监听到了。

subscribe和publish一起用, php脚本不能停。

$redis->subscribe(array('channel-1'), function ($redis, $chan, $msg) {    // do something    echo $msg;});$redis->publish('channel-1', 'hello, world!');

exists

判断key是否存在。存在 true 不在 false

$redis->set('key', 'value');$redis->exists('key'); /*  TRUE */$redis->exists('NonExistingKey'); /* FALSE */

incr, incrBy
key中的值进行自增1，如果填写了第二个参数，者自增第二个参数所填的值，返回增长后的值。
$redis->incr('key1'); // 如果$key1 不存在，则默认为0，然后自增长了1.return 1.
$redis->incrBy('key1', 10); // 11 

decr, decrBy
做减法，使用方法同incr

$redis->decr('key1'); /* key1 didn't exists, set to 0 before the increment */                      /* and now has the value -1  */$redis->decr('key1'); /* -2 */$redis->decr('key1'); /* -3 */$redis->decrBy('key1', 10); /* -13 */

getMultiple, mGet

传参
由key组成的数组
返回参数
如果key存在返回value，不存在返回false
$redis->set('key1', 'value1'); 

$redis->set('key2', 'value2'); 

$redis->set('key3', 'value3'); 

$redis->Mget(array('key1', 'key2', 'key3'));  /* return array('value1','value2','value3') */

$redis->Mget(array('key1','$key4','key4')); /* return array('value1',FALSE,FALSE) */

1. list相关操作 

lPush
$redis->lPush(key, value);

从key左(头)开始添加一个值为value的元素，永远是往左(上)边添加。类似：洗好的盘子的叠加方式。

$redis->delete($key1);$redis->lpush($key1, 1);$redis->lpush($key1, 2);$redis->lpush($key1, 3);$redis->lpush($key1, 4); /* $key1 =  array(4,3,2,1);*/var_dump($redis->lrange($key1, 0 , -1));/*output :array (size=4)  0 => string '4' (length=1)  1 => string '3' (length=1)  2 => string '2' (length=1)  3 => string '1' (length=1)  */

rPush
$redis->rPush(key, value);

从key右(下)边添加一个值为value的元素，永远是往右(下)边添加。类似于排队。

$redis->delete($key2);$redis->rpush($key2, 1);$redis->rpush($key2, 2);$redis->rpush($key2, 3);$redis->rpush($key2, 4);var_dump($redis->lrange($key2, 0 , -1));/*output:array (size=4)  0 => string '1' (length=1)  1 => string '2' (length=1)  2 => string '3' (length=1)  3 => string '4' (length=1) */

lPushx/rPushx

$redis->lPushx(key, value);
在名称为key的list左(头)起/右(尾)添加一个值为value的元素,如果value已经存在，则不添加

lPop/rPop
$redis->lPop('key');
弹出（返回）名称为key的list左(头)起/右（尾）起的第一个元素，并删除该元素。

所以一般我们执行脚本或者其他的操作，想达到先进先出的效果，就这样用：

先一个一个的rpush,再循环lpop。就达到先进先去的效果。

先一个一个的rpush,再循环rpop。也可达到先进先去的效果。

反正就是必须反着来。顺便来，都是先进后出。

blPop/brPop
$redis->blPop('key1', 'key2', 10);
lpop命令的block版本。即当timeout为0时，若遇到名称为key i的list不存在或该list为空，则命令结束。如果timeout>0，则遇到上述情况时，等待timeout秒，如果问题没有解决，则对keyi+1开始的list执行pop操作

llen, lSize
$redis->lSize('key');
返回名称为key的list有多少个元素（原生redis中是llen,没有lsize, phpredis通用都可以）

lIndex, lGet
$redis->lGet('key', 0);
返回名称为key的list中index位置的元素 （原生redis中是lindex,没有lget ,phpredis都可以）

lSet
$redis->lSet('key', 0, 'X');
给名称为key的list中index位置的元素赋值为value

lRange, lGetRange
$redis->lRange('key1', 0, -1); 
返回名称为key的list中start至end之间的元素（end为 -1 ，返回所有）（原生redis中是lrange） 

lTrim, listTrim
$redis->lTrim('key', start, end);
截取名称为key的list，保留start至end之间的元素，0到1，就有2个。

$redis->rPush('key1', 'A');$redis->rPush('key1', 'B');$redis->rPush('key1', 'C');$redis->lRange('key1', 0, -1); /* array('A', 'B', 'C') */$redis->lTrim('key1', 0, 1); /* TRUE/FALSE */$redis->lRange('key1', 0, -1); /* array('A', 'B') */

lRem, lRemove
$redis->lRem('key', 'A', 2);
删除count个名称为key的list中值为A的元素。count为0，删除所有值为value的元素，count>0从头至尾删除count个值为A的元素(count从1开始)，count<0从尾到头删除|count|个值为A的元素。有几个删几个。(原生redis中是lrem）

$redis->lPush('key1', 'A');$redis->lPush('key1', 'B');$redis->lPush('key1', 'C'); $redis->lPush('key1', 'A'); $redis->lPush('key1', 'A'); $redis->lRange('key1', 0, -1); /* array('A', 'A', 'C', 'B', 'A') */$redis->lRem('key1', 'A', 2); /* 2 */$redis->lRange('key1', 0, -1); /* array('C', 'B', 'A') */

lInsert
在名称为为key的list中，找到值为pivot 的value，并根据参数Redis::BEFORE | Redis::AFTER，来确定，newvalue 是放在 pivot 的前面，或者后面。如果key不存在，不会插入，如果 pivot不存在，return -1
$redis->delete('key1'); 

$redis->lInsert('key1', Redis::AFTER, 'A', 'X'); 

$redis->lPush('key1', 'A'); 

$redis->lPush('key1', 'B'); $redis->lPush('key1', 'C'); $redis->lInsert('key1', Redis::BEFORE, 'C', 'X');
$redis->lRange('key1', 0, -1);
$redis->lInsert('key1', Redis::AFTER, 'C', 'Y');
$redis->lRange('key1', 0, -1);
$redis->lInsert('key1', Redis::AFTER, 'W', 'value');

rpoplpush

返回并删除名称为x的list的尾元素，并将该元素添加到名称为y的list的头部

$redis->delete('x', 'y');$redis->lPush('x', 'abc');$redis->lPush('x', 'def');$redis->lPush('y', '123');$redis->lPush('y', '456');// move the last of x to the front of y.var_dump($redis->rpoplpush('x', 'y'));var_dump($redis->lRange('x', 0, -1));var_dump($redis->lRange('y', 0, -1));Output:string(3) "abc"array(1) {  [0]=>  string(3) "def"}array(3) {  [0]=>  string(3) "abc"  [1]=>  string(3) "456"  [2]=>  string(3) "123"}

2. SET操作相关

在Redis中，我们可以将Set类型看作为没有排序的字符集合，和List类型一样，我们也可以在该类型的数据值上执行添加、删除或判断某一元素是否存在等操作。需要说明的是，这些操作的时间复杂度为O(1)，即常量时间内完成次操作。Set可包含的最大元素数量是4294967295。和List类型不同的是，Set集合中不允许出现重复的元素，这一点和C++标准库中的set容器是完全相同的。换句话说，如果多次添加相同元素，Set中将仅保留该元素的一份拷贝。和List类型相比，Set类型在功能上还存在着一个非常重要的特性，即在服务器端完成多个Sets之间的聚合计算操作，如unions、intersections和differences。由于这些操作均在服务端完成，因此效率极高，而且也节省了大量的网络IO开销。

sAdd

向名称为key的set中添加元素value,如果value存在，不写入，return false
$redis->sAdd(key , value); /* true*/

sRem, sRemove
删除名称为key的set中的元素value，如果删除成功true，失败或者没有这个value返回FALSE (原生redis只有srem)

$redis->sAdd('key1' , 'set1');$redis->sAdd('key1' , 'set2');$redis->sAdd('key1' , 'set3'); /* key1 => array('set1','set2','set3'); */$redis->sRem('key1', 'set2'); /* true */ /* key1 => array('set1','set3'); */

sMove
将value元素从名称为srckey的集合移到名称为dstkey的集合
$redis->sMove(seckey, dstkey, value);

<h5 style="margin: 0px; padding: 0px; font-family: Verdana, Geneva, Arial, Helvetica, sans-serif;"><em>Return value</em></h5>

BOOL If the operation is successful, return TRUE. If the srcKey and/or dstKey didn't exist, and/or the member didn't exist in srcKey,FALSE is returned.Example$redis->sAdd('key1' , 'set11'); $redis->sAdd('key1' , 'set12'); $redis->sAdd('key1' , 'set13'); /* 'key1' => {'set11', 'set12', 'set13'}*/$redis->sAdd('key2' , 'set21'); $redis->sAdd('key2' , 'set22'); /* 'key2' => {'set21', 'set22'}*/$redis->sMove('key1', 'key2', 'set13'); /* 'key1' =>  {'set11', 'set12'} */                    /* 'key2' =>  {'set21', 'set22', 'set13'} */

sIsMember, sContains
名称为key的集合中查找是否有value元素，有ture 没有 false
$redis->sIsMember(key, value);

sCard, sSize
返回名称为key的set的元素个数

$redis->sAdd('key1' , 'set1'); $redis->sAdd('key1' , 'set2'); $redis->sAdd('key1' , 'set3'); /* 'key1' => {'set1', 'set2', 'set3'}*/$redis->sCard('key1'); /* 3 */$redis->sCard('keyX'); /* 0 */

sPop
随机返回并删除名称为key的set中一个元素

$redis->sAdd('key1' , 'set1'); $redis->sAdd('key1' , 'set2'); $redis->sAdd('key1' , 'set3'); /* 'key1' => {'set3', 'set1', 'set2'}*/$redis->sPop('key1'); /* 'set1', 'key1' => {'set3', 'set2'} */$redis->sPop('key1'); /* 'set3', 'key1' => {'set2'} */