PHP-redis中文说明
PhpRedis是php的一个扩展,效率是相当高有链表排序功能,对创建内存级的模块业务关系很有用;以下是redis官方提供的命令使用技巧:
Redis::__construct构造函数
1 |
$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 带生存时间的写入值
1 |
$redis->setex( 'key' , 3600, 'value' ); // sets key → value, with 1h TTL. |
setnx 判断是否重复的,写入值
1 |
$redis->setnx( 'key' , 'value' ); |
2 |
$redis->setnx( 'key' , 'value' ); |
delete 删除指定key的值
返回已经删除key的个数(长整数)
1 |
$redis->delete( 'key1' , 'key2' ); |
2 |
$redis->delete(array( 'key3' , 'key4' , 'key5' )); |
ttl
得到一个key的生存时间
persist
移除生存时间到期的key
如果key到期 true 如果不到期 false
mset (redis版本1.1以上才可以用)
同时给多个key赋值
1 |
$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的列表
1 |
$redis->watch( 'x' ); |
2 |
$ret = $redis->multi() ->incr( 'x' ) ->exec(); |
subscribe *
方法回调。注意,该方法可能在未来里发生改变
publish *
发表内容到某一个通道。注意,该方法可能在未来里发生改变
exists
判断key是否存在。存在 true 不在 false
incr, incrBy
key中的值进行自增1,如果填写了第二个参数,者自增第二个参数所填的值
1 |
$redis->incr( 'key1' ); |
2 |
$redis->incrBy( 'key1' , 10); |
decr, decrBy
做减法,使用方法同incr
getMultiple
传参
由key组成的数组
返回参数
如果key存在返回value,不存在返回false
1 |
$redis-> set ( 'key1' , 'value1' ); |
2 |
$redis-> set ( 'key2' , 'value2' ); |
3 |
$redis-> set ( 'key3' , 'value3' ); |
4 |
$redis->getMultiple(array( 'key1' , 'key2' , 'key3' )); |
5 |
$redis->lRem( 'key1' , 'A' , 2); |
6 |
$redis->lRange( 'key1' , 0, -1); |
List相关操作
lPush
1 |
$redis->lPush(key, value); |
在名称为key的list左边(头)添加一个值为value的元素
rPush
1 |
$redis->rPush(key, value); |
在名称为key的list右边(尾)添加一个值为value的元素
lPushx/rPushx
1 |
$redis->lPushx(key, value); |
在名称为key的list左边(头)/右边(尾)添加一个值为value的元素,如果value已经存在,则不添加
lPop/rPop
1 |
$redis->lPop( 'key' ); |
输出名称为key的list左(头)起/右(尾)起的第一个元素,删除该元素
blPop/brPop
1 |
$redis->blPop( 'key1' , 'key2' , 10); |
lpop命令的block版本。即当timeout为0时,若遇到名称为key i的list不存在或该list为空,则命令结束。如果timeout>0,则遇到上述情况时,等待timeout秒,如果问题没有解决,则对 keyi+1开始的list执行pop操作
lSize
1 |
$redis->lSize( 'key' ); |
返回名称为key的list有多少个元素
lIndex, lGet
1 |
$redis->lGet( 'key' , 0); |
返回名称为key的list中index位置的元素
lSet
1 |
$redis->lSet( 'key' , 0, 'X' ); |
给名称为key的list中index位置的元素赋值为value
lRange, lGetRange
1 |
$redis->lRange( 'key1' , 0, -1); |
返回名称为key的list中start至end之间的元素(end为 -1 ,返回所有)
lTrim, listTrim
1 |
$redis->lTrim( 'key' , start, end); |
截取名称为key的list,保留start至end之间的元素
lRem, lRemove
1 |
$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
01 |
$redis->delete( 'key1' ); |
02 |
$redis->lInsert( 'key1' , Redis::AFTER, 'A' , 'X' ); |
03 |
$redis->lPush( 'key1' , 'A' ); |
04 |
$redis->lPush( 'key1' , 'B' ); |
05 |
$redis->lPush( 'key1' , 'C' ); |
06 |
$redis->lInsert( 'key1' , Redis::BEFORE, 'C' , 'X' ); |
07 |
$redis->lRange( 'key1' , 0, -1); |
08 |
$redis->lInsert( 'key1' , Redis::AFTER, 'C' , 'Y' ); |
09 |
$redis->lRange( 'key1' , 0, -1); |
10 |
$redis->lInsert( 'key1' , Redis::AFTER, 'W' , 'value' ); |
rpop/lpush
01 |
$redis->delete( 'x' , 'y' ); |
02 |
$redis->lPush( 'x' , 'abc' ); |
03 |
$redis->lPush( 'x' , 'def' ); |
04 |
$redis->lPush( 'y' , '123' ); |
05 |
$redis->lPush( 'y' , '456' ); // move the last of x to the front of y. var_dump($redis->rpoplpush('x', 'y')); |
06 |
var_dump($redis->lRange( 'x' , 0, -1)); |
07 |
var_dump($redis->lRange( 'y' , 0, -1)); |
08 |
array |
09 |
0 => string 'def' (length=3) |
10 |
1 => string 'abc' (length=3) |
11 |
12 |
array |
13 |
0 => string '456' (length=3) |
14 |
1 => string '123' (length=3) |
返回并删除名称为srckey的list的尾元素,并将该元素添加到名称为dstkey的list的头部
SET相关操作
sAdd
1 |
$redis->sAdd(key , value); |
向名称为key的set中添加元素value,如果value存在,不写入,return false
sRem, sRemove
1 |
$redis->sAdd( 'key1' , 'set1' ); |
2 |
$redis->sAdd( 'key1' , 'set2' ); |
3 |
$redis->sAdd( 'key1' , 'set3' ); |
4 |
$redis->sRem( 'key1' , 'set2' ); |
删除名称为key的set中的元素value
sMove
1 |
$redis->sMove(seckey, dstkey, value); |
将value元素从名称为srckey的集合移到名称为dstkey的集合
sIsMember, sContains
1 |
$redis->sIsMember(key, value); |
名称为key的集合中查找是否有value元素,有ture 没有false
sCard, sSize
1 |
$redis->sIsMember(key, value); |
返回名称为key的set的元素个数
sPop
随机返回并删除名称为key的set中一个元素
sRandMember
随机返回名称为key的set中一个元素,不删除
sInter
求交集
sInterStore
1 |
$redis->sInterStore( 'output' , 'key1' , 'key2' , 'key3' ) |
求交集并将交集保存到output的集合
sUnion
1 |
$redis->sUnion( 's0' , 's1' , 's2' ); |
2 |
//s0,s1,s2 同时求并集 |
求并集
sUnionStore
1 |
$redis->sUnionStore( 'output' , 'key1' , 'key2' , 'key3' ); |
求并集并将并集保存到output的集合
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’
1 |
$redis->delete( 's' ); |
2 |
$redis->sadd( 's' , 5); |
3 |
$redis->sadd( 's' , 4); |
4 |
$redis->sadd( 's' , 2); |
5 |
$redis->sadd( 's' , 1); |
6 |
$redis->sadd( 's' , 3); |
7 |
var_dump($redis->sort( 's' )); // 1,2,3,4,5 |
8 |
var_dump($redis->sort( 's' , array( 'sort' => 'desc' ))); // 5,4,3,2,1 |
9 |
var_dump($redis->sort( 's' , array( 'sort' => 'desc' , 'store' => 'out' ))); // (int)5 |
string相关操作
getSet
1 |
$redis-> set ( 'x' , '42' ); |
2 |
$exValue = $redis->getSet( 'x' , 'lol' ); // return '42', replaces x by 'lol' |
3 |
$newValue = $redis-> get ( 'x' ) ' // return ' lol' |
返回原来key中的值,并将value写入key
append
1 |
$redis-> set ( 'key' , 'value1' ); |
2 |
$redis->append( 'key' , 'value2' ); |
3 |
$redis-> get ( 'key' ); |
string,名称为key的string的值在后面加上value
getRange (方法不存在)
1 |
$redis-> set ( 'key' , 'string value' ); |
2 |
$redis->getRange( 'key' , 0, 5); |
3 |
$redis->getRange( 'key' , -5, -1); |
返回名称为key的string中start至end之间的字符
setRange (方法不存在)
1 |
$redis-> set ( 'key' , 'Hello world' ); |
2 |
$redis->setRange( 'key' , 6, "redis" ); |
3 |
$redis-> get ( 'key' ); |
改变key的string中start至end之间的字符为value
strlen
1 |
$redis->strlen( 'key' ); |
得到key的string的长度
getBit/setBit
返回2进制信息
zset(sorted set)相关操作
zAdd(key, score, member)
1 |
$redis->zAdd( 'key' , 1, 'val1' ); |
2 |
$redis->zAdd( 'key' , 0, 'val0' ); |
3 |
$redis->zAdd( 'key' , 5, 'val5' ); |
4 |
$redis->zRange( 'key' , 0, -1); // array(val0, val1, val5) |
向名称为key的zset中添加元素member,score用于排序。如果该元素已经存在,则根据score更新该元素的顺序。
zRange(key, start, end,withscores)
1 |
$redis->zAdd( 'key1' , 0, 'val0' ); |
2 |
$redis->zAdd( 'key1' , 2, 'val2' ); |
3 |
$redis->zAdd( 'key1' , 10, 'val10' ); |
4 |
$redis->zRange( 'key1' , 0, -1); // with scores $redis->zRange('key1', 0, -1, true); |
返回名称为key的zset(元素已按score从小到大排序)中的index从start到end的所有元素
zDelete,zRem(key, member)
1 |
$redis->zAdd( 'key' , 0, 'val0' ); |
2 |
$redis->zAdd( 'key' , 2, 'val2' ); |
3 |
$redis->zAdd( 'key' , 10, 'val10' ); |
4 |
$redis->zDelete( 'key' , 'val2' ); |
5 |
$redis->zRange( 'key' , 0, -1); |
删除名称为key的zset中的元素member
zRevRange(key, start, end,withscores)
1 |
$redis->zAdd( 'key' , 0, 'val0' ); |
2 |
$redis->zAdd( 'key' , 2, 'val2' ); |
3 |
$redis->zAdd( 'key' , 10, 'val10' ); |
4 |
$redis->zRevRange( 'key' , 0, -1); // with scores $redis->zRevRange('key', 0, -1, true); |
返回名称为key的zset(元素已按score从大到小排序)中的index从start到end的所有元素.withscores: 是否输出socre的值,默认false,不输出
zRangeByScore, zRevRangeByScore
1 |
$redis->zRangeByScore(key, star, end, array(withscores, limit )); |
返回名称为key的zset中score >= star且score <= end的所有元素
zCount
1 |
$redis->zCount(key, star, end); |
返回名称为key的zset中score >= star且score <= end的所有元素的个数
zRemRangeByScore, zDeleteRangeByScore
1 |
$redis->zRemRangeByScore( 'key' , star, end); |
删除名称为key的zset中score >= star且score <= end的所有元素,返回删除个数
zSize, zCard
返回名称为key的zset的所有元素的个数
zScore
1 |
$redis->zScore(key, val2); |
返回名称为key的zset中元素val2的score
zRank, zRevRank
1 |
$redis->zRevRank(key, val); |
返回名称为key的zset(元素已按score从小到大排序)中val元素的rank(即index,从0开始),若没有val元素,返回“null”。zRevRank 是从大到小排序
zIncrBy
1 |
$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
1 |
$redis->hSet( 'h' , 'key1' , 'hello' ); |
向名称为h的hash中添加元素key1—>hello
hGet
1 |
$redis->hGet( 'h' , 'key1' ); |
返回名称为h的hash中key1对应的value(hello)
hLen
1 |
$redis->hLen( 'h' ); |
返回名称为h的hash中元素个数
hDel
1 |
$redis->hDel( 'h' , 'key1' ); |
删除名称为h的hash中键为key1的域
hKeys
1 |
$redis->hKeys( 'h' ); |
返回名称为key的hash中所有键
hVals
1 |
$redis->hVals( 'h' ) |
返回名称为h的hash中所有键对应的value
hGetAll
1 |
$redis->hGetAll( 'h' ); |
返回名称为h的hash中所有的键(field)及其对应的value
hExists
1 |
$redis->hExists( 'h' , 'a' ); |
名称为h的hash中是否存在键名字为a的域
hIncrBy
1 |
$redis->hIncrBy( 'h' , 'x' , 2); |
将名称为h的hash中x的value增加2
hMset
1 |
$redis->hMset( 'user:1' , array( 'name' => 'Joe' , 'salary' => 2000)); |
向名称为key的hash中批量添加元素
hMGet
1 |
$redis->hmGet( 'h' , array( 'field1' , 'field2' )); |
返回名称为h的hash中field1,field2对应的value
redis 相关操作
flushDB
清空当前数据库
flushAll
清空所有数据库
randomKey
1 |
$key = $redis->randomKey(); |
随机返回key空间的一个key
select
选择一个数据库
move
1 |
$redis->select(0); // switch to DB 0 |
2 |
$redis-> set ( 'x' , '42' ); // write 42 to x |
3 |
$redis->move( 'x' , 1); // move to DB 1 |
4 |
$redis->select(1); // switch to DB 1 |
5 |
$redis-> get ( 'x' ); // will return 42 |
转移一个key到另外一个数据库
rename, renameKey
1 |
$redis-> set ( 'x' , '42' ); |
2 |
$redis->rename( 'x' , 'y' ); |
3 |
$redis-> get ( 'y' ); // → 42 |
4 |
$redis-> get ( 'x' ); // → `FALSE` |
给key重命名
renameNx
与remane类似,但是,如果重新命名的名字已经存在,不会替换成功
setTimeout, expire
1 |
$redis->setTimeout( 'x' , 3); |
设定一个key的活动时间(s)
expireAt
1 |
$redis->expireAt( 'x' , time() + 3); |
key存活到一个unix时间戳时间
keys, getKeys
1 |
$keyWithUserPrefix = $redis->keys( 'user*' ); |
返回满足给定pattern的所有key
dbSize
1 |
$count = $redis->dbSize(); |
查看现在数据库有多少key
auth
1 |
$redis->auth( 'foobared' ); |
密码认证
bgrewriteaof
1 |
$redis->bgrewriteaof(); |
使用aof来进行数据库持久化
slaveof
1 |
$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