phpredis是php的一個(gè)擴(kuò)展
Redis::__construct構(gòu)造函數(shù)
$redis = new Redis();
connect, open 鏈接redis服務(wù)
參數(shù)
host: string,服務(wù)地址
port: int,端口號(hào)
timeout: float,鏈接時(shí)長(zhǎng) (可選, 默認(rèn)為 0 衷蜓,不限鏈接時(shí)間)
注: 在redis.conf中也有時(shí)間窍株,默認(rèn)為300
pconnect, popen 不會(huì)主動(dòng)關(guān)閉的鏈接
參考上面
setOption 設(shè)置redis模式
getOption 查看redis設(shè)置的模式
ping 查看連接狀態(tài)
get 得到某個(gè)key的值(string值)
如果該key不存在,return false
set 寫(xiě)入key 和 value(string值)
如果寫(xiě)入成功,return ture
setex 帶生存時(shí)間的寫(xiě)入值
$redis->setex('key', 3600, 'value'); // sets key → value, with 1h TTL.
setnx 判斷是否重復(fù)的,寫(xiě)入值
$redis->setnx('key', 'value');
$redis->setnx('key', 'value');
delete 刪除指定key的值
返回已經(jīng)刪除key的個(gè)數(shù)(長(zhǎng)整數(shù))
$redis->delete('key1', 'key2');
$redis->delete(array('key3', 'key4', 'key5'));
ttl
得到一個(gè)key的生存時(shí)間
persist
移除生存時(shí)間到期的key
如果key到期 true 如果不到期 false
mset (redis版本1.1以上才可以用)
同時(shí)給多個(gè)key賦值
$redis->mset(array('key0' => 'value0', 'key1' => 'value1'));
multi, exec, discard
進(jìn)入或者退出事務(wù)模式
參數(shù)可選Redis::MULTI或Redis::PIPELINE. 默認(rèn)是 Redis::MULTI
Redis::MULTI:將多個(gè)操作當(dāng)成一個(gè)事務(wù)執(zhí)行
Redis::PIPELINE:讓?zhuān)ǘ鄺l)執(zhí)行命令簡(jiǎn)單的,更加快速的發(fā)送給服務(wù)器坑资,但是沒(méi)有任何原子性的保證
discard:刪除一個(gè)事務(wù)
返回值
multi(),返回一個(gè)redis對(duì)象穆端,并進(jìn)入multi-mode模式袱贮,一旦進(jìn)入multi-mode模式,以后調(diào)用的所有方法都會(huì)返回相同的對(duì)象体啰,只到exec()方法被調(diào)用攒巍。
watch, unwatch (代碼測(cè)試后,不能達(dá)到所說(shuō)的效果)
監(jiān)測(cè)一個(gè)key的值是否被其它的程序更改荒勇。如果這個(gè)key在watch 和 exec (方法)間被修改柒莉,這個(gè) MULTI/EXEC 事務(wù)的執(zhí)行將失敗(return false)
unwatch 取消被這個(gè)程序監(jiān)測(cè)的所有key
參數(shù)沽翔,一對(duì)key的列表
$redis->watch('x');
$ret = $redis->multi() ->incr('x') ->exec();
subscribe *
方法回調(diào)兢孝。注意,該方法可能在未來(lái)里發(fā)生改變
publish *
發(fā)表內(nèi)容到某一個(gè)通道仅偎。注意西潘,該方法可能在未來(lái)里發(fā)生改變
exists
判斷key是否存在。存在 true 不在 false
incr, incrBy
key中的值進(jìn)行自增1哨颂,如果填寫(xiě)了第二個(gè)參數(shù),者自增第二個(gè)參數(shù)所填的值
$redis->incr('key1');
$redis->incrBy('key1', 10);
decr, decrBy
做減法相种,使用方法同incr
getMultiple
傳參
由key組成的數(shù)組
返回參數(shù)
如果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相關(guān)操作
lPush
$redis->lPush(key, value);
在名稱(chēng)為key的list左邊(頭)添加一個(gè)值為value的 元素
rPush
$redis->rPush(key, value);
在名稱(chēng)為key的list右邊(尾)添加一個(gè)值為value的 元素
lPushx/rPushx
$redis->lPushx(key, value);
在名稱(chēng)為key的list左邊(頭)/右邊(尾)添加一個(gè)值為value的元素,如果value已經(jīng)存在品姓,則不添加
lPop/rPop
$redis->lPop('key');
輸出名稱(chēng)為key的list左(頭)起/右(尾)起的第一個(gè)元素,刪除該元素
blPop/brPop
$redis->blPop('key1', 'key2', 10);
lpop命令的block版本箫措。即當(dāng)timeout為0時(shí)腹备,若遇到名稱(chēng)為key i的list不存在或該list為空,則命令結(jié)束斤蔓。如果timeout>0植酥,則遇到上述情況時(shí),等待timeout秒弦牡,如果問(wèn)題沒(méi)有解決友驮,則對(duì)keyi+1開(kāi)始的list執(zhí)行pop操作
lSize
$redis->lSize('key');
返回名稱(chēng)為key的list有多少個(gè)元素
lIndex, lGet
$redis->lGet('key', 0);
返回名稱(chēng)為key的list中index位置的元素
lSet
$redis->lSet('key', 0, 'X');
給名稱(chēng)為key的list中index位置的元素賦值為value
lRange, lGetRange
$redis->lRange('key1', 0, -1);
返回名稱(chēng)為key的list中start至end之間的元素(end為 -1 ,返回所有)
lTrim, listTrim
$redis->lTrim('key', start, end);
截取名稱(chēng)為key的list驾锰,保留start至end之間的元素
lRem, lRemove
$redis->lRem('key', 'A', 2);
刪除count個(gè)名稱(chēng)為key的list中值為value的元素卸留。count為0,刪除所有值為value的元素椭豫,count>0從頭至尾刪除count個(gè)值為value的元素耻瑟,count<0從尾到頭刪除|count|個(gè)值為value的元素
lInsert
在名稱(chēng)為為key的list中,找到值為pivot 的value赏酥,并根據(jù)參數(shù)Redis::BEFORE | Redis::AFTER喳整,來(lái)確定,newvalue 是放在 pivot 的前面裸扶,或者后面框都。如果key不存在,不會(huì)插入姓言,如果 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
返回并刪除名稱(chēng)為srckey的list的尾元素,并將該元素添加到名稱(chēng)為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操作相關(guān)
sAdd
向名稱(chēng)為key的set中添加元素value,如果value存在何荚,不寫(xiě)入囱淋,return false
$redis->sAdd(key , value);
sRem, sRemove
刪除名稱(chēng)為key的set中的元素value
$redis->sAdd('key1' , 'set1');
$redis->sAdd('key1' , 'set2');
$redis->sAdd('key1' , 'set3');
$redis->sRem('key1', 'set2');
sMove
將value元素從名稱(chēng)為srckey的集合移到名稱(chēng)為dstkey的集合
$redis->sMove(seckey, dstkey, value);
sIsMember, sContains
名稱(chēng)為key的集合中查找是否有value元素,有ture 沒(méi)有 false
$redis->sIsMember(key, value);
sCard, sSize
返回名稱(chēng)為key的set的元素個(gè)數(shù)
$redis->sCard('key')
sPop
隨機(jī)返回并刪除名稱(chēng)為key的set中一個(gè)元素
$redis->sPop('key')
sRandMember
隨機(jī)返回名稱(chēng)為key的set中一個(gè)元素餐塘,不刪除
$redis->sPop('key')
sInter
求交集
$redis->sInter(array('key1', 'key2')) or $redis->sInter('key1', 'key2')
sInterStore
求交集并將交集保存到output的集合
$redis->sInterStore('output', 'key1', 'key2', 'key3')
sUnion
求并集
$redis->sUnion('s0', 's1', 's2');
s0,s1,s2 同時(shí)求并集
sUnionStore
求并集并將并集保存到output的集合
$redis->sUnionStore('output', 'key1', 'key2', 'key3')妥衣;
sDiff
求差集
sDiffStore
求差集并將差集保存到output的集合
sMembers, sGetMembers
返回名稱(chēng)為key的set的所有元素
sort
排序,分頁(yè)等
參數(shù)
'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
返回原來(lái)key中的值戒傻,并將value寫(xiě)入key
$redis->set('x', '42');
$exValue = $redis->getSet('x', 'lol'); // return '42', replaces x by 'lol'
$newValue = $redis->get('x')' // return 'lol'
append
string税手,名稱(chēng)為key的string的值在后面加上value
$redis->set('key', 'value1');
$redis->append('key', 'value2');
$redis->get('key');
getRange (方法不存在)
返回名稱(chēng)為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的長(zhǎng)度
$redis->strlen('key');
getBit/setBit
返回2進(jìn)制信息
zset(sorted set)操作相關(guān)
zAdd(key, score, member):向名稱(chēng)為key的zset中添加元素member,score用于排序需纳。如果該元素已經(jīng)存在芦倒,則根據(jù)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):返回名稱(chēng)為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) :刪除名稱(chēng)為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):返回名稱(chēng)為key的zset(元素已按score從大到小排序)中的index從start到end的所有元素.withscores: 是否輸出socre的值不翩,默認(rèn)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 ));
返回名稱(chēng)為key的zset中score >= star且score <= end的所有元素
zCount
$redis->zCount(key, star, end);
返回名稱(chēng)為key的zset中score >= star且score <= end的所有元素的個(gè)數(shù)
zRemRangeByScore, zDeleteRangeByScore
$redis->zRemRangeByScore('key', star, end);
刪除名稱(chēng)為key的zset中score >= star且score <= end的所有元素,返回刪除個(gè)數(shù)
zSize, zCard
返回名稱(chēng)為key的zset的所有元素的個(gè)數(shù)
zScore
$redis->zScore(key, val2);
返回名稱(chēng)為key的zset中元素val2的score
zRank, zRevRank
$redis->zRevRank(key, val);
返回名稱(chēng)為key的zset(元素已按score從小到大排序)中val元素的rank(即index器钟,從0開(kāi)始)津坑,若沒(méi)有val元素,返回“null”傲霸。zRevRank 是從大到小排序
zIncrBy
$redis->zIncrBy('key', increment, 'member');
如果在名稱(chēng)為key的zset中已經(jīng)存在元素member疆瑰,則該元素的score增加increment;否則向集合中添加該元素昙啄,其score的值為increment
zUnion/zInter
參數(shù)
keyOutput
arrayZSetKeys
arrayWeights
aggregateFunction Either "SUM", "MIN", or "MAX": defines the behaviour to use on duplicate entries during the zUnion.
對(duì)N個(gè)zset求并集和交集穆役,并將最后的集合保存在dstkeyN中。對(duì)于集合中每一個(gè)元素的score跟衅,在進(jìn)行AGGREGATE運(yùn)算前孵睬,都要乘以對(duì)于的WEIGHT參數(shù)。如果沒(méi)有提供WEIGHT伶跷,默認(rèn)為1掰读。默認(rèn)的AGGREGATE是SUM,即結(jié)果集合中元素的score是所有集合對(duì)應(yīng)元素進(jìn)行SUM運(yùn)算的值叭莫,而MIN和MAX是指蹈集,結(jié)果集合中元素的score是所有集合對(duì)應(yīng)元素中最小值和最大值。
Hash操作
hSet
$redis->hSet('h', 'key1', 'hello');
向名稱(chēng)為h的hash中添加元素key1—>hello
hGet
$redis->hGet('h', 'key1');
返回名稱(chēng)為h的hash中key1對(duì)應(yīng)的value(hello)
hLen
$redis->hLen('h');
返回名稱(chēng)為h的hash中元素個(gè)數(shù)
hDel
$redis->hDel('h', 'key1');
刪除名稱(chēng)為h的hash中鍵為key1的域
hKeys
$redis->hKeys('h');
返回名稱(chēng)為key的hash中所有鍵
hVals
$redis->hVals('h')
返回名稱(chēng)為h的hash中所有鍵對(duì)應(yīng)的value
hGetAll
$redis->hGetAll('h');
返回名稱(chēng)為h的hash中所有的鍵(field)及其對(duì)應(yīng)的value
hExists
$redis->hExists('h', 'a');
名稱(chēng)為h的hash中是否存在鍵名字為a的域
hIncrBy
$redis->hIncrBy('h', 'x', 2);
將名稱(chēng)為h的hash中x的value增加2
hMset
$redis->hMset('user:1', array('name' => 'Joe', 'salary' => 2000));
向名稱(chēng)為key的hash中批量添加元素
hMGet
$redis->hmGet('h', array('field1', 'field2'));
返回名稱(chēng)為h的hash中field1,field2對(duì)應(yīng)的value
redis 操作相關(guān)
flushDB
清空當(dāng)前數(shù)據(jù)庫(kù)
flushAll
清空所有數(shù)據(jù)庫(kù)
randomKey
隨機(jī)返回key空間的一個(gè)key
$key = $redis->randomKey();
select
選擇一個(gè)數(shù)據(jù)庫(kù)
move
轉(zhuǎn)移一個(gè)key到另外一個(gè)數(shù)據(jù)庫(kù)
$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類(lèi)似雇初,但是拢肆,如果重新命名的名字已經(jīng)存在,不會(huì)替換成功
setTimeout, expire
設(shè)定一個(gè)key的活動(dòng)時(shí)間(s)
$redis->setTimeout('x', 3);
expireAt
key存活到一個(gè)unix時(shí)間戳?xí)r間
$redis->expireAt('x', time() + 3);
keys, getKeys
返回滿足給定pattern的所有key
$keyWithUserPrefix = $redis->keys('user*');
dbSize
查看現(xiàn)在數(shù)據(jù)庫(kù)有多少key
$count = $redis->dbSize();
auth
密碼認(rèn)證
$redis->auth('foobared');
bgrewriteaof
使用aof來(lái)進(jìn)行數(shù)據(jù)庫(kù)持久化
$redis->bgrewriteaof();
slaveof
選擇從服務(wù)器
$redis->slaveof('10.0.1.7', 6379);
save
將數(shù)據(jù)同步保存到磁盤(pán)
bgsave
將數(shù)據(jù)異步保存到磁盤(pán)
lastSave
返回上次成功將數(shù)據(jù)保存到磁盤(pán)的Unix時(shí)戳
info
返回redis的版本信息等詳情
type
返回key的類(lèi)型值
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