php的redis接口（phpredis ）常用命令备忘录，供不熟悉的小伙伴边查边用

PHP-redis api 中文说明 

       

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

         下载地址如下： 
                    https://github.com/owlient/phpredis

 

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

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'); // sets key → value, with 1h TTL. 
 
setnx 判断是否重复的，写入值 
$redis->setnx('key', 'value'); 
$redis->setnx('key', 'value'); 
 
delete  删除指定 key的值 
返回已经删除 key的个数（长整数） 
$redis->delete('key1', 'key2'); 
$redis->delete(array('key3', 'key4', 'key5'));  
ttl 
得到一个 key的生存时间 
 
persist 
移除生存时间到期的key 
如果 key到期  true 如果丌到期  false 
 
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(）方法被调用。  
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 
 
getMultiple 
传参 
由 key组成的数组 
返回参数 
如果 key存在返回 value，丌存在返回 false 
$redis->set('key1', 'value1'); $redis->set('key2', 'value2'); $redis->set('key3', 
'value3'); $redis->getMultiple(array('key1', 'key2', 'key3')); 
$redis->lRem('key1', 'A', 2); 
$redis->lRange('key1', 0, -1); 
 
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 的元素,如果 value已经存在，
则丌添加 
 
lPop/rPop 
$redis->lPop('key'); 
输出名称为key的list左(头)起/右（尾）起的第一个元素，删除该元素 
 
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 
 
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', 'A', 2); 
删除 count 个名称为 key 的 list 中值为 value 的元素。count 为 0，删除所有值为 value
的元素， count>0从头至尾删除count个值为value的元素， count<0从尾到头删除|count|
个值为 value的元素 
 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 
返回并删除名称为 srckey的 list的尾元素，并将该元素添加到名称为 dstkey的 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));  
 
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元素，有 ture 没有  false 
$redis->sIsMember(key, value);  
sCard, sSize 
返回名称为key的set的元素个数 
 
sPop 
随机返回并删除名称为 key的 set中一个元素 
 
sRandMember 
随机返回名称为 key的set中一个元素，丌删除 
 
sInter 
求交集 
 
sInterStore 
求交集并将交集保存到 output的集合 
$redis->sInterStore('output', 'key1', 'key2', 'key3') 
 
sUnion 
求并集 
$redis->sUnion('s0', 's1', 's2'); 
s0,s1,s2 同时求并集 
 sUnionStore 
求并集并将并集保存到 output的集合 
$redis->sUnionStore('output', 'key1', 'key2', 'key3')； 
 
sDiff 
求差集 
 
sDiffStore 
求差集并将差集保存到 output的集合 
 
sMembers, sGetMembers 
返回名称为key的set的所有元素 
 
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命令 
getSet 
返回原来 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->set('key', 'value1'); 
$redis->append('key', 'value2'); 
$redis->get('key'); 
 
getRange （方法丌存在） 
返回名称为key的string中 start至 end之间的字符 $redis->set('key', 'string value'); 
$redis->getRange('key', 0, 5); 
$redis->getRange('key', -5, -1); 
 
setRange （方法丌存在） 
改变 key的string中 start至 end之间的字符为 value 
$redis->set('key', 'Hello world'); 
$redis->setRange('key', 6, "redis"); 
$redis->get('key'); 
 
strlen 
得到 key的string的长度 
$redis->strlen('key'); 
 
getBit/setBit 
返回 2 进制信息 
 
zset（sorted set）操作相关 
zAdd(key, score, member)：向名称为 key的 zset中添加元素 member，score 用亍排
序。如果该元素已经存在，则根据 score更新该元素的顺序。 
$redis->zAdd('key', 1, 'val1'); 
$redis->zAdd('key', 0, 'val0'); $redis->zAdd('key', 5, 'val5'); 
$redis->zRange('key', 0, -1); // array(val0, val1, val5) 
 
zRange(key, start, end,withscores)：返回名称为 key的zset（元素已按 score 从小到
大排序）中的 index从start到end的所有元素 
$redis->zAdd('key1', 0, 'val0'); 
$redis->zAdd('key1', 2, 'val2'); 
$redis->zAdd('key1', 10, 'val10'); 
$redis->zRange('key1', 0, -1); // with scores $redis->zRange('key1', 0, -1, true); 
 
zDelete, zRem 
zRem(key, member) ：删除名称为key的zset中的元素 member 
$redis->zAdd('key', 0, 'val0'); 
$redis->zAdd('key', 2, 'val2'); 
$redis->zAdd('key', 10, 'val10'); 
$redis->zDelete('key', 'val2'); 
$redis->zRange('key', 0, -1);  
 
zRevRange(key, start, end,withscores)：返回名称为 key的zset（元素已按 score 从
大到小排序）中的 index 从 start 到 end 的所有元素.withscores: 是否输出 socre 的值，
默认 false，丌输出 
$redis->zAdd('key', 0, 'val0'); $redis->zAdd('key', 2, 'val2'); 
$redis->zAdd('key', 10, 'val10'); 
$redis->zRevRange('key', 0, -1); // with scores $redis->zRevRange('key', 0, -1, true); 
 
zRangeByScore, zRevRangeByScore 
$redis->zRangeByScore(key, star, end, array(withscores，  limit )); 
返回名称为key的zset中score >= star 且 score <= end的所有元素 
 
zCount 
$redis->zCount(key, star, end); 
返回名称为key的zset中score >= star 且 score <= end的所有元素的个数 
 
zRemRangeByScore, zDeleteRangeByScore 
$redis->zRemRangeByScore('key', star, end); 
删除名称为key的zset中score >= star 且 score <= end的所有元素，返回删除个数 
 
zSize, zCard 
返回名称为key的zset的所有元素的个数 
 
zScore 
$redis->zScore(key, val2); 
返回名称为key的zset中元素 val2 的 score  
zRank, zRevRank 
$redis->zRevRank(key, val); 
返回名称为 key 的zset（元素已按 score 从小到大排序）中 val 元素的 rank（即 index，
从 0 开始），若没有 val 元素，返回“null”。zRevRank 是从大到小排序 
 
zIncrBy 
$redis->zIncrBy('key', increment, 'member'); 
如果在名称为 key 的zset 中已经存在元素 member，则该元素的 score 增加 increment；
否则向集合中添加该元素，其 score 的值为 increment 
 
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', 'key1', 'hello'); 
向名称为 h的hash中添加元素key1—>hello 
 
hGet 
$redis->hGet('h', 'key1'); 
返回名称为 h的 hash中key1 对应的 value（hello） 
 
hLen 
$redis->hLen('h'); 
返回名称为 h的 hash中元素个数 
 
hDel 
$redis->hDel('h', 'key1'); 
删除名称为 h的 hash中键为key1 的域 
 
hKeys 
$redis->hKeys('h'); 
返回名称为key的hash中所有键  
hVals 
$redis->hVals('h') 
返回名称为 h的 hash中所有键对应的 value 
 
hGetAll 
$redis->hGetAll('h'); 
返回名称为 h的 hash中所有的键（field）及其对应的 value 
 
hExists 
$redis->hExists('h', 'a'); 
名称为 h的hash中是否存在键名字为 a的域 
 
hIncrBy 
$redis->hIncrBy('h', 'x', 2); 
将名称为 h的hash中x的value增加2 
 
hMset 
$redis->hMset('user:1', array('name' => 'Joe', 'salary' => 2000)); 
向名称为 key的 hash中批量添加元素 
 
hMGet $redis->hmGet('h', array('field1', 'field2')); 
返回名称为 h的 hash中field1,field2 对应的value 
 
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