PHP-redis中文文档

PHP-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不存在,returnfalse

set

写入key 和 value(string值)

如果写入成功,returnture

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时,若遇到名称为keyi的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进制信息

zsetsorted 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

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 206,839评论 6 482
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 88,543评论 2 382
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 153,116评论 0 344
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 55,371评论 1 279
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 64,384评论 5 374
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 49,111评论 1 285
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,416评论 3 400
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 37,053评论 0 259
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 43,558评论 1 300
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,007评论 2 325
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,117评论 1 334
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,756评论 4 324
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,324评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,315评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,539评论 1 262
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 45,578评论 2 355
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,877评论 2 345

推荐阅读更多精彩内容