Redis学习手册

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

pconnect, popen 不会主动关闭的链接
参考上面

setOption 设置redis模式

getOption 查看redis设置的模式

ping 查看连接状态

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

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

setex 带生存时间的写入值
　$redis->setex('key', 3600, 'value');　　　　　　　　　　　　　　　　　　// 已过期则返回false

setnx 判断是否重复的，写入值，如果有重复则只返回一个

$redis->setnx('key', 'value');
$redis->setnx('key', 'value');　　　　　　　　　　　　　　　　　　　　　//结果 string(5) "value"

delete  删除指定key的值
返回已经删除key的个数（长整数）

$redis->delete('key1', 'key2');　　　　　　　　　　　　　　　　　　　　//$redis->get('key1')返回false
$redis->delete(array('key3', 'key4', 'key5'));　　　　　　　　　　　//$redis->get('key3')返回false

ttl　　得到一个key的生存时间

$redis->setex('key', 3600, 'value');

$redis -> ttl('key');　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　//返回int(3600)

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

$redis->setex('key', 1, 'value');

$redis -> persist('key');　　　　　　　　　　　　　　　　　　　　　　　　　　　　//返回true

mset （redis版本1.1以上才可以用）
同时给多个key赋值
$redis->mset(array('key0' => 'value0', 'key1' => 'value1'));

$redis->mset(array('key6' => 'value6', 'key7' => 'value7'));

$redis -> getMultiple(array('key6','key7'));　　　　　//array(2){ [0]=> string(6)"value6" [1]=> string(6)"value7" }

multi, exec, discard
进入或者退出事务模式
参数可选Redis::MULTI或Redis::PIPELINE. 默认是 Redis::MULTI
Redis::MULTI：将多个操作当成一个事务执行
Redis::PIPELINE:让（多条）执行命令简单的，更加快速的发送给服务器，但是没有任何原子性的保证
discard:删除一个事务
返回值
multi()，返回一个redis对象，并进入multi-mode模式，一旦进入multi-mode模式，以后调用的所有方法都会返回相同的对象，只到exec(）方法被调用。
watch, unwatch （代码测试后，不能达到所说的效果）
监测一个key的值是否被其它的程序更改。如果这个key在watch 和 exec （方法）间被修改，这个 MULTI/EXEC 事务的执行将失败（return false）
unwatch  取消被这个程序监测的所有key
参数，一对key的列表
$redis->watch('x');
$ret = $redis->multi() ->incr('x') ->exec();

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

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

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

incr, incrBy　　key中的值进行自增1，如果填写了第二个参数，者自增第二个参数所填的值,仅限于整形
$redis->incr('key1');
$redis->incrBy('key1', 10);

decr, decrBy　　做减法，使用方法同incr,仅限于整形
$redis->decr('key1');
$redis->decrBy('key1', 10);

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

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

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

$redis->getMultiple(array('key1', 'key2', 'key3'));　　　　　　　　　　

list相关操作
lPush
$redis->lPush(key, value);
在名称为key的list左边（头）添加一个值为value的 元素

rPush
$redis->rPush(key, value);
在名称为key的list右边（尾）添加一个值为value的 元素

lPushx/rPushx
$redis->lPushx(key, value);
在名称为key的list左边(头)/右边（尾）添加一个值为value的元素
lPop/rPop
$redis->lPop('key');
输出名称为key的list左(头)起/右（尾）起的第一个元素，删除该元素
*1Push/rPush和1Pushx/rPushx的区别是，1Push/rPush如果容器不存在回自动创建一个，而1Pushx/rPushx则不会，如果不存在就返回false
blPop/brPop
$redis->blPop('key1', 'key2', 10);
lpop命令的block版本。即当timeout为0时，若遇到名称为key i的list不存在或该list为空，则命令结束。如果timeout>0，则遇到上述情况时，等待timeout秒，如果问题没有解决，则对keyi+1开始的list执行pop操作

lSize
$redis->lSize('key');
返回名称为key的list有多少个元素

lIndex, lGet
$redis->lGet('key', 0);
返回名称为key的list中index位置的元素

lSet
$redis->lSet('key', 0, 'X');
给名称为key的list中index位置的元素赋值为value,如果list里面已经存在该位置的值，则会被替换

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

lTrim, listTrim
$redis->lTrim('key', start, end);
截取名称为key的list，保留start至end之间的元素

lRem, lRemove

$redis->lRem(key, value, count);
$redis->lRem('key', 'A', 2);
删除count个名称为key的list中值为value的元素。count为0，删除所有值为value的元素，count>0从头至尾删除count个值为value的元素，count<0从尾到头删除|count|个值为value的元素

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

$redis->lInsert('key1', ‘after’, 'A', 'X'); $redis->lPush('key1', 'A'); $redis->lPush('key1', 'B'); $redis->lPush('key1', 'C'); $redis->lInsert('key1', ‘after’, 'C', 'X');
$redis->lRange('key1', 0, -1);
$redis->lInsert('key1', ‘after’, 'C', 'Y');
$redis->lRange('key1', 0, -1);
$redis->lInsert('key1', ‘after’, 'W', 'value');

rpoplpush
返回并删除名称为srckey的list的尾元素，并将该元素添加到名称为dstkey的list的头部
$redis->delete('x', 'y');
$redis->lPush('x', 'abc'); $redis->lPush('x', 'def'); $redis->lPush('y', '123'); $redis->lPush('y', '456'); var_dump($redis->rpoplpush('x', 'y'));//将列表x里面最后一个元素删除并加入到列表y下标为0的位置
var_dump($redis->lRange('x', 0, -1));
var_dump($redis->lRange('y', 0, -1));

string(3) "abc"
array(1) { [0]=> string(3) "def" }
array(3) { [0]=> string(3) "abc" [1]=> string(3) "456" [2]=> string(3) "123" }

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

sRem, sRemove
删除名称为key的set中的元素value
$redis->sAdd('key1' , 'set1');
$redis->sAdd('key1' , 'set2');
$redis->sAdd('key1' , 'set3');
$redis->sRem('key1', 'set2');

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

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

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

$redis -> sCard('key');

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

$redis -> sPop('key');

sRandMember　　随机返回名称为key的set中一个元素，不删除　　

$redis -> sRandMember('key');

sInter　　求交集

$redis -> sadd('k1',1);
$redis -> sadd('k1',2);
$redis -> sadd('k1',3);
$redis -> sadd('k1',4);
$redis -> sadd('k2',2);
$redis -> sadd('k2',3);
$redis -> sadd('k2',4);
$redis -> sadd('k2',5);
$rec = $redis -> sInter('k1','k2');
var_dump($rec); // 2,3,4

sInterStore　　求交集并将交集保存到output的集合　　
$redis->sInterStore('output', 'key1', 'key2', 'key3')

$redis -> delete('k1');
$redis -> delete('k2');
$redis -> delete('k3');
$redis -> sadd('k1',1);
$redis -> sadd('k1',2);
$redis -> sadd('k1',3);
$redis -> sadd('k1',4);
$redis -> sadd('k2',2);
$redis -> sadd('k2',3);
$redis -> sadd('k2',4);
$redis -> sadd('k2',5);
$redis -> sAdd('k3',3);
$redis -> sAdd('k3',4);
$redis->sInterStore('output', 'k1', 'k2', 'k3');
var_dump($redis->sMembers('output'));  //3,4

sUnion　　求并集
$redis->sUnion('s0', 's1', 's2');
s0,s1,s2 同时求并集

$redis -> delete('k1');
$redis -> delete('k2');
$redis -> delete('k3');
$redis -> sadd('k1',1);
$redis -> sadd('k1',2);
$redis -> sadd('k1',3);
$redis -> sadd('k1',4);
$redis -> sadd('k2',2);
$redis -> sadd('k2',3);
$redis -> sadd('k2',4);
$redis -> sadd('k2',5);
$redis -> sAdd('k3',3);
$redis -> sAdd('k3',4);
$redis->sUnion('k1', 'k2', 'k3');
var_dump( $redis->sUnion('k1', 'k2', 'k3'));  //1,2,3,4,5

sUnionStore　　求并集并将并集保存到output的集合
$redis->sUnionStore('output', 'key1', 'key2', 'key3')；

$redis -> delete('k1');
$redis -> delete('k2');
$redis -> delete('k3');
$redis -> sadd('k1',1);
$redis -> sadd('k1',2);
$redis -> sadd('k1',3);
$redis -> sadd('k1',4);
$redis -> sadd('k2',2);
$redis -> sadd('k2',3);
$redis -> sadd('k2',4);
$redis -> sadd('k2',5);
$redis -> sAdd('k3',6);
$redis -> sAdd('k3',7);
$redis->sUnionStore('output', 'k1', 'k2', 'k3');
var_dump( $redis->sMembers('output')); //1,2,3,4,5,6,7

sDiff　　求差集 //以属于A而不属于B的元素为元素的集合成为A与B的差（集）

$redis -> delete('k1');
$redis -> delete('k2');
$redis -> sadd('k1',1);
$redis -> sadd('k1',2);
$redis -> sadd('k1',3);
$redis -> sadd('k1',4);
$redis -> sadd('k2',2);
$redis -> sadd('k2',3);
$redis -> sadd('k2',4);
$redis -> sadd('k2',5);

$redis->sDiff('k1', 'k2');
var_dump( $redis->sDiff('k1', 'k2'));　　//1

sDiffStore　　求差集并将差集保存到output的集合

$redis -> delete('k1');
$redis -> delete('k2');
$redis -> sadd('k1',1);
$redis -> sadd('k1',2);
$redis -> sadd('k1',3);
$redis -> sadd('k1',4);
$redis -> sadd('k2',2);
$redis -> sadd('k2',3);
$redis -> sadd('k2',4);
$redis -> sadd('k2',5);
$redis -> sDiffStore('output','k1','k2');
var_dump($redis -> sMembers('output'));　　//1

sMembers, sGetMembers　　返回名称为key的set的所有元素

$redis -> delete('k1');
$redis -> delete('k2');
$redis -> sadd('k1',1);
$redis -> sadd('k1',2);
$redis -> sadd('k1',3);
$redis -> sadd('k1',4);
$redis -> sadd('k2',2);
$redis -> sadd('k2',3);
$redis -> sadd('k2',4);
$redis -> sadd('k2',5);
var_dump($redis -> sMembers('k1'));

sort　　排序，分页等
参数
'by' => 'some_pattern_*',
'limit' => array(0, 1),
'get' => 'some_other_pattern_*' or an array of patterns,
'sort' => 'asc' or 'desc',
'alpha' => TRUE,
'store' => 'external-key'
例子
$redis->delete('s');

$redis->sadd('s', 5);

$redis->sadd('s', 4);

$redis->sadd('s', 2);

$redis->sadd('s', 1);

$redis->sadd('s', 3);
var_dump($redis->sort('s')); // 1,2,3,4,5
var_dump($redis->sort('s', array('sort' => 'desc'))); // 5,4,3,2,1
var_dump($redis->sort('s', array('sort' => 'desc', 'store' => 'out'))); // (int)5
 
string命令
get、Set
返回原来key中的值，并将value写入key
$redis->set('x', '42');
$exValue = $redis->getSet('x', 'lol'); // return '42', replaces x by 'lol'
$newValue = $redis->get('x')' // return 'lol'

append
string，名称为key的string的值在后面加上value

$redis -> delete('x');
$redis->set('x', 'value1');
$redis->append('x', 'value2');
var_dump($redis -> get('x'));　　//value1value2

getRange
返回名称为key的string中start至end之间的字符

$redis->delete('k');
$redis->set('k', 'string value');
var_dump($redis->getRange('k', 0, 5));　　//string

var_dump($redis->getRange('k', 0,-1));　　//string value

setRange
改变key的string中start至end之间的字符为value

$redis->set('k', 'Hello world');
$redis->setRange('k', 6, "redis");
var_dump($redis->get('k')); // Hello redis

strlen
得到key的string的长度
$redis->set('k', 'Hello world');
var_dump($redis->strlen('k')); // 11

getBit/setBit

字符串值指定偏移量上的位(bit)。

当偏移量 OFFSET 比字符串值的长度大，或者 key 不存在时，返回 0 。

zset（sorted set）操作相关
zAdd(key, score, member)：向名称为key的zset中添加元素member，score用于排序。如果该元素已经存在，则根据score更新该元素的顺序。

$redis->zAdd('k', 1, 'v1');
$redis->zAdd('k', 0, 'v0');
$redis->zAdd('k', 2, 'v2');
var_dump($redis->zRange('k', 0, -1));　　//array(3) { [0]=> string(2) "v0" [1]=> string(2) "v1" [2]=> string(2) "v2" }

zRange(key, start, end,withscores)：返回名称为key的zset（元素已按score从小到大排序）中的index从start到end的所有元素

$redis->zAdd('k', 1, 'v1');
$redis->zAdd('k', 0, 'v0');
$redis->zAdd('k', 2, 'v2');
var_dump($redis->zRange('k', 0, -1));　　//array(3) { [0]=> string(2) "v0" [1]=> string(2) "v1" [2]=> string(2) "v2" }

zDelete, zRem
zRem(key, member) ：删除名称为key的zset中的元素member

$redis->zAdd('k', 1, 'v1');
$redis->zAdd('k', 0, 'v0');
$redis->zAdd('k', 2, 'v2');
$redis->zDelete('k', 'v2');
var_dump($redis->zRange('k', 0, -1));　　//array(2) { [0]=> string(2) "v0" [1]=> string(2) "v1" }

zRevRange(key, start, end,withscores)：返回名称为key的zset（元素已按score从大到小排序）中的index从start到end的所有元素.withscores: 是否输出socre的值，默认false，不输出

$redis->zAdd('k', 0, 'v0');
$redis->zAdd('k', 2, 'v2');
$redis->zAdd('k', 10, 'v10');
//$redis->zRevRange('key', 0, -1, true);
var_dump($redis->zRevRange('k', 0, -1));　　//v10,v2,v0

zRangeByScore, zRevRangeByScore
$redis->zRangeByScore(key, start, end, array(withscores， limit ));
返回名称为key的zset中score >= start且score <= end的所有元素

$redis->zAdd('k', 0, 10);
$redis->zAdd('k', 2, 11);
$redis->zAdd('k', 10, 12);
var_dump($redis->zRangeByScore('k', 0, 12,array(10,3 )));　　//10,11,12

zCount
$redis->zCount(key, start, end);
返回名称为key的zset中score >= star且score <= end的所有元素的个数

$redis->zAdd('k', 0, 10);
$redis->zAdd('k', 2, 11);
$redis->zAdd('k', 10, 12);
var_dump($redis->zCount('k', 0, 12));　　//3

zRemRangeByScore, zDeleteRangeByScore
$redis->zRemRangeByScore('key', start, end);
删除名称为key的zset中score >= start且score <= end的所有元素，返回删除个数

$redis->zAdd('k', 0, 10);
$redis->zAdd('k', 2, 11);
$redis->zAdd('k', 10, 12);
var_dump($redis->zRemRangeByScore('k', 10, 20));　　//1

zSize, zCard
返回名称为key的zset的所有元素的个数

$redis->zAdd('k', 0, 10);
$redis->zAdd('k', 2, 11);
$redis->zAdd('k', 10, 12);
$redis->zSize('k');
var_dump($redis->zCard('k'));　　//3

zScore
$redis->zScore(key, val2);
返回名称为key的zset中元素val2的score

$redis->zAdd('k', 0, 10);
$redis->zAdd('k', 2, 11);
$redis->zAdd('k', 10, 12);
var_dump($redis->zScore('k', 12));　　//10

zRank, zRevRank
$redis->zRevRank(key, val);
返回名称为key的zset（元素已按score从小到大排序）中val元素的rank（即index，从0开始），若没有val元素，返回“null”。zRevRank 是从大到小排序

$redis->zAdd('k', 0, 10);
$redis->zAdd('k', 2, 11);
$redis->zAdd('k', 10, 12);
var_dump($redis->zRevRank('k', 10));　　//2

zIncrBy
$redis->zIncrBy('key', increment, 'member');
如果在名称为key的zset中已经存在元素member，则该元素的score增加increment；否则向集合中添加该元素，其score的值为increment

$redis->zAdd('k', 0, 10);
$redis->zAdd('k', 2, 11);
$redis->zAdd('k', 10, 12);
$redis->zIncrBy('k',11, 13);
var_dump($redis->zRange('k',0,-1));　　//10,11,12,13

zUnion/zInter
参数
keyOutput
arrayZSetKeys
arrayWeights
aggregateFunction Either "SUM", "MIN", or "MAX": defines the behaviour to use on duplicate entries during the zUnion.
对N个zset求并集和交集，并将最后的集合保存在dstkeyN中。对于集合中每一个元素的score，在进行AGGREGATE运算前，都要乘以对于的WEIGHT参数。如果没有提供WEIGHT，默认为1。默认的AGGREGATE是SUM，即结果集合中元素的score是所有集合对应元素进行SUM运算的值，而MIN和MAX是指，结果集合中元素的score是所有集合对应元素中最小值和最大值。

Hash操作
hSet
$redis->hSet('h', 'k1', 'hello');
向名称为h的hash中添加元素key1—>hello

$redis->hSet('h', 'k1', 'hello');
var_dump($redis->hGet('h','k1'));　　//hello

hGet
$redis->hGet('h', 'key1');
返回名称为h的hash中key1对应的value（hello）

$redis->hSet('h', 'k1', 'hello');
var_dump($redis->hGet('h','k1'));　　//hello

hLen
$redis->hLen('h');
返回名称为h的hash中元素个数

$redis->delete('h');
$redis->hSet('h', 'k1', 'hello');
var_dump($redis->hLen('h'));　　//1

hDel
$redis->hDel('h', 'key1');
删除名称为h的hash中键为key1的域

$redis->delete('h');
$redis->hSet('h', 'k1', 'hello');
$redis->hDel('h', 'k1');
var_dump($redis->hGet('h','k1'));　　//false

hKeys
$redis->hKeys('h');
返回名称为key的hash中所有键

$redis->delete('h');
$redis->hSet('h', 'k1', 'hello');
var_dump($redis->hKeys('h'));　　//k1

hVals
$redis->hVals('h')
返回名称为h的hash中所有键对应的value

$redis->delete('h');
$redis->hSet('h', 'k1', 'hello');
var_dump($redis->hVals('h'));　　//hello

hGetAll
$redis->hGetAll('h');
返回名称为h的hash中所有的键（field）及其对应的value

$redis->hSet('h', 'k1', 'hello');
$redis->hSet('h', 'k2', 'soar');
var_dump($redis->hGetAll('h'));　　//k1 hello k2 soar

hExists
$redis->hExists('h', 'a');
名称为h的hash中是否存在键名字为a的域

$redis->hSet('h', 'k1', 'hello');
$redis->hSet('h', 'k2', 'soar');
var_dump($redis->hExists('h', 'k1'));　　//true

hIncrBy
$redis->hIncrBy('h', 'x', 2);
将名称为h的hash中x的value增加2

$redis->delete('h');
//$redis->hSet('h', 'k1', 'hello');
$redis->hSet('h', 'k1', 3);
$redis->hSet('h', 'k2', 'soar');
$redis->hIncrBy('h', 'k1', 2);
//var_dump($redis->hGet('h', 'k1'));  //hello
var_dump($redis->hGet('h', 'k1'));　　//5

hMset　　向名称为key的hash中批量添加元素

$redis->hmSet('user_1', array('name' => 'naruto', 'sex' => 'F','age'=>20));
var_dump($redis->hmGet('user_1',array('name','salary','age')));　　//'name' => 'naruto', 'sex' => 'F','age'=>20

hMGet
$redis->hmGet('h', array('field1', 'field2'));
返回名称为h的hash中field1,field2对应的value

$redis->hmSet('user_1', array('name' => 'naruto', 'sex' => 'F','age'=>20));
var_dump($redis->hmGet('user_1',array('name','salary','age')));　　//'name' => 'naruto', 'sex' => 'F','age'=>20

redis 操作相关
flushDB　　清空当前数据库

flushAll　　清空所有数据库

randomKey　　随机返回key空间的一个key
$key = $redis->randomKey();

select　　选择一个数据库
move　　转移一个key到另外一个数据库
$redis->select(0); // switch to DB 0
$redis->set('x', '42'); // write 42 to x
$redis->move('x', 1); // move to DB 1
$redis->select(1); // switch to DB 1
$redis->get('x'); // will return 42

rename, renameKey
给key重命名
$redis->set('x', '42');
$redis->rename('x', 'y');
$redis->get('y'); // → 42
$redis->get('x'); // → `FALSE`

renameNx
与remane类似，但是，如果重新命名的名字已经存在，不会替换成功

setTimeout, expire
设定一个key的活动时间（s）
$redis->setTimeout('x', 3);

expireAt
key存活到一个unix时间戳时间
$redis->expireAt('x', time() + 3);

keys, getKeys
返回满足给定pattern的所有key
$keyWithUserPrefix = $redis->keys('user*');

dbSize
查看现在数据库有多少key
$count = $redis->dbSize();

auth
密码认证
$redis->auth('foobared');

bgrewriteaof
使用aof来进行数据库持久化
$redis->bgrewriteaof();

slaveof
选择从服务器
$redis->slaveof('10.0.1.7', 6379);

save
将数据同步保存到磁盘

bgsave
将数据异步保存到磁盘

lastSave
返回上次成功将数据保存到磁盘的Unix时戳

info
返回redis的版本信息等详情



type
返回key的类型值
string: Redis::REDIS_STRING
set: Redis::REDIS_SET
list: Redis::REDIS_LIST
zset: Redis::REDIS_ZSET
hash: Redis::REDIS_HASH
other: Redis::REDIS_NOT_FOUND