日韩性视频-久久久蜜桃-www中文字幕-在线中文字幕av-亚洲欧美一区二区三区四区-撸久久-香蕉视频一区-久久无码精品丰满人妻-国产高潮av-激情福利社-日韩av网址大全-国产精品久久999-日本五十路在线-性欧美在线-久久99精品波多结衣一区-男女午夜免费视频-黑人极品ⅴideos精品欧美棵-人人妻人人澡人人爽精品欧美一区-日韩一区在线看-欧美a级在线免费观看

歡迎訪問 生活随笔!

生活随笔

當(dāng)前位置: 首頁 > 编程语言 > php >内容正文

php

phpredis中文手册——《redis中文手册》 php版

發(fā)布時(shí)間:2024/10/12 php 31 豆豆
生活随笔 收集整理的這篇文章主要介紹了 phpredis中文手册——《redis中文手册》 php版 小編覺得挺不錯(cuò)的,現(xiàn)在分享給大家,幫大家做個(gè)參考.

redis中文手冊:http://readthedocs.org/docs/redis/en/latest/?

本文是參考《redis中文手冊》,將示例代碼用php來實(shí)現(xiàn),注意php-redis與redis_cli的區(qū)別(主要是返回值類型和參數(shù)用法)。

目錄(使用CTRL+F快速查找命令):

KeyStringHashListSet
  • 鍵(Key)
    • DEL
    • KEYS
    • RANDOMKEY
    • TTL
    • EXISTS
    • MOVE
    • RENAME
    • RENAMENX
    • TYPE
    • EXPIRE
    • EXPIREAT
    • OBJECT
    • PERSIST
    • SORT
  • 字符串(String)
    • SET
    • SETNX
    • SETEX
    • SETRANGE
    • MSET
    • MSETNX
    • APPEND
    • GET
    • MGET
    • GETRANGE
    • GETSET
    • STRLEN
    • INCR
    • INCRBY
    • DECR
    • DECRBY
    • SETBIT
    • GETBIT
  • 哈希表(Hash)
    • HSET
    • HSETNX
    • HMSET
    • HGET
    • HMGET
    • HGETALL
    • HDEL
    • HLEN
    • HEXISTS
    • HINCRBY
    • HKEYS
    • HVALS
  • 表(List)
    • LPUSH
    • LPUSHX
    • RPUSH
    • RPUSHX
    • LPOP
    • RPOP
    • BLPOP
    • BRPOP
    • LLEN
    • LRANGE
    • LREM
    • LSET
    • LTRIM
    • LINDEX
    • LINSERT
    • RPOPLPUSH
    • BRPOPLPUSH
  • 集合(Set)
    • SADD
    • SREM
    • SMEMBERS
    • SISMEMBER
    • SCARD
    • SMOVE
    • SPOP
    • SRANDMEMBER
    • SINTER
    • SINTERSTORE
    • SUNION
    • SUNIONSTORE
    • SDIFF
    • SDIFFSTORE
Sorted SetPub/SubTransactionConnectionServer
  • 有序集(Sorted Set)
    • ZADD
    • ZREM
    • ZCARD
    • ZCOUNT
    • ZSCORE
    • ZINCRBY
    • ZRANGE
    • ZREVRANGE
    • ZRANGEBYSCORE
    • ZREVRANGEBYSCORE
    • ZRANK
    • ZREVRANK
    • ZREMRANGEBYRANK
    • ZREMRANGEBYSCORE
    • ZINTERSTORE
    • ZUNIONSTORE
  • 發(fā)布/訂閱(Pub/Sub)
    • PUBLISH
    • SUBSCRIBE
    • PSUBSCRIBE
    • UNSUBSCRIBE
    • PUNSUBSCRIBE
  • 事務(wù)(Transaction)
    • WATCH
    • UNWATCH
    • MULTI
    • EXEC
    • DISCARD
  • 連接(Connection)
    • AUTH
    • PING
    • SELECT
    • ECHO
    • QUIT
  • 服務(wù)器(Server)
    • BGREWRITEAOF
    • BGSAVE
    • SAVE
    • LASTSAVE
    • DBSIZE
    • SLAVEOF
    • FLUSHALL
    • FLUSHDB
    • SHUTDOWN
    • SLOWLOG
    • INFO
    • CONFIG GET
    • CONFIG SET
    • CONFIG RESETSTAT
    • DEBUG OBJECT
    • DEBUG SEGFAULT
    • MONITOR
    • SYNC

phpredis是redis的php的一個(gè)擴(kuò)展,效率是相當(dāng)高有鏈表排序功能,對創(chuàng)建內(nèi)存級的模塊業(yè)務(wù)關(guān)系

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

下載地址如下:

https://github.com/owlient/phpredis(支持redis 2.0.4)

Redis::__construct構(gòu)造函數(shù)
$redis = new Redis();

connect, open 鏈接redis服務(wù)
參數(shù)
host: string,服務(wù)地址
port: int,端口號
timeout: float,鏈接時(shí)長 (可選, 默認(rèn)為 0 ,不限鏈接時(shí)間)
注: 在redis.conf中也有時(shí)間,默認(rèn)為300

pconnect, popen 不會主動關(guān)閉的鏈接
參考上面

setOption 設(shè)置redis模式

getOption 查看redis設(shè)置的模式

ping 查看連接狀態(tài)

?

KEY相關(guān)操作

DEL

移除給定的一個(gè)或多個(gè)key

如果key不存在,則忽略該命令。

時(shí)間復(fù)雜度:
O(N),N為要移除的key的數(shù)量。 移除單個(gè)字符串類型的key,時(shí)間復(fù)雜度為O(1)。 移除單個(gè)列表、集合、有序集合或哈希表類型的key,時(shí)間復(fù)雜度為O(M),M為以上數(shù)據(jù)結(jié)構(gòu)內(nèi)的元素?cái)?shù)量。
返回值:
被移除key的數(shù)量。

?

//DEL
#
情況1: 刪除單個(gè)key
$redis->set('myname','ikodota');
echo $redis->get('myname').'<br>'; # 返回:ikodota

$redis->del('myname');# 返回 TRUE(1)
var_dump($redis->get('myname')); # 返回 bool(false)

# 情況2: 刪除一個(gè)不存在的key
if(!$redis->exists('fake_key')) # 不存在
var_dump($redis->del('fake_key')); # 返回 int(0)

# 情況3: 同時(shí)刪除多個(gè)key
$array_mset=array('first_key'=>'first_val',
'second_key'=>'second_val',
'third_key'=>'third_val');
$redis->mset($array_mset); #用MSET一次儲存多個(gè)值
$array_mget=array('first_key','second_key','third_key');
var_dump($redis->mget($array_mget)); #一次返回多個(gè)值 //array(3) { [0]=> string(9) "first_val" [1]=> string(10) "second_val" [2]=> string(9) "third_val" }

$redis->del($array_mget); #同時(shí)刪除多個(gè)key
var_dump($redis->mget($array_mget)); #返回 array(3) { [0]=> bool(false) [1]=> bool(false) [2]=> bool(false) }

?

KEYSKEYS pattern?查找符合給定模式的keyKEYS?*命中數(shù)據(jù)庫中所有keyKEYS?h?llo命中hello,?hallo?and?hxllo等。 KEYS?h*llo命中hlloheeeeello等。 KEYS?h[ae]llo命中hellohallo,但不命中hillo

特殊符號用"\"隔開

時(shí)間復(fù)雜度:
O(N),N為數(shù)據(jù)庫中key的數(shù)量。
返回值:
符合給定模式的key列表。

警告 :KEYS的速度非常快,但在一個(gè)大的數(shù)據(jù)庫中使用它仍然可能造成性能問題,如果你需要從一個(gè)數(shù)據(jù)集中查找特定的key,你最好還是用集合(Set)

?

//KEYS
#
$redis->FLUSHALL();
$array_mset_keys=array('one'=>'1',
'two'=>'2',
'three '=>'3',
'four'=>'4');
$redis->mset($array_mset_keys); #用MSET一次儲存多個(gè)值
var_dump($redis->keys('*o*')); //array(3) { [0]=> string(4) "four" [1]=> string(3) "two" [2]=> string(3) "one" }
var_dump($redis->keys('t??')); //array(1) { [0]=> string(3) "two" }
var_dump($redis->keys('t[w]*')); //array(1) { [0]=> string(3) "two" }
print_r($redis->keys('*')); //Array ( [0] => four [1] => three [2] => two [3] => one )

?

RANDOMKEY

從當(dāng)前數(shù)據(jù)庫中隨機(jī)返回(不刪除)一個(gè)key

時(shí)間復(fù)雜度:
O(1)
返回值:
當(dāng)數(shù)據(jù)庫不為空時(shí),返回一個(gè)key。 當(dāng)數(shù)據(jù)庫為空時(shí),返回nil。

?

//RANDOMKEY
$redis->FLUSHALL();
# 情況1:數(shù)據(jù)庫不為空
$array_mset_randomkey=array('fruit'=>'apple',
'drink'=>'beer',
'food'=>'cookis');
$redis->mset($array_mset_randomkey);
echo $redis->randomkey();
print_r($redis->keys('*')); # 查看數(shù)據(jù)庫內(nèi)所有key,證明RANDOMKEY并不刪除key//Array ( [0] => food [1] => drink [2] => fruit )

# 情況2:數(shù)據(jù)庫為空
$redis->flushdb(); # 刪除當(dāng)前數(shù)據(jù)庫所有key
var_dump($redis-> randomkey()); //bool(false)

?

TTL
TTL key

返回給定key的剩余生存時(shí)間(time to live)(以秒為單位)。

時(shí)間復(fù)雜度:
O(1)
返回值:
key的剩余生存時(shí)間(以秒為單位)。 當(dāng)key不存在或沒有設(shè)置生存時(shí)間時(shí),返回-1?。

?

//TTL
#
情況1:帶TTL的key
$redis->flushdb();
//$redis->set('name','ikodota'); # 設(shè)置一個(gè)key
$redis->expire('name',30); # 設(shè)置生存時(shí)間為30秒 //return (integer) 1
echo $redis->get('name'); //return ikodota
echo $redis->ttl('name'); //(integer) 25

//echo $redis->ttl('name'); # 30秒過去,name過期 //(integer) -1

var_dump($redis->get('name')); # 過期的key將被刪除 //return bool(false);

# 情況2:不帶TTL的key
$redis->set('site','wikipedia.org');//OK
var_dump($redis->ttl('site'));//int(-1)

# 情況3:不存在的key
$redis->EXISTS('not_exists_key');//int(0)
var_dump($redis->TTL('not_exists_key'));//int(-1)

?

EXISTSEXISTS key

檢查給定key是否存在。

時(shí)間復(fù)雜度:
O(1)
返回值:
key存在,返回1,否則返回0
//EXISTS
echo '<br>EXISTS<br>';
$redis->set('db',"redis"); //bool(true)
var_dump($redis->exists('db')); # key存在 //bool(true)
$redis->del('db'); # 刪除key //int(1)
var_dump($redis->exists('db')) # key不存在 //bool(false)

?

MOVE
MOVE key db

將當(dāng)前數(shù)據(jù)庫(默認(rèn)為0)的key移動到給定的數(shù)據(jù)庫db當(dāng)中。

如果當(dāng)前數(shù)據(jù)庫(源數(shù)據(jù)庫)和給定數(shù)據(jù)庫(目標(biāo)數(shù)據(jù)庫)有相同名字的給定key,或者key不存在于當(dāng)前數(shù)據(jù)庫,那么MOVE沒有任何效果。

因此,也可以利用這一特性,將MOVE當(dāng)作鎖(locking)原語。

時(shí)間復(fù)雜度:
O(1)
返回值:
移動成功返回1,失敗則返回0
//MOVE
echo '<br><br>MOVE<br>';
# 情況1: key存在于當(dāng)前數(shù)據(jù)庫
$redis->SELECT(0); # redis默認(rèn)使用數(shù)據(jù)庫0,為了清晰起見,這里再顯式指定一次。//OK
$redis->SET('song',"secret base - Zone"); //OK
var_dump ($redis->MOVE('song',1)); # 將song移動到數(shù)據(jù)庫1 //bool(true)

# 情況2:當(dāng)key不存在的時(shí)候
$redis->SELECT(1);
var_dump ($redis->EXISTS('fake_key'));//bool(false);
var_dump($redis->MOVE('fake_key', 0)); # 試圖從數(shù)據(jù)庫1移動一個(gè)不存在的key到數(shù)據(jù)庫0,失敗) //bool(false)

$redis->SELECT(0); # 使用數(shù)據(jù)庫0
var_dump($redis->EXISTS('fake_key')); # 證實(shí)fake_key不存在 //bool(false)

# 情況3:當(dāng)源數(shù)據(jù)庫和目標(biāo)數(shù)據(jù)庫有相同的key時(shí)

$redis->SELECT(0); # 使用數(shù)據(jù)庫0
$redis->SET('favorite_fruit',"banana");

$redis->SELECT(1); # 使用數(shù)據(jù)庫1
$redis->SET('favorite_fruit',"apple");

$redis->SELECT(0); # 使用數(shù)據(jù)庫0,并試圖將favorite_fruit移動到數(shù)據(jù)庫1
var_dump($redis->MOVE('favorite_fruit',1)); # 因?yàn)閮蓚€(gè)數(shù)據(jù)庫有相同的key,MOVE失敗 //return bool(false)
echo $redis->GET('favorite_fruit'); # 數(shù)據(jù)庫0的favorite_fruit沒變 //return banana

$redis->SELECT(1);
echo $redis->GET('favorite_fruit'); # 數(shù)據(jù)庫1的favorite_fruit也是 //return apple

?

RENAME?

RENAME key newkey

key改名為newkey

當(dāng)keynewkey相同或者key不存在時(shí),返回一個(gè)錯(cuò)誤。

當(dāng)newkey已經(jīng)存在時(shí),RENAME命令將覆蓋舊值。

時(shí)間復(fù)雜度:
O(1)
返回值:
改名成功時(shí)提示OK,失敗時(shí)候返回一個(gè)錯(cuò)誤。
//RENAME
echo '<br><br>RENAME<br>';
# 情況1:key存在且newkey不存在
$redis->SET('message',"hello world");
var_dump($redis->RENAME('message','greeting')); //bool(true)
var_dump($redis->EXISTS('message')); # message不復(fù)存在 //bool(false)
var_dump($redis->EXISTS('greeting')); # greeting取而代之 //bool(true)

# 情況2:當(dāng)key不存在時(shí),返回錯(cuò)誤 ,php返回false;
var_dump($redis->RENAME('fake_key','never_exists')); //bool(false)

# 情況3:newkey已存在時(shí),RENAME會覆蓋舊newkey
$redis->SET('pc',"lenovo");
$redis->SET('personal_computer',"dell");
var_dump($redis->RENAME('pc','personal_computer')); //bool(true)
var_dump($redis->GET('pc')); //(nil) bool(false)
var_dump($redis->GET('personal_computer')); # dell“沒有”了 //string(6) "lenovo"

?

RENAMENX?RENAMENX key newkey

當(dāng)且僅當(dāng)newkey不存在時(shí),將key改為newkey

出錯(cuò)的情況和RENAME一樣(key不存在時(shí)報(bào)錯(cuò))。

時(shí)間復(fù)雜度:
O(1)
返回值:
修改成功時(shí),返回1。 如果newkey已經(jīng)存在,返回0
//RENAMENX
echo '<br><br>RENAMENX<br>';

# 情況1:newkey不存在,成功
$redis->SET('player',"MPlyaer");
$redis->EXISTS('best_player'); //int(0)
var_dump($redis->RENAMENX('player','best_player')); // bool(true)

# 情況2:newkey存在時(shí),失敗
$redis->SET('animal',"bear");
$redis->SET('favorite_animal', "butterfly");

var_dump($redis->RENAMENX('animal', 'favorite_animal'));// bool(false)

var_dump($redis->get('animal')); //string(4) "bear"
var_dump($redis->get('favorite_animal')); //string(9) "butterfly"

TYPETYPE key

返回key所儲存的值的類型。

時(shí)間復(fù)雜度:
O(1)
返回值:
none(key不存在) int(0) string(字符串) int(1) list(列表) int(3) set(集合) int(2) zset(有序集) int(4) hash(哈希表) int(5)

?

//TYPE
$redis->flushALL();
echo '<br><br>TYPE<br>';

var_dump($redis->TYPE('fake_key')); //none /int(0)

$redis->SET('weather',"sunny"); # 構(gòu)建一個(gè)字符串
var_dump($redis->TYPE('weather'));//string / int(1)

$redis->SADD('pat',"dog"); # 構(gòu)建一個(gè)集合
var_dump($redis->TYPE('pat')); //set /int(2)

$redis->LPUSH('book_list',"programming in scala"); # 構(gòu)建一個(gè)列表
var_dump($redis->TYPE('book_list'));//list / int(3)

$redis->ZADD('pats',1,'cat'); # 構(gòu)建一個(gè)zset (sorted set) // int(1)
$redis->ZADD('pats',2,'dog');
$redis->ZADD('pats',3,'pig');
var_dump($redis->zRange('pats',0,-1)); // array(3) { [0]=> string(3) "cat" [1]=> string(3) "dog" [2]=> string(3) "pig" }
var_dump($redis->TYPE('pats')); //zset / int(4)

$redis->HSET('website','google','www.g.cn'); # 一個(gè)新域
var_dump($redis->HGET('website','google')); //string(8) "www.g.cn"
var_dump($redis->TYPE('website')); //hash /int(5)

EXPIRE

EXPIRE key seconds

為給定key設(shè)置生存時(shí)間。

當(dāng)key過期時(shí),它會被自動刪除。

在Redis中,帶有生存時(shí)間的key被稱作“易失的”(volatile)。

?

在低于2.1.3版本的Redis中,已存在的生存時(shí)間不可覆蓋。 從2.1.3版本開始,key的生存時(shí)間可以被更新,也可以被PERSIST命令移除。(詳情參見?http://redis.io/topics/expire)。

?

時(shí)間復(fù)雜度:
O(1)
返回值:
設(shè)置成功返回1。 當(dāng)key不存在或者不能為key設(shè)置生存時(shí)間時(shí)(比如在低于2.1.3中你嘗試更新key的生存時(shí)間),返回0
//EXPIRE
$redis->select(7);
//$redis->flushdb();

echo '<br><br>EXPIRE<br>';
$redis->SET('cache_page',"www.cnblogs.com/ikodota");
$redis->EXPIRE('cache_page', 30); # 設(shè)置30秒后過期
sleep(6);
echo $redis->TTL('cache_page').'<br>'; # 查看給定key的剩余生存時(shí)間 //(integer) 24

$redis->EXPIRE('cache_page', 3000); # 更新生存時(shí)間,3000秒
sleep(4);
echo $redis->TTL('cache_page').'<br>'; //(integer) 2996

?

?

EXPIREAT?EXPIREAT key timestamp

EXPIREAT的作用和EXPIRE一樣,都用于為key設(shè)置生存時(shí)間。

不同在于EXPIREAT命令接受的時(shí)間參數(shù)是UNIX時(shí)間戳(unix timestamp)。

時(shí)間復(fù)雜度:
O(1)
返回值:
如果生存時(shí)間設(shè)置成功,返回1。 當(dāng)key不存在或沒辦法設(shè)置生存時(shí)間,返回0

?

//EXPIREAT
echo '<br><br>EXPIREAT<br>';
$redis->SET('cache','www.google.com');
echo $redis->EXPIREAT('cache','1355292000'); # 這個(gè)key將在2012.12.12過期

echo ($redis->TTL('cache')); //return 124345085

?

OBJECT?OBJECT subcommand [arguments [arguments]]

OBJECT命令允許從內(nèi)部察看給定key的Redis對象。

它通常用在除錯(cuò)(debugging)或者了解為了節(jié)省空間而對key使用特殊編碼的情況。 當(dāng)將Redis用作緩存程序時(shí),你也可以通過OBJECT命令中的信息,決定key的驅(qū)逐策略(eviction policies)。

OBJECT命令有多個(gè)子命令:

  • OBJECT?REFCOUNT?<key>返回給定key引用所儲存的值的次數(shù)。此命令主要用于除錯(cuò)。
  • OBJECT?ENCODING?<key>返回給定key鎖儲存的值所使用的內(nèi)部表示(representation)。
  • OBJECT?IDLETIME?<key>返回給定key自儲存以來的空轉(zhuǎn)時(shí)間(idle, 沒有被讀取也沒有被寫入),以秒為單位。
對象可以以多種方式編碼:
  • 字符串可以被編碼為raw(一般字符串)或int(用字符串表示64位數(shù)字是為了節(jié)約空間)。
  • 列表可以被編碼為ziplistlinkedlistziplist是為節(jié)約大小較小的列表空間而作的特殊表示。
  • 集合可以被編碼為intset或者hashtableintset是只儲存數(shù)字的小集合的特殊表示。
  • 哈希表可以編碼為zipmap或者hashtablezipmap是小哈希表的特殊表示。
  • 有序集合可以被編碼為ziplist或者skiplist格式。ziplist用于表示小的有序集合,而skiplist則用于表示任何大小的有序集合。
假如你做了什么讓Redis沒辦法再使用節(jié)省空間的編碼時(shí)(比如將一個(gè)只有1個(gè)元素的集合擴(kuò)展為一個(gè)有100萬個(gè)元素的集合),特殊編碼類型(specially encoded types)會自動轉(zhuǎn)換成通用類型(general type)。 時(shí)間復(fù)雜度:
O(1)
返回值:
REFCOUNTIDLETIME返回?cái)?shù)字。 ENCODING返回相應(yīng)的編碼類型。
//OBJECT
$redis->select(8);
echo '<br><br>OBJECT<br>';
$redis->SET('game',"WOW"); # 設(shè)置一個(gè)字符串
$redis->OBJECT('REFCOUNT','game'); # 只有一個(gè)引用

//sleep(5);

echo $redis->OBJECT('IDLETIME','game'); # 等待一陣。。。然后查看空轉(zhuǎn)時(shí)間 //(integer) 10
//echo $redis->GET('game'); # 提取game, 讓它處于活躍(active)狀態(tài) //return WOW
//echo $redis->OBJECT('IDLETIME','game'); # 不再處于空轉(zhuǎn) //(integer) 0

var_dump($redis->OBJECT('ENCODING','game')); # 字符串的編碼方式 //string(3) "raw"
$redis->SET('phone',15820123123); # 大的數(shù)字也被編碼為字符串
var_dump($redis->OBJECT('ENCODING','phone')); //string(3) "raw"
$redis->SET('age',20); # 短數(shù)字被編碼為int
var_dump($redis->OBJECT('ENCODING','age')); //string(3) "int"

?

PERSIST?PERSIST key

?

移除給定key的生存時(shí)間。

?

時(shí)間復(fù)雜度:
O(1)
返回值:
當(dāng)生存時(shí)間移除成功時(shí),返回1. 如果key不存在或key沒有設(shè)置生存時(shí)間,返回0

?

//PERSIST
echo '<br><br>PERSIST<br>';
$redis->SET('time_to_say_goodbye',"886...");
$redis->EXPIRE('time_to_say_goodbye', 300);
sleep(3);
echo $redis->TTL('time_to_say_goodbye'); # (int) 297
echo '<br>';

$redis->PERSIST('time_to_say_goodbye'); # 移除生存時(shí)間
echo $redis->TTL('time_to_say_goodbye'); # 移除成功 //int(-1)


SORT

?

SORT key [BY pattern] [LIMIT offset count] [GET pattern [GET pattern ...]] [ASC | DESC] [ALPHA] [STORE destination]

排序,分頁等
參數(shù)

array(
‘by’ => ‘some_pattern_*’,
‘limit’ => array(0, 1),
‘get’ => ‘some_other_pattern_*’ or an array of patterns,
‘sort’ => ‘a(chǎn)sc’ or ‘desc’,
‘a(chǎn)lpha’ => TRUE,
‘store’ => ‘external-key’
)

返回或保存給定列表、集合、有序集合key中經(jīng)過排序的元素。

排序默認(rèn)以數(shù)字作為對象,值被解釋為雙精度浮點(diǎn)數(shù),然后進(jìn)行比較。

?

一般SORT用法

最簡單的SORT使用方法是SORT?key

假設(shè)today_cost是一個(gè)保存數(shù)字的列表,SORT命令默認(rèn)會返回該列表值的遞增(從小到大)排序結(jié)果。

?

# 將數(shù)據(jù)一一加入到列表中
$redis->LPUSH('today_cost', 30);
$redis->LPUSH('today_cost', 1.5);
$redis->LPUSH('today_cost', 10);
$redis->LPUSH('today_cost', 8);
# 排序
var_dump($redis->SORT('today_cost')); //array(4) { [0]=> string(3) "1.5" [1]=> string(1) "8" [2]=> string(2) "10" [3]=> string(2) "30" }

當(dāng)數(shù)據(jù)集中保存的是字符串值時(shí),你可以用ALPHA修飾符(modifier)進(jìn)行排序。

# 將數(shù)據(jù)一一加入到列表中
$redis->LPUSH('website', "www.reddit.com");
$redis->LPUSH('website', "www.slashdot.com");
$redis->LPUSH('website', "www.infoq.com");
# 默認(rèn)排序
var_dump($redis->SORT('website'));//array(3) { [0]=> string(13) "www.infoq.com" [1]=> string(16) "www.slashdot.com" [2]=> string(14) "www.reddit.com" }

# 按字符排序 ALPHA=true
var_dump($redis->SORT('website', array('ALPHA'=>TRUE))); //array(3) { [0]=> string(13) "www.infoq.com" [1]=> string(14) "www.reddit.com" [2]=> string(16) "www.slashdot.com" }

如果你正確設(shè)置了!LC_COLLATE環(huán)境變量的話,Redis能識別UTF-8編碼。

排序之后返回的元素?cái)?shù)量可以通過LIMIT修飾符進(jìn)行限制。 LIMIT修飾符接受兩個(gè)參數(shù):offsetcountoffset指定要跳過的元素?cái)?shù)量,count指定跳過offset個(gè)指定的元素之后,要返回多少個(gè)對象。

以下例子返回排序結(jié)果的前5個(gè)對象(offset0表示沒有元素被跳過)。

# 將數(shù)據(jù)一一加入到列表中
$redis->LPUSH('rank', 30); //(integer) 1
$redis->LPUSH('rank', 56); //(integer) 2
$redis->LPUSH('rank', 42); //(integer) 3
$redis->LPUSH('rank', 22); //(integer) 4
$redis->LPUSH('rank', 0); //(integer) 5
$redis->LPUSH('rank', 11); //(integer) 6
$redis->LPUSH('rank', 32); //(integer) 7
$redis->LPUSH('rank', 67); //(integer) 8
$redis->LPUSH('rank', 50); //(integer) 9
$redis->LPUSH('rank', 44); //(integer) 10
$redis->LPUSH('rank', 55); //(integer) 11

# 排序
$redis_sort_option=array('LIMIT'=>array(0,5));
var_dump($redis->SORT('rank',$redis_sort_option)); # 返回排名前五的元素 // array(5) { [0]=> string(1) "0" [1]=> string(2) "11" [2]=> string(2) "22" [3]=> string(2) "30" [4]=> string(2) "32" }

修飾符可以組合使用。以下例子返回降序(從大到小)的前5個(gè)對象。

$redis_sort_option=array(
'LIMIT'=>array(0,5),
'SORT'=>'DESC'
);
var_dump($redis->SORT('rank',$redis_sort_option)); //array(5) { [0]=> string(2) "67" [1]=> string(2) "56" [2]=> string(2) "55" [3]=> string(2) "50" [4]=> string(2) "44" }

?

使用外部key進(jìn)行排序

有時(shí)候你會希望使用外部的key作為權(quán)重來比較元素,代替默認(rèn)的對比方法。

假設(shè)現(xiàn)在有用戶(user)數(shù)據(jù)如下:

id    ?name    level
-------------------------------
1    admin    ?9999
2    huangz   10
59230  jack     ? ?3
222   ?hacker    ??9999

id數(shù)據(jù)保存在key名為user_id的列表中。
name數(shù)據(jù)保存在key名為user_name_{id}的列表中
level數(shù)據(jù)保存在user_level_{id}的key中。

# 先將要使用的數(shù)據(jù)加入到數(shù)據(jù)庫中

# admin
$redis->LPUSH('user_id', 1);//(integer) 1
$redis->SET('user_name_1', 'admin');
$redis->SET('user_level_1',9999);

# huangz
$redis->LPUSH('user_id', 2);//(integer) 2
$redis->SET('user_name_2', 'huangz');
$redis->SET('user_level_2', 10);

# jack
$redis->LPUSH('user_id', 59230);//(integer) 3
$redis->SET('user_name_59230','jack');
$redis->SET('user_level_59230', 3);

# hacker
$redis->LPUSH('user_id', 222); //(integer) 4
$redis->SET('user_name_222', 'hacker');
$redis->SET('user_level_222', 9999);

?

如果希望按level從大到小排序user_id,可以使用以下命令:

$redis_sort_option=array('BY'=>'user_level_*',
'SORT'=>'DESC'
);
var_dump($redis->SORT('user_id',$redis_sort_option)); //array(4) { [0]=> string(3) "222" [1]=> string(1) "1" [2]=> string(1) "2" [3]=> string(5) "59230" }

#---------------------------
#
1) "222" # hacker
#
2) "1" # admin
#
3) "2" # huangz
#
4) "59230" # jack

但是有時(shí)候只是返回相應(yīng)的id沒有什么用,你可能更希望排序后返回id對應(yīng)的用戶名,這樣更友好一點(diǎn),使用GET選項(xiàng)可以做到這一點(diǎn):

?

$redis_sort_option=array('BY'=>'user_level_*',
'SORT'=>'DESC',
'GET'=>'user_name_*'
);
var_dump($redis->SORT('user_id', $redis_sort_option)); //array(4) { [0]=> string(6) "hacker" [1]=> string(5) "admin" [2]=> string(6) "huangz" [3]=> string(4) "jack" }
#1) "hacker"
#
2) "admin"
#
3) "huangz"
#
4) "jack"

可以多次地、有序地使用GET操作來獲取更多外部key

比如你不但希望獲取用戶名,還希望連用戶的密碼也一并列出,可以使用以下命令:

?

# 先添加一些測試數(shù)據(jù)
$redis->SET('user_password_222', "hey,im in");
$redis->SET('user_password_1', "a_long_long_password");
$redis->SET('user_password_2', "nobodyknows");
$redis->SET('user_password_59230', "jack201022");

# 獲取name和password
$redis_sort_option=array('BY'=>'user_level_*',
'SORT'=>'DESC',
'GET'=>array('user_name_*','user_password_*')
);
var_dump($redis->SORT('user_id',$redis_sort_option));//array(8) { [0]=> string(6) "hacker" [1]=> string(9) "hey,im in" [2]=> string(5) "admin" [3]=> string(20) "a_long_long_password" [4]=> string(6) "huangz" [5]=> string(11) "nobodyknows" [6]=> string(4) "jack" [7]=> string(10) "jack201022" }

#------------------------------------
#
1) "hacker" # 用戶名
#
2) "hey,im in" # 密碼
#
3) "jack"
#
4) "jack201022"
#
5) "huangz"
#
6) "nobodyknows"
#
7) "admin"
#
8) "a_long_long_password" # 注意GET操作是有序的,GET user_name_* GET user_password_* 和 GET user_password_* GET user_name_*返回的結(jié)果位置不同

?

# 獲取name和password 注意GET操作是有序的
$redis_sort_option=array('BY'=>'user_level_*',
'SORT'=>'DESC',
'GET'=>array('user_password_*','user_name_*')
);
var_dump($redis->SORT('user_id',$redis_sort_option));// array(8) { [0]=> string(9) "hey,im in" [1]=> string(6) "hacker" [2]=> string(20) "a_long_long_password" [3]=> string(5) "admin" [4]=> string(11) "nobodyknows" [5]=> string(6) "huangz" [6]=> string(10) "jack201022" [7]=> string(4) "jack" }

GET還有一個(gè)特殊的規(guī)則——"GET?#",用于獲取被排序?qū)ο?我們這里的例子是user_id)的當(dāng)前元素。

比如你希望user_idlevel排序,還要列出idnamepassword,可以使用以下命令:

?

$redis_sort_option=array('BY'=>'user_level_*',
'SORT'=>'DESC',
'GET'=>array('#','user_password_*','user_name_*')
);
var_dump($redis->SORT('user_id',$redis_sort_option));//array(12) { [0]=> string(3) "222" [1]=> string(9) "hey,im in" [2]=> string(6) "hacker" [3]=> string(1) "1" [4]=> string(20) "a_long_long_password" [5]=> string(5) "admin" [6]=> string(1) "2" [7]=> string(11) "nobodyknows" [8]=> string(6) "huangz" [9]=> string(5) "59230" [10]=> string(10) "jack201022" [11]=> string(4) "jack" }

#--------------------------------------------------------------
#
1) "222" # id
#
2) "hacker" # name
#
3) "hey,im in" # password
#
4) "1"
#
5) "admin"
#
6) "a_long_long_password"
#
7) "2"
#
8) "huangz"
#
9) "nobodyknows"
#
10) "59230"
#
11) "jack"
#
12) "jack201022"

只獲取對象而不排序

BY修飾符可以將一個(gè)不存在的key當(dāng)作權(quán)重,讓SORT跳過排序操作。

該方法用于你希望獲取外部對象而又不希望引起排序開銷時(shí)使用。

?

# 確保fake_key不存在
$redis->EXISTS('fake_key');//(integer) 0

# 以fake_key作BY參數(shù),不排序,只GET name 和 GET password
$redis_sort_option=array('BY'=>'fake_key',
'SORT'=>'DESC',
'GET'=>array('#','user_name_*','user_password_*')
);
var_dump($redis->SORT('user_id',$redis_sort_option));//array(12) { [0]=> string(3) "222" [1]=> string(6) "hacker" [2]=> string(9) "hey,im in" [3]=> string(5) "59230" [4]=> string(4) "jack" [5]=> string(10) "jack201022" [6]=> string(1) "2" [7]=> string(6) "huangz" [8]=> string(11) "nobodyknows" [9]=> string(1) "1" [10]=> string(5) "admin" [11]=> string(20) "a_long_long_password" }

#----------------------------------------------
#
1) "222" # id
#
2) "hacker" # user_name
#
3) "hey,im in" # password
#
4) "59230"
#
5) "jack"
#
6) "jack201022"
#
7) "2"
#
8) "huangz"
#
9) "nobodyknows"
#
10) "1"
#
11) "admin"
#
12) "a_long_long_password"

保存排序結(jié)果

默認(rèn)情況下,SORT操作只是簡單地返回排序結(jié)果,如果你希望保存排序結(jié)果,可以給STORE選項(xiàng)指定一個(gè)key作為參數(shù),排序結(jié)果將以列表的形式被保存到這個(gè)key上。(若指定key已存在,則覆蓋。)

$redis->EXISTS('user_info_sorted_by_level'); # 確保指定key不存在 //(integer) 0
$redis_sort_option=array('BY'=>'user_level_*',
'GET'=>array('#','user_name_*','user_password_*'),
'STORE'=>'user_info_sorted_by_level'
);

var_dump($redis->SORT('user_id',$redis_sort_option)); //int(12)
var_dump($redis->LRANGE('user_info_sorted_by_level', 0 ,11)); # 查看排序結(jié)果 //array(12) { [0]=> string(5) "59230" [1]=> string(4) "jack" [2]=> string(10) "jack201022" [3]=> string(1) "2" [4]=> string(6) "huangz" [5]=> string(11) "nobodyknows" [6]=> string(3) "222" [7]=> string(6) "hacker" [8]=> string(9) "hey,im in" [9]=> string(1) "1" [10]=> string(5) "admin" [11]=> string(20) "a_long_long_password" }

#-----------------------------------------------------------------
#
1) "59230"
#
2) "jack"
#
3) "jack201022"
#
4) "2"
#
5) "huangz"
#
6) "nobodyknows"
#
7) "222"
#
8) "hacker"
#
9) "hey,im in"
#
10) "1"
#
11) "admin"
#
12) "a_long_long_password"

一個(gè)有趣的用法是將SORT結(jié)果保存,用EXPIRE為結(jié)果集設(shè)置生存時(shí)間,這樣結(jié)果集就成了SORT操作的一個(gè)緩存。

這樣就不必頻繁地調(diào)用SORT操作了,只有當(dāng)結(jié)果集過期時(shí),才需要再調(diào)用一次SORT操作。

有時(shí)候?yàn)榱苏_實(shí)現(xiàn)這一用法,你可能需要加鎖以避免多個(gè)客戶端同時(shí)進(jìn)行緩存重建(也就是多個(gè)客戶端,同一時(shí)間進(jìn)行SORT操作,并保存為結(jié)果集),具體參見SETNX命令。

在GET和BY中使用哈希表

可以使用哈希表特有的語法,在SORT命令中進(jìn)行GET和BY操作。

# 假設(shè)現(xiàn)在我們的用戶表新增了一個(gè)serial項(xiàng)來為作為每個(gè)用戶的序列號
#
序列號以哈希表的形式保存在serial哈希域內(nèi)。

$redis_hash_testdata_array=array(1=>'23131283',
2=>'23810573',
222=>'502342349',
59230=>'2435829758'
);

$redis->HMSET('serial',$redis_hash_testdata_array);

# 我們希望以比較serial中的大小來作為排序user_id的方式
$redis_sort_option=array('BY'=>'*->serial');
var_dump($redis->SORT('user_id', $redis_sort_option)); //array(4) { [0]=> string(3) "222" [1]=> string(5) "59230" [2]=> string(1) "2" [3]=> string(1) "1" }

#----------------------------------------
#
1) "222"
#
2) "59230"
#
3) "2"
#
4) "1"

?

符號"->"用于分割哈希表的關(guān)鍵字(key name)和索引域(hash field),格式為"key->field"

除此之外,哈希表的BYGET操作和上面介紹的其他數(shù)據(jù)結(jié)構(gòu)(列表、集合、有序集合)沒有什么不同。

時(shí)間復(fù)雜度:
O(N+M*log(M)),N為要排序的列表或集合內(nèi)的元素?cái)?shù)量,M為要返回的元素?cái)?shù)量。 如果只是使用SORT命令的GET選項(xiàng)獲取數(shù)據(jù)而沒有進(jìn)行排序,時(shí)間復(fù)雜度O(N)。
返回值:
沒有使用STORE參數(shù),返回列表形式的排序結(jié)果。 使用STORE參數(shù),返回排序結(jié)果的元素?cái)?shù)量。

?

字符串(String)

SET

SET key value

將字符串值value關(guān)聯(lián)到key

如果key已經(jīng)持有其他值,SET就覆寫舊值,無視類型。


時(shí)間復(fù)雜度:O(1)返回值:總是返回OK(TRUE),因?yàn)镾ET不可能失敗。

# 情況1:對字符串類型的key進(jìn)行SET
$redis->SET('apple', 'www.apple.com');#OK //bool(true)
$redis->GET('apple');//"www.apple.com"

# 情況2:對非字符串類型的key進(jìn)行SET
$redis->LPUSH('greet_list', "hello"); # 建立一個(gè)列表 #(integer) 1 //int(1)
$redis->TYPE('greet_list');#list //int(3)

$redis->SET('greet_list', "yooooooooooooooooo"); # 覆蓋列表類型 #OK //bool(true)
$redis->TYPE('greet_list');#string //int(1)

?

SETNX SETNX key value

key的值設(shè)為value,當(dāng)且僅當(dāng)key不存在。

若給定的key已經(jīng)存在,則SETNX不做任何動作。

SETNX是”SET if Not eXists”(如果不存在,則SET)的簡寫。

時(shí)間復(fù)雜度:
O(1)
返回值:
設(shè)置成功,返回1。 設(shè)置失敗,返回0
//SETNX
echo '<br><br>SETNX<br>';
$redis->EXISTS('job'); # job不存在 //bool(false);
$redis->SETNX('job', "programmer"); # job設(shè)置成功 //bool(true)
$redis->SETNX('job', "code-farmer"); # job設(shè)置失敗 //bool(false)
echo $redis->GET('job'); # 沒有被覆蓋 //"programmer"

設(shè)計(jì)模式(Design pattern): 將SETNX用于加鎖(locking)

SETNX可以用作加鎖原語(locking primitive)。比如說,要對關(guān)鍵字(key)foo加鎖,客戶端可以嘗試以下方式:

SETNX?lock.foo?<current?Unix?time?+?lock?timeout?+?1>

如果SETNX返回1,說明客戶端已經(jīng)獲得了鎖,key設(shè)置的unix時(shí)間則指定了鎖失效的時(shí)間。之后客戶端可以通過DEL?lock.foo來釋放鎖。

如果SETNX返回0,說明key已經(jīng)被其他客戶端上鎖了。如果鎖是非阻塞(non blocking lock)的,我們可以選擇返回調(diào)用,或者進(jìn)入一個(gè)重試循環(huán),直到成功獲得鎖或重試超時(shí)(timeout)。

處理死鎖(deadlock)

上面的鎖算法有一個(gè)問題:如果因?yàn)榭蛻舳耸 ⒈罎⒒蚱渌驅(qū)е聸]有辦法釋放鎖的話,怎么辦?

這種狀況可以通過檢測發(fā)現(xiàn)——因?yàn)樯湘i的key保存的是unix時(shí)間戳,假如key值的時(shí)間戳小于當(dāng)前的時(shí)間戳,表示鎖已經(jīng)不再有效。

但是,當(dāng)有多個(gè)客戶端同時(shí)檢測一個(gè)鎖是否過期并嘗試釋放它的時(shí)候,我們不能簡單粗暴地刪除死鎖的key,再用SETNX上鎖,因?yàn)檫@時(shí)競爭條件(race condition)已經(jīng)形成了:

  • C1和C2讀取lock.foo并檢查時(shí)間戳,SETNX都返回0,因?yàn)樗呀?jīng)被C3鎖上了,但C3在上鎖之后就崩潰(crashed)了。
  • C1向lock.foo發(fā)送DEL命令。
  • C1向lock.foo發(fā)送SETNX并成功。
  • C2向lock.foo發(fā)送DEL命令。
  • C2向lock.foo發(fā)送SETNX并成功。
  • 出錯(cuò):因?yàn)楦偁帡l件的關(guān)系,C1和C2兩個(gè)都獲得了鎖。

幸好,以下算法可以避免以上問題。來看看我們聰明的C4客戶端怎么辦:

  • C4向lock.foo發(fā)送SETNX命令。
  • 因?yàn)楸罎⒌舻腃3還鎖著lock.foo,所以Redis向C4返回0
  • C4向lock.foo發(fā)送GET命令,查看lock.foo的鎖是否過期。如果不,則休眠(sleep)一段時(shí)間,并在之后重試。
  • 另一方面,如果lock.foo內(nèi)的unix時(shí)間戳比當(dāng)前時(shí)間戳老,C4執(zhí)行以下命令:

GETSET?lock.foo?<current?Unix?timestamp?+?lock?timeout?+?1>

  • 因?yàn)镚ETSET的作用,C4可以檢查看GETSET的返回值,確定lock.foo之前儲存的舊值仍是那個(gè)過期時(shí)間戳,如果是的話,那么C4獲得鎖。
  • 如果其他客戶端,比如C5,比C4更快地執(zhí)行了GETSET操作并獲得鎖,那么C4的GETSET操作返回的就是一個(gè)未過期的時(shí)間戳(C5設(shè)置的時(shí)間戳)。C4只好從第一步開始重試。
注意,即便C4的GETSET操作對key進(jìn)行了修改,這對未來也沒什么影響。 (這里是不是有點(diǎn)問題?C4的確是可以重試,但C5怎么辦?它的鎖的過期被C4修改了。——譯注)

?警告

為了讓這個(gè)加鎖算法更健壯,獲得鎖的客戶端應(yīng)該常常檢查過期時(shí)間以免鎖因諸如DEL等命令的執(zhí)行而被意外解開,因?yàn)榭蛻舳耸〉那闆r非常復(fù)雜,不僅僅是崩潰這么簡單,還可能是客戶端因?yàn)槟承┎僮鞅蛔枞讼喈?dāng)長時(shí)間,緊接著DEL命令被嘗試執(zhí)行(但這時(shí)鎖卻在另外的客戶端手上)。

SETEX SETEX key seconds value

將值value關(guān)聯(lián)到key,并將key的生存時(shí)間設(shè)為seconds(以秒為單位)。

如果key?已經(jīng)存在,SETEX命令將覆寫舊值。

這個(gè)命令類似于以下兩個(gè)命令:

$redis->SET('key', 'value');
$redis->EXPIRE('key','seconds'); # 設(shè)置生存時(shí)間

不同之處是,SETEX是一個(gè)原子性(atomic)操作,關(guān)聯(lián)值和設(shè)置生存時(shí)間兩個(gè)動作會在同一時(shí)間內(nèi)完成,該命令在Redis用作緩存時(shí),非常實(shí)用。

時(shí)間復(fù)雜度:
O(1)
返回值:
設(shè)置成功時(shí)返回OK。 當(dāng)seconds參數(shù)不合法時(shí),返回一個(gè)錯(cuò)誤。
# 情況1:key不存在
$redis->SETEX('cache_user_id', 60,10086);//bool(true)
echo $redis->GET('cache_user_id'); # 值 //"10086"

sleep(4);
echo $redis->TTL('cache_user_id'); # 剩余生存時(shí)間 //int(56)

# 情況2:key已經(jīng)存在,key被覆寫
$redis->SET('cd', "timeless"); //bool(true);
$redis->SETEX('cd', 3000,"goodbye my love"); //bool(true);
echo $redis->GET('cd');//"goodbye my love"

?

SETRANGE

SETRANGE key offset value

value參數(shù)覆寫(Overwrite)給定key所儲存的字符串值,從偏移量offset開始。

不存在的key當(dāng)作空白字符串處理。

SETRANGE命令會確保字符串足夠長以便將value設(shè)置在指定的偏移量上,如果給定key原來儲存的字符串長度比偏移量小(比如字符串只有5個(gè)字符長,但你設(shè)置的offset10),那么原字符和偏移量之間的空白將用零比特(zerobytes,"\x00")來填充。

注意你能使用的最大偏移量是2^29-1(536870911),因?yàn)镽edis的字符串被限制在512兆(megabytes)內(nèi)。如果你需要使用比這更大的空間,你得使用多個(gè)key

時(shí)間復(fù)雜度:
對小(small)的字符串,平攤復(fù)雜度O(1)。(關(guān)于什么字符串是”小”的,請參考APPEND命令) 否則為O(M),M為value參數(shù)的長度。
返回值:
被SETRANGE修改之后,字符串的長度。

?警告

?當(dāng)生成一個(gè)很長的字符串時(shí),Redis需要分配內(nèi)存空間,該操作有時(shí)候可能會造成服務(wù)器阻塞(block)。在2010年的Macbook Pro上,設(shè)置偏移量為536870911(512MB內(nèi)存分配),耗費(fèi)約300毫秒, 設(shè)置偏移量為134217728(128MB內(nèi)存分配),耗費(fèi)約80毫秒,設(shè)置偏移量33554432(32MB內(nèi)存分配),耗費(fèi)約30毫秒,設(shè)置偏移量為8388608(8MB內(nèi)存分配),耗費(fèi)約8毫秒。 注意若首次內(nèi)存分配成功之后,再對同一個(gè)key調(diào)用SETRANGE操作,無須再重新內(nèi)存。

模式

因?yàn)橛辛薙ETRANGE和GETRANGE命令,你可以將Redis字符串用作具有O(1)隨機(jī)訪問時(shí)間的線性數(shù)組。這在很多真實(shí)用例中都是非常快速且高效的儲存方式。

# 情況1:對非空字符串進(jìn)行SETRANGE
$redis->SET('greeting', "hello world");
$redis->SETRANGE('greeting', 6, "Redis"); //int(11)
$redis->GET('greeting');//"hello Redis"

# 情況2:對空字符串/不存在的key進(jìn)行SETRANGE
$redis->EXISTS('empty_string');//bool(false)
$redis->SETRANGE('empty_string', 5 ,"Redis!"); # 對不存在的key使用SETRANGE //int(11)
var_dump($redis->GET('empty_string')); # 空白處被"\x00"填充 #"\x00\x00\x00\x00\x00Redis!" //return string(11) "Redis!"

MSET?
MSET key value [key value ...]

同時(shí)設(shè)置一個(gè)或多個(gè)key-value對。

當(dāng)發(fā)現(xiàn)同名的key存在時(shí),MSET會用新值覆蓋舊值,如果你不希望覆蓋同名key,請使用MSETNX命令。

MSET是一個(gè)原子性(atomic)操作,所有給定key都在同一時(shí)間內(nèi)被設(shè)置,某些給定key被更新而另一些給定key沒有改變的情況,不可能發(fā)生。

時(shí)間復(fù)雜度:
O(N),N為要設(shè)置的key數(shù)量。
返回值:
總是返回OK(因?yàn)?span id="ozvdkddzhkzd" class="pre">MSET不可能失敗)
#MSET
echo '<br><br>MSET<br>';
$redis->select(0);
$redis->flushdb();
$array_mset=array('date'=>'2012.3.5',
'time'=>'9.09a.m.',
'weather'=>'sunny'
);
$redis->MSET($array_mset); //bool(true)

var_dump($redis->KEYS('*')); # 確保指定的三個(gè)key-value對被插入 //array(3) { [0]=> string(4) "time" [1]=> string(7) "weather" [2]=> string(4) "date" }

# MSET覆蓋舊值的例子 但是經(jīng)過測試覆蓋不了
var_dump($redis->SET('google', "google.cn")); //bool(true)
var_dump($redis->MSET('google',"google.hk")); //bool(false)
echo $redis->GET('google'); //google.cn 與redis手冊的示例結(jié)果不符

?

MSETNX

MSETNX key value [key value ...]

同時(shí)設(shè)置一個(gè)或多個(gè)key-value對,當(dāng)且僅當(dāng)key不存在。

即使只有一個(gè)key已存在,MSETNX也會拒絕所有傳入key的設(shè)置操作

MSETNX是原子性的,因此它可以用作設(shè)置多個(gè)不同key表示不同字段(field)的唯一性邏輯對象(unique logic object),所有字段要么全被設(shè)置,要么全不被設(shè)置。

時(shí)間復(fù)雜度:
O(N),N為要設(shè)置的key的數(shù)量。
返回值:
當(dāng)所有key都成功設(shè)置,返回1。 如果所有key都設(shè)置失敗(最少有一個(gè)key已經(jīng)存在),那么返回0
# 情況1:對不存在的key進(jìn)行MSETNX
$array_mset=array('rmdbs'=>'MySQL',
'nosql'=>'MongoDB',
'key-value-store'=>'redis'
);
$redis->MSETNX($array_mset);//bool(true)


# 情況2:對已存在的key進(jìn)行MSETNX
$array_mset=array('rmdbs'=>'Sqlite',
'language'=>'python'
);
var_dump($redis->MSETNX($array_mset)); # rmdbs鍵已經(jīng)存在,操作失敗 //bool(false)
var_dump($redis->EXISTS('language')); # 因?yàn)椴僮魇窃有缘?#xff0c;language沒有被設(shè)置 bool(false)

echo $redis->GET('rmdbs'); # rmdbs沒有被修改 //"MySQL"

$array_mset_keys=array( 'rmdbs', 'nosql', 'key-value-store');
print_r($redis->MGET($array_mset_keys)); //Array ( [0] => MySQL [1] => MongoDB [2] => redis )

?

APPEND

APPEND key value

如果key已經(jīng)存在并且是一個(gè)字符串,APPEND命令將value追加到key原來的值之后。

如果key不存在,APPEND就簡單地將給定key設(shè)為value,就像執(zhí)行SET?key?value一樣。

時(shí)間復(fù)雜度:
平攤復(fù)雜度O(1)
返回值:
追加value之后,key中字符串的長度。
# 情況1:對不存在的key執(zhí)行APPEND

$redis->EXISTS('myphone'); # 確保myphone不存在 //bool(false)
$redis->APPEND('myphone',"nokia"); # 對不存在的key進(jìn)行APPEND,等同于SET myphone "nokia" //int(5) # 字符長度

# 情況2:對字符串進(jìn)行APPEND
$redis->APPEND('myphone', " - 1110");# 長度從5個(gè)字符增加到12個(gè)字符 //int(12)

echo $redis->GET('myphone'); # 查看整個(gè)字符串 //"nokia - 1110"

GET

GET key

返回key所關(guān)聯(lián)的字符串值。

如果key不存在則返回特殊值nil

假如key儲存的值不是字符串類型,返回一個(gè)錯(cuò)誤,因?yàn)镚ET只能用于處理字符串值。

時(shí)間復(fù)雜度:
O(1)
返回值:
key的值。 如果key不存在,返回nil

?

//GET
var_dump($redis->GET('fake_key')); #(nil) //return bool(false)
$redis->SET('animate', "anohana"); //return bool(true)
var_dump($redis->GET('animate')); //return string(7) "anohana"

?

MGET

MGET key [key ...]

返回所有(一個(gè)或多個(gè))給定key的值。

如果某個(gè)指定key不存在,那么返回特殊值nil。因此,該命令永不失敗。

時(shí)間復(fù)雜度:
O(1)
返回值:
一個(gè)包含所有給定key的值的列表。
//MGET
echo '<br><br>MGET<br>';
$redis_mget_data_array=array('name'=>'ikodota','blog'=>'cnblogs.com/ikodota');
$redis->MSET($redis_mget_data_array);#用MSET一次儲存多個(gè)值

$redis_mget_key_array=array('name','blog');
var_dump($redis->MGET($redis_mget_key_array)); //array(2) { [0]=> string(7) "ikodota" [1]=> string(19) "cnblogs.com/ikodota" }

$redis->EXISTS('fake_key'); //bool(false)

$redis_mget_key_array=array('name','fake_key');
var_dump($redis->MGET($redis_mget_key_array)); # 當(dāng)MGET中有不存在key的情況 //array(2) { [0]=> string(7) "ikodota" [1]=> bool(false) }

GETRANGE

GETRANGE key start end

返回key中字符串值的子字符串,字符串的截取范圍由startend兩個(gè)偏移量決定(包括startend在內(nèi))。

負(fù)數(shù)偏移量表示從字符串最后開始計(jì)數(shù),-1表示最后一個(gè)字符,-2表示倒數(shù)第二個(gè),以此類推。

GETRANGE通過保證子字符串的值域(range)不超過實(shí)際字符串的值域來處理超出范圍的值域請求。

時(shí)間復(fù)雜度:
O(N),N為要返回的字符串的長度。 復(fù)雜度最終由返回值長度決定,但因?yàn)閺囊延凶址薪⒆幼址牟僮鞣浅A畠r(jià)(cheap),所以對于長度不大的字符串,該操作的復(fù)雜度也可看作O(1)。
返回值:
截取得出的子字符串。

注解:在<=2.0的版本里,GETRANGE被叫作SUBSTR。

//GETRANGE
echo '<br><br>GETRANGE<br>';
$redis->SET('greeting', "hello, my friend");
echo $redis->GETRANGE('greeting', 0, 4).'<br>'; # 返回索引0-4的字符,包括4。 //"hello"
echo $redis->GETRANGE('greeting', -1 ,-5).'<br>'; # 不支持回繞操作 //""
echo $redis->GETRANGE('greeting', -3 ,-1).'<br>'; # 負(fù)數(shù)索引 //"end"
echo $redis->GETRANGE('greeting', 0, -1).'<br>'; # 從第一個(gè)到最后一個(gè) //"hello, my friend"
echo $redis->GETRANGE('greeting', 0, 1008611).'<br>'; # 值域范圍不超過實(shí)際字符串,超過部分自動被符略 //"hello, my friend"

?

GETSET

GETSET key value

將給定key的值設(shè)為value,并返回key的舊值。

當(dāng)key存在但不是字符串類型時(shí),返回一個(gè)錯(cuò)誤。

時(shí)間復(fù)雜度:
O(1)
返回值:
返回給定key的舊值(old value)。 當(dāng)key沒有舊值時(shí),返回nil
//GETSET
echo '<br><br>GETSET<br>';
var_dump($redis->EXISTS('mail'));//return bool(false);
var_dump($redis->GETSET('mail','xxx@google.com')); # 因?yàn)閙ail之前不存在,沒有舊值,返回nil ,#(nil) //bool(false)

var_dump($redis->GETSET('mail','xxx@yahoo.com')); # mail被更新,舊值被返回 //string(14) "xxx@google.com"

設(shè)計(jì)模式

GETSET可以和INCR組合使用,實(shí)現(xiàn)一個(gè)有原子性(atomic)復(fù)位操作的計(jì)數(shù)器(counter)。

舉例來說,每次當(dāng)某個(gè)事件發(fā)生時(shí),進(jìn)程可能對一個(gè)名為mycountkey調(diào)用INCR操作,通常我們還要在一個(gè)原子時(shí)間內(nèi)同時(shí)完成獲得計(jì)數(shù)器的值和將計(jì)數(shù)器值復(fù)位為0兩個(gè)操作。

可以用命令GETSET?mycounter?0來實(shí)現(xiàn)這一目標(biāo)。

$redis->SELECT(2);
echo $redis->INCR('mycount').'<br>'; #(integer) 11

if($redis->GET('mycount')>19){
echo $redis->GETSET('mycount', 0).'<br>'; # 一個(gè)原子內(nèi)完成GET mycount和SET mycount 0操作 #"11"
}
echo $redis->GET('mycount'); #"0"

?

STRLEN

STRLEN key

返回key所儲存的字符串值的長度。

當(dāng)key儲存的不是字符串值時(shí),返回一個(gè)錯(cuò)誤。

復(fù)雜度:
O(1)
返回值:
字符串值的長度。 當(dāng)?key不存在時(shí),返回0
$redis->SET('mykey', "Hello world");
echo $redis->STRLEN('mykey'); //int(11)
echo $redis->STRLEN('nonexisting'); # 不存在的key長度視為0 //int(0)

INCR

INCR key

key中儲存的數(shù)字值增一。

如果key不存在,以0key的初始值,然后執(zhí)行INCR操作。

如果值包含錯(cuò)誤的類型,或字符串類型的值不能表示為數(shù)字,那么返回一個(gè)錯(cuò)誤。

本操作的值限制在64位(bit)有符號數(shù)字表示之內(nèi)。

時(shí)間復(fù)雜度:
O(1)
返回值:
執(zhí)行INCR命令之后key的值。

注解:這是一個(gè)針對字符串的操作,因?yàn)镽edis沒有專用的整數(shù)類型,所以key內(nèi)儲存的字符串被解釋為十進(jìn)制64位有符號整數(shù)來執(zhí)行INCR操作。

$redis->SET('page_view', 20);
var_dump($redis->INCR('page_view')); //int(21)
var_dump($redis->GET('page_view')); # 數(shù)字值在Redis中以字符串的形式保存 //string(2) "21

INCRBY

INCRBY key increment

key所儲存的值加上增量increment

如果key不存在,以0key的初始值,然后執(zhí)行INCRBY命令。

如果值包含錯(cuò)誤的類型,或字符串類型的值不能表示為數(shù)字,那么返回一個(gè)錯(cuò)誤。

本操作的值限制在64位(bit)有符號數(shù)字表示之內(nèi)。

關(guān)于更多遞增(increment)/遞減(decrement)操作信息,參見INCR命令。

時(shí)間復(fù)雜度:
O(1)
返回值:
加上increment之后,key的值。
//INCRBY
echo '<br><br>INCRBY<br>';
# 情況1:key存在且是數(shù)字值
$redis->SET('rank', 50); # 設(shè)置rank為50
$redis->INCRBY('rank', 20); # 給rank加上20
var_dump($redis->GET('rank')); #"70" //string(2) "70"

# 情況2:key不存在
$redis->EXISTS('counter'); //bool(false)
$redis->INCRBY('counter'); #int 30 //bool(false)
var_dump($redis->GET('counter')); #30 //經(jīng)測試 與手冊上結(jié)果不一樣,不能直接從bool型轉(zhuǎn)為int型。 return bool(false)

# 情況3:key不是數(shù)字值
$redis->SET('book', "long long ago...");
var_dump($redis->INCRBY('book', 200)); #(error) ERR value is not an integer or out of range // bool(false)

?

DECR

DECR key

key中儲存的數(shù)字值減一。

如果key不存在,以0key的初始值,然后執(zhí)行DECR操作。

如果值包含錯(cuò)誤的類型,或字符串類型的值不能表示為數(shù)字,那么返回一個(gè)錯(cuò)誤。

本操作的值限制在64位(bit)有符號數(shù)字表示之內(nèi)。

關(guān)于更多遞增(increment)/遞減(decrement)操作信息,參見INCR命令。

時(shí)間復(fù)雜度:
O(1)
返回值:
執(zhí)行DECR命令之后key的值。
//DECR
$redis->SELECT(3);
$redis->flushdb();
echo '<br><br>DECR<br>';
# 情況1:對存在的數(shù)字值key進(jìn)行DECR
$redis->SET('failure_times', 10);
$redis->DECR('failure_times'); //int(9)
echo $redis->GET('failure_times').'<br>'; //string(1) "9"

# 情況2:對不存在的key值進(jìn)行DECR
$redis->EXISTS('count'); #(integer) 0 //bool(false)
$redis->DECR('count'); //int(-1)
echo $redis->GET('count').'<br>'; //string(2) "-1"

# 情況3:對存在但不是數(shù)值的key進(jìn)行DECR
$redis->SET('company', 'YOUR_CODE_SUCKS.LLC');
var_dump($redis->DECR('company')); #(error) ERR value is not an integer or out of range //bool(false)
echo $redis->GET('company').'<br>'; //YOUR_CODE_SUCKS.LLC

?

DECRBY

DECRBY key decrement

key所儲存的值減去減量decrement

如果key不存在,以0key的初始值,然后執(zhí)行DECRBY操作。

如果值包含錯(cuò)誤的類型,或字符串類型的值不能表示為數(shù)字,那么返回一個(gè)錯(cuò)誤。

本操作的值限制在64位(bit)有符號數(shù)字表示之內(nèi)。

關(guān)于更多遞增(increment)/遞減(decrement)操作信息,參見INCR命令。

時(shí)間復(fù)雜度:
O(1)
返回值:
減去decrement之后,key的值。
# 情況1:對存在的數(shù)值key進(jìn)行DECRBY
$redis->SET('count', 100);
var_dump($redis->DECRBY('count', 20)); //int(80)
var_dump($redis->GET('count')); //string(2) "80"

# 情況2:對不存在的key進(jìn)行DECRBY
$redis->EXISTS('pages');#(integer) 0 //bool(false)
var_dump($redis->DECRBY('pages', 10)); //int(-10)
var_dump($redis->GET('pages')); //string(3) "-10"

?

SETBIT

SETBIT key offset value

key所儲存的字符串值,設(shè)置或清除指定偏移量上的位(bit)。

位的設(shè)置或清除取決于value參數(shù),可以是0也可以是1

當(dāng)key不存在時(shí),自動生成一個(gè)新的字符串值。

字符串會增長(grown)以確保它可以將value保存在指定的偏移量上。當(dāng)字符串值增長時(shí),空白位置以0填充。

offset參數(shù)必須大于或等于0,小于2^32(bit映射被限制在512MB內(nèi))。

時(shí)間復(fù)雜度:
O(1)
返回值:
指定偏移量原來儲存的位("0"或"1").

警告:對使用大的offset的SETBIT操作來說,內(nèi)存分配可能造成Redis服務(wù)器被阻塞。具體參考SETRANGE命令,warning(警告)部分。

//SETBIT
echo '<br><br>SETBIT<br>';
$bit_val=67;
echo decbin($bit_val).'<br>'; //1000011
var_dump($redis->SETBIT('bit',1,1));//int(0) 空位上都是0
var_dump($redis->SETBIT('bit',2,0));//int(0)
var_dump($redis->SETBIT('bit',3,0));//int(0)
var_dump($redis->SETBIT('bit',4,0));//int(0)
var_dump($redis->SETBIT('bit',5,0));//int(0)
var_dump($redis->SETBIT('bit',6,1));//int(0)
var_dump($redis->SETBIT('bit',7,1));//int(0)

var_dump($redis->GET('bit')); //string(1) "C" ,二進(jìn)制為:1000011 ,ASCII:67

var_dump($redis->GETBIT('bit', 6 )); //int(1) 取出第6位(從左到右)為“1”

var_dump($redis->SETBIT('bit',5,1));//int(0) 把第5位的0改為1
var_dump($redis->SETBIT('bit',6,0));//int(1) 把第6位的1改為0

var_dump($redis->GET('bit')); //string(1) "E ,二進(jìn)制為:1000101,ASCII:69l



GETBIT

GETBIT key offset

key所儲存的字符串值,獲取指定偏移量上的位(bit)。

當(dāng)offset比字符串值的長度大,或者key不存在時(shí),返回0

時(shí)間復(fù)雜度:
O(1)
返回值:
字符串值指定偏移量上的位(bit)。
#參見SETBIT的示例

?

哈希表(Hash)

HSET

HSET key field value

將哈希表key中的域field的值設(shè)為value

如果key不存在,一個(gè)新的哈希表被創(chuàng)建并進(jìn)行HSET操作。

如果域field已經(jīng)存在于哈希表中,舊值將被覆蓋。

時(shí)間復(fù)雜度:
O(1)
返回值:
如果field是哈希表中的一個(gè)新建域,并且值設(shè)置成功,返回1。 如果哈希表中域field已經(jīng)存在且舊值已被新值覆蓋,返回0

?

HSETNX

HSETNX key field value

將哈希表key中的域field的值設(shè)置為value,當(dāng)且僅當(dāng)域field不存在。

若域field已經(jīng)存在,該操作無效。

如果key不存在,一個(gè)新哈希表被創(chuàng)建并執(zhí)行HSETNX命令。

時(shí)間復(fù)雜度:
O(1)
返回值:
設(shè)置成功,返回1。 如果給定域已經(jīng)存在且沒有操作被執(zhí)行,返回0

?

HMSET

HMSET key field value [field value ...]

同時(shí)將多個(gè)field?-?value(域-值)對設(shè)置到哈希表key中。

此命令會覆蓋哈希表中已存在的域。

如果key不存在,一個(gè)空哈希表被創(chuàng)建并執(zhí)行HMSET操作。

時(shí)間復(fù)雜度:
O(N),Nfield?-?value對的數(shù)量。
返回值:
如果命令執(zhí)行成功,返回OK。 當(dāng)key不是哈希表(hash)類型時(shí),返回一個(gè)錯(cuò)誤。

?

?

HGET

HGET key field

返回哈希表key中給定域field的值。

時(shí)間復(fù)雜度:
O(1)
返回值:
給定域的值。 當(dāng)給定域不存在或是給定key不存在時(shí),返回nil

?

HMGET

HMGET key field [field ...]

返回哈希表key中,一個(gè)或多個(gè)給定域的值。

如果給定的域不存在于哈希表,那么返回一個(gè)nil值。

因?yàn)椴淮嬖诘?span id="ozvdkddzhkzd" class="pre">key被當(dāng)作一個(gè)空哈希表來處理,所以對一個(gè)不存在的key進(jìn)行HMGET操作將返回一個(gè)只帶有nil值的表。

時(shí)間復(fù)雜度:
O(N),N為給定域的數(shù)量。
返回值:
一個(gè)包含多個(gè)給定域的關(guān)聯(lián)值的表,表值的排列順序和給定域參數(shù)的請求順序一樣。

?

?

HGETALL

HGETALL key

返回哈希表key中,所有的域和值。

在返回值里,緊跟每個(gè)域名(field name)之后是域的值(value),所以返回值的長度是哈希表大小的兩倍。

時(shí)間復(fù)雜度:
O(N),N為哈希表的大小。
返回值:
以列表形式返回哈希表的域和域的值。 若key不存在,返回空列表。

?

?

HDEL

HDEL key field [field ...]

刪除哈希表key中的一個(gè)或多個(gè)指定域,不存在的域?qū)⒈缓雎浴?/p> 時(shí)間復(fù)雜度:

O(N),N為要?jiǎng)h除的域的數(shù)量。
返回值:
被成功移除的域的數(shù)量,不包括被忽略的域。

注解:在Redis2.4以下的版本里,HDEL每次只能刪除單個(gè)域,如果你需要在一個(gè)原子時(shí)間內(nèi)刪除多個(gè)域,請將命令包含在MULTI/?EXEC塊內(nèi)。

?

HLEN

HLEN key

返回哈希表key中域的數(shù)量。

時(shí)間復(fù)雜度:
O(1)
返回值:
哈希表中域的數(shù)量。 當(dāng)key不存在時(shí),返回0

?

HEXISTS

HEXISTS key field

查看哈希表key中,給定域field是否存在。

時(shí)間復(fù)雜度:
O(1)
返回值:
如果哈希表含有給定域,返回1。 如果哈希表不含有給定域,或key不存在,返回0

?

HINCRBY

HINCRBY key field increment

為哈希表key中的域field的值加上增量increment

增量也可以為負(fù)數(shù),相當(dāng)于對給定域進(jìn)行減法操作。

如果key不存在,一個(gè)新的哈希表被創(chuàng)建并執(zhí)行HINCRBY命令。

如果域field不存在,那么在執(zhí)行命令前,域的值被初始化為0

對一個(gè)儲存字符串值的域field執(zhí)行HINCRBY命令將造成一個(gè)錯(cuò)誤。

本操作的值限制在64位(bit)有符號數(shù)字表示之內(nèi)。

時(shí)間復(fù)雜度:
O(1)
返回值:
執(zhí)行HINCRBY命令之后,哈希表key中域field的值。

?

HKEYS

HKEYS key

返回哈希表key中的所有域。

時(shí)間復(fù)雜度:
O(N),N為哈希表的大小。
返回值:
一個(gè)包含哈希表中所有域的表。 當(dāng)key不存在時(shí),返回一個(gè)空表。

?

HVALS

HVALS key

返回哈希表key中的所有值。

時(shí)間復(fù)雜度:
O(N),N為哈希表的大小。
返回值:
一個(gè)包含哈希表中所有值的表。 當(dāng)key不存在時(shí),返回一個(gè)空表。

?

表(List)

頭元素和尾元素

頭元素指的是列表左端/前端第一個(gè)元素,尾元素指的是列表右端/后端第一個(gè)元素。

舉個(gè)例子,列表list包含三個(gè)元素:x,?y,?z,其中x是頭元素,而z則是尾元素。

空列表

指不包含任何元素的列表,Redis將不存在的key也視為空列表。

?

LPUSH

LPUSH key value [value ...]

將一個(gè)或多個(gè)值value插入到列表key的表頭。

如果有多個(gè)value值,那么各個(gè)value值按從左到右的順序依次插入到表頭:比如對一個(gè)空列表(mylist)執(zhí)行LPUSH?mylist?a?b?c,則結(jié)果列表為c?b?a,等同于執(zhí)行執(zhí)行命令LPUSH?mylist?aLPUSH?mylist?bLPUSH?mylist?c

如果key不存在,一個(gè)空列表會被創(chuàng)建并執(zhí)行LPUSH操作。

當(dāng)key存在但不是列表類型時(shí),返回一個(gè)錯(cuò)誤。

時(shí)間復(fù)雜度:
O(1)
返回值:
執(zhí)行LPUSH命令后,列表的長度。

?

注解:在Redis 2.4版本以前的LPUSH命令,都只接受單個(gè)value值。

?

LPUSHX

LPUSHX key value

將值value插入到列表key的表頭,當(dāng)且僅當(dāng)key存在并且是一個(gè)列表。

和LPUSH命令相反,當(dāng)key不存在時(shí),LPUSHX命令什么也不做。

時(shí)間復(fù)雜度:
O(1)
返回值:
LPUSHX命令執(zhí)行之后,表的長度。

?

RPUSH

RPUSH key value [value ...]

將一個(gè)或多個(gè)值value插入到列表key的表尾。

如果有多個(gè)value值,那么各個(gè)value值按從左到右的順序依次插入到表尾:比如對一個(gè)空列表(mylist)執(zhí)行RPUSH?mylist?a?b?c,則結(jié)果列表為a?b?c,等同于執(zhí)行命令RPUSHmylist?aRPUSH?mylist?bRPUSH?mylist?c

如果key不存在,一個(gè)空列表會被創(chuàng)建并執(zhí)行RPUSH操作。

當(dāng)key存在但不是列表類型時(shí),返回一個(gè)錯(cuò)誤。

時(shí)間復(fù)雜度:
O(1)
返回值:
執(zhí)行RPUSH操作后,表的長度。

注解:在Redis 2.4版本以前的RPUSH命令,都只接受單個(gè)value值。

?

RPUSHX

RPUSHX key value

將值value插入到列表key的表尾,當(dāng)且僅當(dāng)key存在并且是一個(gè)列表。

和RPUSH命令相反,當(dāng)key不存在時(shí),RPUSHX命令什么也不做。

時(shí)間復(fù)雜度:
O(1)
返回值:
RPUSHX命令執(zhí)行之后,表的長度。

?

LPOP

LPOP key

移除并返回列表key的頭元素。

時(shí)間復(fù)雜度:
O(1)
返回值:
列表的頭元素。 當(dāng)key不存在時(shí),返回nil

?

RPOP

RPOP key

移除并返回列表key的尾元素。

時(shí)間復(fù)雜度:
O(1)
返回值:
列表的尾元素。 當(dāng)key不存在時(shí),返回nil

?

BLPOP

BLPOP key [key ...] timeout

BLPOP是列表的阻塞式(blocking)彈出原語。

它是LPOP命令的阻塞版本,當(dāng)給定列表內(nèi)沒有任何元素可供彈出的時(shí)候,連接將被BLPOP命令阻塞,直到等待超時(shí)或發(fā)現(xiàn)可彈出元素為止。

當(dāng)給定多個(gè)key參數(shù)時(shí),按參數(shù)key的先后順序依次檢查各個(gè)列表,彈出第一個(gè)非空列表的頭元素。

非阻塞行為

當(dāng)BLPOP被調(diào)用時(shí),如果給定key內(nèi)至少有一個(gè)非空列表,那么彈出遇到的第一個(gè)非空列表的頭元素,并和被彈出元素所屬的列表的名字一起,組成結(jié)果返回給調(diào)用者。

當(dāng)存在多個(gè)給定key時(shí),BLPOP按給定key參數(shù)排列的先后順序,依次檢查各個(gè)列表。

假設(shè)現(xiàn)在有job、?commandrequest三個(gè)列表,其中job不存在,commandrequest都持有非空列表。考慮以下命令:

BLPOP?job?command?request?0

BLPOP保證返回的元素來自command,因?yàn)樗前础辈檎?span id="ozvdkddzhkzd" class="pre">job?-> 查找command?-> 查找request“這樣的順序,第一個(gè)找到的非空列表。

?

?

阻塞行為

如果所有給定key都不存在或包含空列表,那么BLPOP命令將阻塞連接,直到等待超時(shí),或有另一個(gè)客戶端對給定key的任意一個(gè)執(zhí)行LPUSH或RPUSH命令為止。

超時(shí)參數(shù)timeout接受一個(gè)以秒為單位的數(shù)字作為值。超時(shí)參數(shù)設(shè)為0表示阻塞時(shí)間可以無限期延長(block indefinitely) 。

?

?

相同的key被多個(gè)客戶端同時(shí)阻塞

相同的key可以被多個(gè)客戶端同時(shí)阻塞。 不同的客戶端被放進(jìn)一個(gè)隊(duì)列中,按”先阻塞先服務(wù)”(first-BLPOP,first-served)的順序?yàn)?span id="ozvdkddzhkzd" class="pre">key執(zhí)行BLPOP命令。

在MULTI/EXEC事務(wù)中的BLPOP

BLPOP可以用于流水線(pipline,批量地發(fā)送多個(gè)命令并讀入多個(gè)回復(fù)),但把它用在MULTI/EXEC塊當(dāng)中沒有意義。因?yàn)檫@要求整個(gè)服務(wù)器被阻塞以保證塊執(zhí)行時(shí)的原子性,該行為阻止了其他客戶端執(zhí)行LPUSH或RPUSH命令。

因此,一個(gè)被包裹在MULTI/EXEC塊內(nèi)的BLPOP命令,行為表現(xiàn)得就像LPOP一樣,對空列表返回nil,對非空列表彈出列表元素,不進(jìn)行任何阻塞操作。

?

?

時(shí)間復(fù)雜度:O(1)返回值:

如果列表為空,返回一個(gè)nil。 反之,返回一個(gè)含有兩個(gè)元素的列表,第一個(gè)元素是被彈出元素所屬的key,第二個(gè)元素是被彈出元素的值。

?

?

BRPOP

BRPOP key [key ...] timeout

BRPOP是列表的阻塞式(blocking)彈出原語。

它是RPOP命令的阻塞版本,當(dāng)給定列表內(nèi)沒有任何元素可供彈出的時(shí)候,連接將被BRPOP命令阻塞,直到等待超時(shí)或發(fā)現(xiàn)可彈出元素為止。

當(dāng)給定多個(gè)key參數(shù)時(shí),按參數(shù)key的先后順序依次檢查各個(gè)列表,彈出第一個(gè)非空列表的尾部元素。

關(guān)于阻塞操作的更多信息,請查看BLPOP命令,BRPOP除了彈出元素的位置和BLPOP不同之外,其他表現(xiàn)一致。

時(shí)間復(fù)雜度:
O(1)
返回值:
假如在指定時(shí)間內(nèi)沒有任何元素被彈出,則返回一個(gè)nil和等待時(shí)長。 反之,返回一個(gè)含有兩個(gè)元素的列表,第一個(gè)元素是被彈出元素所屬的key,第二個(gè)元素是被彈出元素的值。

?

LLEN

LLEN key

返回列表key的長度。

如果key不存在,則key被解釋為一個(gè)空列表,返回0.

如果key不是列表類型,返回一個(gè)錯(cuò)誤。

時(shí)間復(fù)雜度:
O(1)
返回值:
列表key的長度。

?

LRANGE

LRANGE key start stop

返回列表key中指定區(qū)間內(nèi)的元素,區(qū)間以偏移量startstop指定。

下標(biāo)(index)參數(shù)startstop都以0為底,也就是說,以0表示列表的第一個(gè)元素,以1表示列表的第二個(gè)元素,以此類推。

你也可以使用負(fù)數(shù)下標(biāo),以-1表示列表的最后一個(gè)元素,-2表示列表的倒數(shù)第二個(gè)元素,以此類推。

注意LRANGE命令和編程語言區(qū)間函數(shù)的區(qū)別

假如你有一個(gè)包含一百個(gè)元素的列表,對該列表執(zhí)行LRANGE?list?0?10,結(jié)果是一個(gè)包含11個(gè)元素的列表,這表明stop下標(biāo)也在LRANGE命令的取值范圍之內(nèi)(閉區(qū)間),這和某些語言的區(qū)間函數(shù)可能不一致,比如Ruby的Range.newArray#slice和Python的range()函數(shù)。

超出范圍的下標(biāo)

超出范圍的下標(biāo)值不會引起錯(cuò)誤。

如果start下標(biāo)比列表的最大下標(biāo)end(LLEN?list減去1)還要大,或者start?>?stop,LRANGE返回一個(gè)空列表。

如果stop下標(biāo)比end下標(biāo)還要大,Redis將stop的值設(shè)置為end

時(shí)間復(fù)雜度:
O(S+N),S為偏移量startN為指定區(qū)間內(nèi)元素的數(shù)量。
返回值:
一個(gè)列表,包含指定區(qū)間內(nèi)的元素。

?

LREM

LREM key count value

根據(jù)參數(shù)count的值,移除列表中與參數(shù)value相等的元素。

count的值可以是以下幾種:
  • count?>?0: 從表頭開始向表尾搜索,移除與value相等的元素,數(shù)量為count
  • count?<?0: 從表尾開始向表頭搜索,移除與value相等的元素,數(shù)量為count的絕對值。
  • count?=?0: 移除表中所有與value相等的值。
時(shí)間復(fù)雜度:
O(N),N為列表的長度。
返回值:
被移除元素的數(shù)量。 因?yàn)椴淮嬖诘?span id="ozvdkddzhkzd" class="pre">key被視作空表(empty list),所以當(dāng)key不存在時(shí),LREM命令總是返回0

?

LSET

LSET key index value

將列表key下標(biāo)為index的元素的值甚至為value

更多信息請參考LINDEX操作。

當(dāng)index參數(shù)超出范圍,或?qū)σ粋€(gè)空列表(key不存在)進(jìn)行LSET時(shí),返回一個(gè)錯(cuò)誤。

時(shí)間復(fù)雜度:
對頭元素或尾元素進(jìn)行LSET操作,復(fù)雜度為O(1)。 其他情況下,為O(N),N為列表的長度。
返回值:
操作成功返回ok,否則返回錯(cuò)誤信息

?

LTRIM

LTRIM key start stop

對一個(gè)列表進(jìn)行修剪(trim),就是說,讓列表只保留指定區(qū)間內(nèi)的元素,不在指定區(qū)間之內(nèi)的元素都將被刪除。

舉個(gè)例子,執(zhí)行命令LTRIM?list?0?2,表示只保留列表list的前三個(gè)元素,其余元素全部刪除。

下標(biāo)(index)參數(shù)startstop都以0為底,也就是說,以0表示列表的第一個(gè)元素,以1表示列表的第二個(gè)元素,以此類推。

你也可以使用負(fù)數(shù)下標(biāo),以-1表示列表的最后一個(gè)元素,-2表示列表的倒數(shù)第二個(gè)元素,以此類推。

當(dāng)key不是列表類型時(shí),返回一個(gè)錯(cuò)誤。

LTRIM命令通常和LPUSH命令或RPUSH命令配合使用,舉個(gè)例子:

?

?

這個(gè)例子模擬了一個(gè)日志程序,每次將最新日志newest_log放到log列表中,并且只保留最新的100項(xiàng)。注意當(dāng)這樣使用LTRIM命令時(shí),時(shí)間復(fù)雜度是O(1),因?yàn)槠骄闆r下,每次只有一個(gè)元素被移除。

注意LTRIM命令和編程語言區(qū)間函數(shù)的區(qū)別

假如你有一個(gè)包含一百個(gè)元素的列表list,對該列表執(zhí)行LTRIM?list?0?10,結(jié)果是一個(gè)包含11個(gè)元素的列表,這表明stop下標(biāo)也在LTRIM命令的取值范圍之內(nèi)(閉區(qū)間),這和某些語言的區(qū)間函數(shù)可能不一致,比如Ruby的Range.newArray#slice和Python的range()函數(shù)。

超出范圍的下標(biāo)

超出范圍的下標(biāo)值不會引起錯(cuò)誤。

如果start下標(biāo)比列表的最大下標(biāo)end(LLEN?list減去1)還要大,或者start?>?stop,LTRIM返回一個(gè)空列表(因?yàn)長TRIM已經(jīng)將整個(gè)列表清空)。

如果stop下標(biāo)比end下標(biāo)還要大,Redis將stop的值設(shè)置為end

時(shí)間復(fù)雜度:
O(N),N為被移除的元素的數(shù)量。
返回值:
命令執(zhí)行成功時(shí),返回ok

?

?

LINDEX

LINDEX key index

返回列表key中,下標(biāo)為index的元素。

下標(biāo)(index)參數(shù)startstop都以0為底,也就是說,以0表示列表的第一個(gè)元素,以1表示列表的第二個(gè)元素,以此類推。

你也可以使用負(fù)數(shù)下標(biāo),以-1表示列表的最后一個(gè)元素,-2表示列表的倒數(shù)第二個(gè)元素,以此類推。

如果key不是列表類型,返回一個(gè)錯(cuò)誤。

時(shí)間復(fù)雜度:
O(N),N為到達(dá)下標(biāo)index過程中經(jīng)過的元素?cái)?shù)量。 因此,對列表的頭元素和尾元素執(zhí)行LINDEX命令,復(fù)雜度為O(1)。
返回值:
列表中下標(biāo)為index的元素。 如果index參數(shù)的值不在列表的區(qū)間范圍內(nèi)(out of range),返回nil

?

LINSERT

LINSERT key BEFORE|AFTER pivot value

將值value插入到列表key當(dāng)中,位于值pivot之前或之后。

當(dāng)pivot不存在于列表key時(shí),不執(zhí)行任何操作。

當(dāng)key不存在時(shí),key被視為空列表,不執(zhí)行任何操作。

如果key不是列表類型,返回一個(gè)錯(cuò)誤。

時(shí)間復(fù)雜度:
O(N),N為尋找pivot過程中經(jīng)過的元素?cái)?shù)量。
返回值:
如果命令執(zhí)行成功,返回插入操作完成之后,列表的長度。 如果沒有找到pivot,返回-1。 如果key不存在或?yàn)榭樟斜?#xff0c;返回0

?

?

RPOPLPUSH

RPOPLPUSH source destination

命令RPOPLPUSH在一個(gè)原子時(shí)間內(nèi),執(zhí)行以下兩個(gè)動作:

  • 將列表source中的最后一個(gè)元素(尾元素)彈出,并返回給客戶端。
  • source彈出的元素插入到列表destination,作為destination列表的的頭元素。

舉個(gè)例子,你有兩個(gè)列表sourcedestinationsource列表有元素a,?b,?cdestination列表有元素x,?y,?z,執(zhí)行RPOPLPUSH?source?destination之后,source列表包含元素a,?bdestination列表包含元素c,?x,?y,?z?,并且元素c被返回。

如果source不存在,值nil被返回,并且不執(zhí)行其他動作。

如果sourcedestination相同,則列表中的表尾元素被移動到表頭,并返回該元素,可以把這種特殊情況視作列表的旋轉(zhuǎn)(rotation)操作。

時(shí)間復(fù)雜度:
O(1)
返回值:
被彈出的元素。

?

設(shè)計(jì)模式: 一個(gè)安全的隊(duì)列

Redis的列表經(jīng)常被用作隊(duì)列(queue),用于在不同程序之間有序地交換消息(message)。一個(gè)程序(稱之為生產(chǎn)者,producer)通過LPUSH命令將消息放入隊(duì)列中,而另一個(gè)程序(稱之為消費(fèi)者,consumer)通過RPOP命令取出隊(duì)列中等待時(shí)間最長的消息。

不幸的是,在這個(gè)過程中,一個(gè)消費(fèi)者可能在獲得一個(gè)消息之后崩潰,而未執(zhí)行完成的消息也因此丟失。

使用RPOPLPUSH命令可以解決這個(gè)問題,因?yàn)樗诜祷匾粋€(gè)消息之余,還將該消息添加到另一個(gè)列表當(dāng)中,另外的這個(gè)列表可以用作消息的備份表:假如一切正常,當(dāng)消費(fèi)者完成該消息的處理之后,可以用LREM命令將該消息從備份表刪除。

另一方面,助手(helper)程序可以通過監(jiān)視備份表,將超過一定處理時(shí)限的消息重新放入隊(duì)列中去(負(fù)責(zé)處理該消息的消費(fèi)者可能已經(jīng)崩潰),這樣就不會丟失任何消息了。

?

BRPOPLPUSH

BRPOPLPUSH source destination timeout

BRPOPLPUSH是RPOPLPUSH的阻塞版本,當(dāng)給定列表source不為空時(shí),BRPOPLPUSH的表現(xiàn)和RPOPLPUSH一樣。

當(dāng)列表source為空時(shí),BRPOPLPUSH命令將阻塞連接,直到等待超時(shí),或有另一個(gè)客戶端對source執(zhí)行LPUSH或RPUSH命令為止。

超時(shí)參數(shù)timeout接受一個(gè)以秒為單位的數(shù)字作為值。超時(shí)參數(shù)設(shè)為0表示阻塞時(shí)間可以無限期延長(block indefinitely) 。

更多相關(guān)信息,請參考RPOPLPUSH命令。

時(shí)間復(fù)雜度:
O(1)
返回值:
假如在指定時(shí)間內(nèi)沒有任何元素被彈出,則返回一個(gè)nil和等待時(shí)長。 反之,返回一個(gè)含有兩個(gè)元素的列表,第一個(gè)元素是被彈出元素的值,第二個(gè)元素是等待時(shí)長。

?

?

集合(Set)

?附錄,常用集合運(yùn)算:

? ?A = {'a', 'b', 'c'}
B = {'a', 'e', 'i', 'o', 'u'}

inter(x, y): 交集,在集合x和集合y中都存在的元素。 inter(A, B) = {'a'}union(x, y): 并集,在集合x中或集合y中的元素,如果一個(gè)元素在x和y中都出現(xiàn),那只記錄一次即可。 union(A,B) = {'a', 'b', 'c', 'e', 'i', 'o', 'u'}diff(x, y): 差集,在集合x中而不在集合y中的元素。 diff(A,B) = {'b', 'c'}card(x): 基數(shù),一個(gè)集合中元素的數(shù)量。 card(A) = 3空集: 基數(shù)為0的集合。

?

SADD

SADD key member [member ...]

將一個(gè)或多個(gè)member元素加入到集合key當(dāng)中,已經(jīng)存在于集合的member元素將被忽略。

假如key不存在,則創(chuàng)建一個(gè)只包含member元素作成員的集合。

當(dāng)key不是集合類型時(shí),返回一個(gè)錯(cuò)誤。

時(shí)間復(fù)雜度:
O(N),N是被添加的元素的數(shù)量。
返回值:
被添加到集合中的新元素的數(shù)量,不包括被忽略的元素。

注解:在Redis2.4版本以前,SADD只接受單個(gè)member值。

?

?

SREM

SREM key member [member ...]

移除集合key中的一個(gè)或多個(gè)member元素,不存在的member元素會被忽略。

當(dāng)key不是集合類型,返回一個(gè)錯(cuò)誤。

時(shí)間復(fù)雜度:
O(N),N為給定member元素的數(shù)量。
返回值:
被成功移除的元素的數(shù)量,不包括被忽略的元素。

注解:在Redis2.4版本以前,SREM只接受單個(gè)member值。

?

?

SMEMBERS

SMEMBERS key

返回集合key中的所有成員。

時(shí)間復(fù)雜度:
O(N),N為集合的基數(shù)。
返回值:
集合中的所有成員。

?

?

SISMEMBER

SISMEMBER key member

判斷member元素是否是集合key的成員。

時(shí)間復(fù)雜度:
O(1)
返回值:
如果member元素是集合的成員,返回1。 如果member元素不是集合的成員,或key不存在,返回0

?

?

SCARD

SCARD key

返回集合key基數(shù)(集合中元素的數(shù)量)。

時(shí)間復(fù)雜度:
O(1)
返回值:
集合的基數(shù)。 當(dāng)key不存在時(shí),返回0

?

?

SMOVE

SMOVE source destination member

member元素從source集合移動到destination集合。

SMOVE是原子性操作。

如果source集合不存在或不包含指定的member元素,則SMOVE命令不執(zhí)行任何操作,僅返回0。否則,member元素從source集合中被移除,并添加到destination集合中去。

當(dāng)destination集合已經(jīng)包含member元素時(shí),SMOVE命令只是簡單地將source集合中的member元素刪除。

當(dāng)sourcedestination不是集合類型時(shí),返回一個(gè)錯(cuò)誤。

時(shí)間復(fù)雜度:
O(1)
返回值:
如果member元素被成功移除,返回1。 如果member元素不是source集合的成員,并且沒有任何操作對destination集合執(zhí)行,那么返回0

?

?

SPOP

SPOP key

移除并返回集合中的一個(gè)隨機(jī)元素。

時(shí)間復(fù)雜度:
O(1)
返回值:
被移除的隨機(jī)元素。 當(dāng)key不存在或key是空集時(shí),返回nil

?

?

也可以參考:如果只想獲取一個(gè)隨機(jī)元素,但不想該元素從集合中被移除的話,可以使用SRANDMEMBER命令。

?

SRANDMEMBER

SRANDMEMBER key

返回集合中的一個(gè)隨機(jī)元素。

該操作和SPOP相似,但SPOP將隨機(jī)元素從集合中移除并返回,而SRANDMEMBER則僅僅返回隨機(jī)元素,而不對集合進(jìn)行任何改動。

時(shí)間復(fù)雜度:
O(1)
返回值:
被選中的隨機(jī)元素。 當(dāng)key不存在或key是空集時(shí),返回nil

?

?

SINTER

SINTER key [key ...]

返回一個(gè)集合的全部成員,該集合是所有給定集合的交集。

不存在的key被視為空集。

當(dāng)給定集合當(dāng)中有一個(gè)空集時(shí),結(jié)果也為空集(根據(jù)集合運(yùn)算定律)。

時(shí)間復(fù)雜度:
O(N * M),N為給定集合當(dāng)中基數(shù)最小的集合,M為給定集合的個(gè)數(shù)。
返回值:
交集成員的列表。

?

?

SINTERSTORE

SINTERSTORE destination key [key ...]

此命令等同于SINTER,但它將結(jié)果保存到destination集合,而不是簡單地返回結(jié)果集。

如果destination集合已經(jīng)存在,則將其覆蓋。

destination可以是key本身。

時(shí)間復(fù)雜度:
O(N * M),N為給定集合當(dāng)中基數(shù)最小的集合,M為給定集合的個(gè)數(shù)。
返回值:
結(jié)果集中的成員數(shù)量。

?

?

SUNION

SUNION key [key ...]

返回一個(gè)集合的全部成員,該集合是所有給定集合的并集。

不存在的key被視為空集。

時(shí)間復(fù)雜度:
O(N),N是所有給定集合的成員數(shù)量之和。
返回值:
并集成員的列表。

?

?

SUNIONSTORE

SUNIONSTORE destination key [key ...]

此命令等同于SUNION,但它將結(jié)果保存到destination集合,而不是簡單地返回結(jié)果集。

如果destination已經(jīng)存在,則將其覆蓋。

destination可以是key本身。

時(shí)間復(fù)雜度:
O(N),N是所有給定集合的成員數(shù)量之和。
返回值:
結(jié)果集中的元素?cái)?shù)量。

?

?

SDIFF

SDIFF key [key ...]

返回一個(gè)集合的全部成員,該集合是所有給定集合的差集?。

不存在的key被視為空集。

時(shí)間復(fù)雜度:
O(N),N是所有給定集合的成員數(shù)量之和。
返回值:
交集成員的列表。

?

?

SDIFFSTORE

SDIFFSTORE destination key [key ...]

此命令等同于SDIFF,但它將結(jié)果保存到destination集合,而不是簡單地返回結(jié)果集。

如果destination集合已經(jīng)存在,則將其覆蓋。

destination可以是key本身。

時(shí)間復(fù)雜度:
O(N),N是所有給定集合的成員數(shù)量之和。
返回值:
結(jié)果集中的元素?cái)?shù)量。

?

?

有序集(Sorted Set)

ZADD

?

ZADD key score member [[score member] [score member] ...]

將一個(gè)或多個(gè)member元素及其score值加入到有序集key當(dāng)中。

如果某個(gè)member已經(jīng)是有序集的成員,那么更新這個(gè)memberscore值,并通過重新插入這個(gè)member元素,來保證該member在正確的位置上。

score值可以是整數(shù)值或雙精度浮點(diǎn)數(shù)。

如果key不存在,則創(chuàng)建一個(gè)空的有序集并執(zhí)行ZADD操作。

當(dāng)key存在但不是有序集類型時(shí),返回一個(gè)錯(cuò)誤。

對有序集的更多介紹請參見sorted set。

時(shí)間復(fù)雜度:
O(M*log(N)),N是有序集的基數(shù),M為成功添加的新成員的數(shù)量。
返回值:
被成功添加的新成員的數(shù)量,不包括那些被更新的、已經(jīng)存在的成員。

?

?

注解:在Redis2.4版本以前,ZADD每次只能添加一個(gè)元素。

?

?

ZREM

ZREM key member [member ...]

移除有序集key中的一個(gè)或多個(gè)成員,不存在的成員將被忽略。

當(dāng)key存在但不是有序集類型時(shí),返回一個(gè)錯(cuò)誤。

時(shí)間復(fù)雜度:
O(M*log(N)),N為有序集的基數(shù),M為被成功移除的成員的數(shù)量。
返回值:
被成功移除的成員的數(shù)量,不包括被忽略的成員。

注解:在Redis2.4版本以前,ZREM每次只能刪除一個(gè)元素。

?

?

ZCARD

ZCARD key

返回有序集key的基數(shù)。

時(shí)間復(fù)雜度:
O(1)
返回值:
當(dāng)key存在且是有序集類型時(shí),返回有序集的基數(shù)。 當(dāng)key不存在時(shí),返回0

?

ZCOUNT

ZCOUNT key min max

返回有序集key中,score值在minmax之間(默認(rèn)包括score值等于minmax)的成員。

關(guān)于參數(shù)minmax的詳細(xì)使用方法,請參考ZRANGEBYSCORE命令。

時(shí)間復(fù)雜度:
O(log(N)+M),N為有序集的基數(shù),M為值在minmax之間的元素的數(shù)量。
返回值:
score值在minmax之間的成員的數(shù)量。

?

ZSCORE

ZSCORE key member

返回有序集key中,成員memberscore值。

如果member元素不是有序集key的成員,或key不存在,返回nil

時(shí)間復(fù)雜度:
O(1)
返回值:
member成員的score值,以字符串形式表示。

?

ZINCRBY

ZINCRBY key increment member

為有序集key的成員memberscore值加上增量increment

你也可以通過傳遞一個(gè)負(fù)數(shù)值increment,讓score減去相應(yīng)的值,比如ZINCRBY?key?-5?member,就是讓memberscore值減去5

當(dāng)key不存在,或member不是key的成員時(shí),ZINCRBY?key?increment?member等同于ZADD?key?increment?member

當(dāng)key不是有序集類型時(shí),返回一個(gè)錯(cuò)誤。

score值可以是整數(shù)值或雙精度浮點(diǎn)數(shù)。

時(shí)間復(fù)雜度:
O(log(N))
返回值:
member成員的新score值,以字符串形式表示。

?

?

ZRANGE

ZRANGE key start stop [WITHSCORES]

返回有序集key中,指定區(qū)間內(nèi)的成員。

其中成員的位置按score值遞增(從小到大)來排序。

具有相同score值的成員按字典序(lexicographical order)來排列。

如果你需要成員按score值遞減(從大到小)來排列,請使用ZREVRANGE命令。

下標(biāo)參數(shù)startstop都以0為底,也就是說,以0表示有序集第一個(gè)成員,以1表示有序集第二個(gè)成員,以此類推。 你也可以使用負(fù)數(shù)下標(biāo),以-1表示最后一個(gè)成員,-2表示倒數(shù)第二個(gè)成員,以此類推。 超出范圍的下標(biāo)并不會引起錯(cuò)誤。 比如說,當(dāng)start的值比有序集的最大下標(biāo)還要大,或是start?>?stop時(shí),ZRANGE命令只是簡單地返回一個(gè)空列表。 另一方面,假如stop參數(shù)的值比有序集的最大下標(biāo)還要大,那么Redis將stop當(dāng)作最大下標(biāo)來處理。 可以通過使用WITHSCORES選項(xiàng),來讓成員和它的score值一并返回,返回列表以value1,score1,?...,?valueN,scoreN的格式表示。 客戶端庫可能會返回一些更復(fù)雜的數(shù)據(jù)類型,比如數(shù)組、元組等。 時(shí)間復(fù)雜度:
O(log(N)+M),N為有序集的基數(shù),而M為結(jié)果集的基數(shù)。
返回值:
指定區(qū)間內(nèi),帶有score值(可選)的有序集成員的列表。

?

ZREVRANGE

ZREVRANGE key start stop [WITHSCORES]

返回有序集key中,指定區(qū)間內(nèi)的成員。

其中成員的位置按score值遞減(從大到小)來排列。 具有相同score值的成員按字典序的反序(reverse lexicographical order)排列。

除了成員按score值遞減的次序排列這一點(diǎn)外,ZREVRANGE命令的其他方面和ZRANGE命令一樣。

時(shí)間復(fù)雜度:
O(log(N)+M),N為有序集的基數(shù),而M為結(jié)果集的基數(shù)。
返回值:
指定區(qū)間內(nèi),帶有score值(可選)的有序集成員的列表。

?

?

ZRANGEBYSCORE

ZRANGEBYSCORE key min max [WITHSCORES] [LIMIT offset count]

返回有序集key中,所有score值介于minmax之間(包括等于minmax)的成員。有序集成員按score值遞增(從小到大)次序排列。

具有相同score值的成員按字典序(lexicographical order)來排列(該屬性是有序集提供的,不需要額外的計(jì)算)。

可選的LIMIT參數(shù)指定返回結(jié)果的數(shù)量及區(qū)間(就像SQL中的SELECT?LIMIT?offset,?count),注意當(dāng)offset很大時(shí),定位offset的操作可能需要遍歷整個(gè)有序集,此過程最壞復(fù)雜度為O(N)時(shí)間。

可選的WITHSCORES參數(shù)決定結(jié)果集是單單返回有序集的成員,還是將有序集成員及其score值一起返回。 該選項(xiàng)自Redis 2.0版本起可用。

區(qū)間及無限

minmax可以是-inf+inf,這樣一來,你就可以在不知道有序集的最低和最高score值的情況下,使用ZRANGEBYSCORE這類命令。

默認(rèn)情況下,區(qū)間的取值使用閉區(qū)間(小于等于或大于等于),你也可以通過給參數(shù)前增加(符號來使用可選的開區(qū)間(小于或大于)。

舉個(gè)例子:

?

返回所有符合條件1?<?score?<=?5的成員;

?

返回所有符合條件5?<?score?<?10的成員。

時(shí)間復(fù)雜度:
O(log(N)+M),N為有序集的基數(shù),M為被結(jié)果集的基數(shù)。
返回值:
指定區(qū)間內(nèi),帶有score值(可選)的有序集成員的列表。

?

?

ZREVRANGEBYSCORE

ZREVRANGEBYSCORE key max min [WITHSCORES] [LIMIT offset count]

返回有序集key中,score值介于maxmin之間(默認(rèn)包括等于maxmin)的所有的成員。有序集成員按score值遞減(從大到小)的次序排列。

具有相同score值的成員按字典序的反序(reverse lexicographical order)排列。

除了成員按score值遞減的次序排列這一點(diǎn)外,ZREVRANGEBYSCORE命令的其他方面和ZRANGEBYSCORE命令一樣。

時(shí)間復(fù)雜度:
O(log(N)+M),N為有序集的基數(shù),M為結(jié)果集的基數(shù)。
返回值:
指定區(qū)間內(nèi),帶有score值(可選)的有序集成員的列表。

?

?

ZRANK

ZRANK key member

返回有序集key中成員member的排名。其中有序集成員按score值遞增(從小到大)順序排列。

排名以0為底,也就是說,score值最小的成員排名為0

使用ZREVRANK命令可以獲得成員按score值遞減(從大到小)排列的排名。

時(shí)間復(fù)雜度:
O(log(N))
返回值:
如果member是有序集key的成員,返回member的排名。 如果member不是有序集key的成員,返回nil

?

ZREVRANK

ZREVRANK key member

返回有序集key中成員member的排名。其中有序集成員按score值遞減(從大到小)排序。

排名以0為底,也就是說,score值最大的成員排名為0

使用ZRANK命令可以獲得成員按score值遞增(從小到大)排列的排名。

時(shí)間復(fù)雜度:
O(log(N))
返回值:
如果member是有序集key的成員,返回member的排名。 如果member不是有序集key的成員,返回nil

?

?

ZREMRANGEBYRANK

ZREMRANGEBYRANK key start stop

移除有序集key中,指定排名(rank)區(qū)間內(nèi)的所有成員。

區(qū)間分別以下標(biāo)參數(shù)startstop指出,包含startstop在內(nèi)。

下標(biāo)參數(shù)startstop都以0為底,也就是說,以0表示有序集第一個(gè)成員,以1表示有序集第二個(gè)成員,以此類推。 你也可以使用負(fù)數(shù)下標(biāo),以-1表示最后一個(gè)成員,-2表示倒數(shù)第二個(gè)成員,以此類推。 時(shí)間復(fù)雜度:
O(log(N)+M),N為有序集的基數(shù),而M為被移除成員的數(shù)量。
返回值:
被移除成員的數(shù)量。

?

?

ZREMRANGEBYSCORE

ZREMRANGEBYSCORE key min max

移除有序集key中,所有score值介于minmax之間(包括等于minmax)的成員。

自版本2.1.6開始,score值等于minmax的成員也可以不包括在內(nèi),詳情請參見ZRANGEBYSCORE命令。

時(shí)間復(fù)雜度:
O(log(N)+M),N為有序集的基數(shù),而M為被移除成員的數(shù)量。
返回值:
被移除成員的數(shù)量。

?

?

ZINTERSTORE

ZINTERSTORE destination numkeys key [key ...] [WEIGHTS weight [weight ...]] [AGGREGATE SUM|MIN|MAX]

計(jì)算給定的一個(gè)或多個(gè)有序集的交集,其中給定key的數(shù)量必須以numkeys參數(shù)指定,并將該交集(結(jié)果集)儲存到destination

默認(rèn)情況下,結(jié)果集中某個(gè)成員的score值是所有給定集下該成員score值之和。

關(guān)于WEIGHTSAGGREGATE選項(xiàng)的描述,參見ZUNIONSTORE命令。

時(shí)間復(fù)雜度:
O(N*K)+O(M*log(M)),N為給定key中基數(shù)最小的有序集,K為給定有序集的數(shù)量,M為結(jié)果集的基數(shù)。
返回值:
保存到destination的結(jié)果集的基數(shù)。

?

?

ZUNIONSTORE

ZUNIONSTORE destination numkeys key [key ...] [WEIGHTS weight [weight ...]] [AGGREGATE SUM|MIN|MAX]

計(jì)算給定的一個(gè)或多個(gè)有序集的并集,其中給定key的數(shù)量必須以numkeys參數(shù)指定,并將該并集(結(jié)果集)儲存到destination

默認(rèn)情況下,結(jié)果集中某個(gè)成員的score值是所有給定集下該成員score值之和。

WEIGHTS

使用WEIGHTS選項(xiàng),你可以為每個(gè)給定有序集分別指定一個(gè)乘法因子(multiplication factor),每個(gè)給定有序集的所有成員的score值在傳遞給聚合函數(shù)(aggregation function)之前都要先乘以該有序集的因子。

如果沒有指定WEIGHTS選項(xiàng),乘法因子默認(rèn)設(shè)置為1

AGGREGATE

使用AGGREGATE選項(xiàng),你可以指定并集的結(jié)果集的聚合方式。

默認(rèn)使用的參數(shù)SUM,可以將所有集合中某個(gè)成員的score值之和作為結(jié)果集中該成員的score值;使用參數(shù)MIN,可以將所有集合中某個(gè)成員的最小score值作為結(jié)果集中該成員的score值;而參數(shù)MAX則是將所有集合中某個(gè)成員的最大score值作為結(jié)果集中該成員的score值。

時(shí)間復(fù)雜度:
O(N)+O(M log(M)),N為給定有序集基數(shù)的總和,M為結(jié)果集的基數(shù)。
返回值:
保存到destination的結(jié)果集的基數(shù)。

?

?

發(fā)布/訂閱(Pub/Sub)

PUBLISH

PUBLISH channel message

將信息?message?發(fā)送到指定的頻道?channel?。

時(shí)間復(fù)雜度:
O(N+M),其中?N?是頻道?channel?的訂閱者數(shù)量,而?M?則是使用模式訂閱(subscribed patterns)的客戶端的數(shù)量。
返回值:
接收到信息?message?的訂閱者數(shù)量。

?

?

SUBSCRIBE

SUBSCRIBE channel [channel ...]

訂閱給定頻道的信息。

時(shí)間復(fù)雜度:
O(N),其中?N?是訂閱的頻道的數(shù)量。
返回值:
接收到的信息(請參見下面的代碼說明)。

?

?

PSUBSCRIBE

PSUBSCRIBE pattern [pattern ...]

訂閱符合給定模式的頻道。

每個(gè)模式以?*?作為匹配符,比如?huangz*?匹配所有以?huangz?開頭的頻道(?huangzmsg?、?huangz-blog?、?huangz.tweets?等等),?news.*?匹配所有以?news.?開頭的頻道(news.it?、?news.global.today?等等),諸如此類。

時(shí)間復(fù)雜度:
O(N),?N?是訂閱的模式的數(shù)量。
返回值:
接收到的信息(請參見下面的代碼說明)。

?

?

UNSUBSCRIBE

警告:此命令在新版 Redis 中似乎已經(jīng)被廢棄?

PUNSUBSCRIBE

警告:此命令在新版 Redis 中似乎已經(jīng)被廢棄?

?

事務(wù)(Transaction)

WATCH

ATCH key [key ...]

監(jiān)視一個(gè)(或多個(gè)) key ,如果在事務(wù)執(zhí)行之前這個(gè)(或這些) key 被其他命令所改動,那么事務(wù)將被打斷。

時(shí)間復(fù)雜度:
O(1)。
返回值:
總是返回?OK?。

?

UNWATCH

UNWATCH

取消?WATCH?命令對所有 key 的監(jiān)視。

如果在執(zhí)行?WATCH?命令之后,?EXEC?命令或?DISCARD?命令先被執(zhí)行了的話,那么就不需要再執(zhí)行?UNWATCH?了。

因?yàn)?EXEC?命令會執(zhí)行事務(wù),因此?WATCH?命令的效果已經(jīng)產(chǎn)生了;而?DISCARD?命令在取消事務(wù)的同時(shí)也會取消所有對 key 的監(jiān)視,因此這兩個(gè)命令執(zhí)行之后,就沒有必要執(zhí)行?UNWATCH?了。

時(shí)間復(fù)雜度:
O(1)
返回值:
總是?OK?。

?

MULTI

MULTI

標(biāo)記一個(gè)事務(wù)塊的開始。

事務(wù)塊內(nèi)的多條命令會按照先后順序被放進(jìn)一個(gè)隊(duì)列當(dāng)中,最后由?EXEC?命令在一個(gè)原子時(shí)間內(nèi)執(zhí)行。

時(shí)間復(fù)雜度:
O(1)。
返回值:
總是返回?OK?。

?

?

EXEC

EXEC

執(zhí)行所有事務(wù)塊內(nèi)的命令。

假如某個(gè)(或某些) key 正處于?WATCH?命令的監(jiān)視之下,且事務(wù)塊中有和這個(gè)(或這些) key 相關(guān)的命令,那么?EXEC?命令只在這個(gè)(或這些) key 沒有被其他命令所改動的情況下執(zhí)行并生效,否則該事務(wù)被打斷(abort)。

時(shí)間復(fù)雜度:
事務(wù)塊內(nèi)所有命令的時(shí)間復(fù)雜度的總和。
返回值:
事務(wù)塊內(nèi)所有命令的返回值,按命令執(zhí)行的先后順序排列。 當(dāng)操作被打斷時(shí),返回空值?nil?。

?

?

DISCARD

DISCARD

取消事務(wù),放棄執(zhí)行事務(wù)塊內(nèi)的所有命令。

如果正在使用?WATCH?命令監(jiān)視某個(gè)(或某些) key ,那么取消所有監(jiān)視,等同于執(zhí)行命令?UNWATCH?。

時(shí)間復(fù)雜度:
O(1)。
返回值:
總是返回?OK?。

?

?

連接(Connection)

AUTH

AUTH password

通過設(shè)置配置文件中?requirepass?項(xiàng)的值(使用命令?CONFIG?SET?requirepass?password?),可以使用密碼來保護(hù) Redis 服務(wù)器。

如果開啟了密碼保護(hù)的話,在每次連接 Redis 服務(wù)器之后,就要使用?AUTH?命令解鎖,解鎖之后才能使用其他 Redis 命令。

如果?AUTH?命令給定的密碼?password?和配置文件中的密碼相符的話,服務(wù)器會返回?OK?并開始接受命令輸入。

反之,如果密碼不匹配的話,服務(wù)器將返回一個(gè)錯(cuò)誤,并要求客戶端需重新輸入密碼。

?

警告:因?yàn)?Redis 高性能的特點(diǎn),在很短時(shí)間內(nèi)嘗試猜測非常多個(gè)密碼是有可能的,因此請確保使用的密碼足夠復(fù)雜和足夠長,以免遭受密碼猜測攻擊。

時(shí)間復(fù)雜度:
O(1)
返回值:
密碼匹配時(shí)返回?OK?,否則返回一個(gè)錯(cuò)誤。

?

PING

PING

客戶端向服務(wù)器發(fā)送一個(gè)?PING?,然后服務(wù)器返回客戶端一個(gè)?PONG?。

通常用于測試與服務(wù)器的連接是否仍然生效,或者用于測量延遲值。

時(shí)間復(fù)雜度:
O(1)
返回值:
PONG

?

?

SELECT

SELECT index

切換到指定的數(shù)據(jù)庫,數(shù)據(jù)庫索引號用數(shù)字值指定,以?0?作為起始索引值。

新的鏈接總是使用?0?號數(shù)據(jù)庫。

時(shí)間復(fù)雜度:
O(1)
返回值:
OK

?

ECHO

ECHO message

打印一個(gè)特定的信息?message?,測試時(shí)使用。

時(shí)間復(fù)雜度:
O(1)
返回值:
message?自身。

?

?

QUIT

QUIT

請求服務(wù)器關(guān)閉與當(dāng)前客戶端的連接。

一旦所有等待中的回復(fù)(如果有的話)順利寫入到客戶端,連接就會被關(guān)閉。

時(shí)間復(fù)雜度:
O(1)
返回值:
總是返回?OK?(但是不會被打印顯示,因?yàn)楫?dāng)時(shí) Redis-cli 已經(jīng)退出)。

?

?

服務(wù)器(Server)

BGREWRITEAOF

BGREWRITEAOF

異步(Asynchronously)重寫 AOF 文件以反應(yīng)當(dāng)前數(shù)據(jù)庫的狀態(tài)。

即使?BGREWRITEAOF?命令執(zhí)行失敗,舊 AOF 文件中的數(shù)據(jù)也不會因此丟失或改變。

時(shí)間復(fù)雜度:
O(N),?N?為要追加到 AOF 文件中的數(shù)據(jù)數(shù)量。
返回值:
反饋信息。

?

BGSAVE

在后臺異步保存當(dāng)前數(shù)據(jù)庫的數(shù)據(jù)到磁盤。

BGSAVE?命令執(zhí)行之后立即返回?OK?,然后 Redis fork出一個(gè)新子進(jìn)程,原來的 Redis 進(jìn)程(父進(jìn)程)繼續(xù)處理客戶端請求,而子進(jìn)程則負(fù)責(zé)將數(shù)據(jù)保存到磁盤,然后退出。

客戶端可以通過?LASTSAVE?命令查看相關(guān)信息,判斷?BGSAVE?命令是否執(zhí)行成功。

時(shí)間復(fù)雜度:
O(N),?N?為要保存到數(shù)據(jù)庫中的 key 的數(shù)量。
返回值:
反饋信息。

?

SAVE

SAVE

同步保存當(dāng)前數(shù)據(jù)庫的數(shù)據(jù)到磁盤。

時(shí)間復(fù)雜度:
O(N),?N?為要保存到數(shù)據(jù)庫中的 key 的數(shù)量。
返回值:
總是返回?OK?。

?

?

LASTSAVE

LASTSAVE

返回最近一次 Redis 成功執(zhí)行保存操作的時(shí)間點(diǎn)(?SAVE?、?BGSAVE?等),以 UNIX 時(shí)間戳格式表示。

時(shí)間復(fù)雜度:
O(1)
返回值:
一個(gè) UNIX 時(shí)間戳。

?

?

DBSIZE

DBSIZE

返回當(dāng)前數(shù)據(jù)庫的 key 的數(shù)量。

時(shí)間復(fù)雜度:
O(1)
返回值:
當(dāng)前數(shù)據(jù)庫的 key 的數(shù)量。

?

?

SLAVEOF

SLAVEOF host port

SLAVEOF?命令用于在 Redis 運(yùn)行時(shí)動態(tài)地修改復(fù)制(replication)功能的行為。

通過執(zhí)行?SLAVEOF?host?port?命令,可以將當(dāng)前服務(wù)器轉(zhuǎn)變?yōu)橹付ǚ?wù)器的從屬服務(wù)器(slave server)。

如果當(dāng)前服務(wù)器已經(jīng)是某個(gè)主服務(wù)器(master server)的從屬服務(wù)器,那么執(zhí)行?SLAVEOF?host?port?將使當(dāng)前服務(wù)器停止對舊主服務(wù)器的同步,丟棄舊數(shù)據(jù)集,轉(zhuǎn)而開始對新主服務(wù)器進(jìn)行同步。

另外,對一個(gè)從屬服務(wù)器執(zhí)行命令?SLAVEOF?NO?ONE?將使得這個(gè)從屬服務(wù)器關(guān)閉復(fù)制功能,并從從屬服務(wù)器轉(zhuǎn)變回主服務(wù)器,原來同步所得的數(shù)據(jù)集不會被丟棄。

利用“?SLAVEOF?NO?ONE?不會丟棄同步所得數(shù)據(jù)集”這個(gè)特性,可以在主服務(wù)器失敗的時(shí)候,將從屬服務(wù)器用作新的主服務(wù)器,從而實(shí)現(xiàn)無間斷運(yùn)行。

時(shí)間復(fù)雜度:
SLAVEOF?host?port?,O(N),?N?為要同步的數(shù)據(jù)數(shù)量。 SLAVEOF?NO?ONE?, O(1) 。
返回值:
總是返回?OK?。

?

?

FLUSHALL

FLUSHALL

清空整個(gè) Redis 服務(wù)器的數(shù)據(jù)(刪除所有數(shù)據(jù)庫的所有 key)。

此命令從不失敗。

時(shí)間復(fù)雜度:
尚未明確
返回值:
總是返回?OK?。

?

?

FLUSHDB

FLUSHDB

清空當(dāng)前數(shù)據(jù)庫中的所有 key 。

此命令從不失敗。

時(shí)間復(fù)雜度:
O(1)
返回值:
總是返回?OK?。

?

?

SHUTDOWN

SHUTDOWN

SHUTDOWN?命令執(zhí)行以下操作:

  • 停止所有客戶端
  • 如果有最少一個(gè)保存點(diǎn)在等待,執(zhí)行?SAVE?命令
  • 如果 AOF 選項(xiàng)被打開,更新 AOF 文件
  • 服務(wù)器關(guān)閉

如果持久化被打開的話,?SHUTDOWN?命令會保證服務(wù)器正常關(guān)閉而不丟失任何數(shù)據(jù)。

假如只是單純地執(zhí)行?SAVE?命令,然后再執(zhí)行?QUIT?命令,則沒有這一保證 —— 因?yàn)樵趫?zhí)行?SAVE?之后、執(zhí)行?QUIT?之前的這段時(shí)間中間,其他客戶端可能正在和服務(wù)器進(jìn)行通訊,這時(shí)如果執(zhí)行?QUIT?就會造成數(shù)據(jù)丟失。

時(shí)間復(fù)雜度:
不明確
返回值:
執(zhí)行失敗時(shí)返回錯(cuò)誤。 執(zhí)行成功時(shí)不返回任何信息,服務(wù)器和客戶端的連接斷開,客戶端自動退出。

?

?

SLOWLOG

SLOWLOG subcommand [argument]

什么是 SLOWLOG

Slow log 是 Redis 用來記錄查詢執(zhí)行時(shí)間的日志系統(tǒng)。

查詢執(zhí)行時(shí)間指的是不包括像客戶端響應(yīng)(talking)、發(fā)送回復(fù)等 IO 操作,而單單是執(zhí)行一個(gè)查詢命令所耗費(fèi)的時(shí)間。

另外,slow log 保存在內(nèi)存里面,讀寫速度非常快,因此你可以放心地使用它,不必?fù)?dān)心因?yàn)殚_啟 slow log 而損害 Redis 的速度。

設(shè)置 SLOWLOG

Slow log 的行為由兩個(gè)配置參數(shù)(configuration parameter)指定,可以通過改寫 redis.conf 文件或者用?CONFIG?GET?和?CONFIG?SET?命令對它們動態(tài)地進(jìn)行修改。

第一個(gè)選項(xiàng)是?slowlog-log-slower-then?,它決定要對執(zhí)行時(shí)間大于多少微秒(microsecond,1秒 = 1,000,000 微秒)的查詢進(jìn)行記錄。

比如執(zhí)行以下命令將讓 slow log 記錄所有查詢時(shí)間大于等于 100 微秒的查詢:

CONFIG?SET?slowlog-log-slower-then?100?,

而以下命令記錄所有查詢時(shí)間大于 1000 微秒的查詢:

CONFIG?SET?slowlog-log-slower-then?1000?。

另一個(gè)選項(xiàng)是?slowlog-max-len?,它決定 slow log?最多能保存多少條日志, slow log 本身是一個(gè) LIFO 隊(duì)列,當(dāng)隊(duì)列大小超過?slowlog-max-len?時(shí),最舊的一條日志將被刪除,而最新的一條日志加入到 slow log ,以此類推。

以下命令讓 slow log 最多保存 1000 條日志:

CONFIG?SET?slowlog-max-len?1000?。

使用?CONFIG?GET?命令可以查詢兩個(gè)選項(xiàng)的當(dāng)前值:

?

?

查看 slow log

要查看 slow log ,可以使用?SLOWLOG?GET?或者?SLOWLOG?GET?number?命令,前者打印所有 slow log ,最大長度取決于?slowlog-max-len?選項(xiàng)的值,而?SLOWLOG?GET?number?則只打印指定數(shù)量的日志。

最新的日志會最先被打印:

?

?

日志的唯一 id 只有在 Redis 服務(wù)器重啟的時(shí)候才會重置,這樣可以避免對日志的重復(fù)處理(比如你可能會想在每次發(fā)現(xiàn)新的慢查詢時(shí)發(fā)郵件通知你)。

查看當(dāng)前日志的數(shù)量

使用命令?SLOWLOG?LEN?可以查看當(dāng)前日志的數(shù)量。

請注意這個(gè)值和?slower-max-len?的區(qū)別,它們一個(gè)是當(dāng)前日志的數(shù)量,一個(gè)是允許記錄的最大日志的數(shù)量。

?

清空日志

使用命令?SLOWLOG?RESET?可以清空 slow log 。

?

?

時(shí)間復(fù)雜度:O(1)

返回值:取決于不同命令,返回不同的值。

?

INFO

INFO

返回關(guān)于 Redis 服務(wù)器的各種信息和統(tǒng)計(jì)值。

時(shí)間復(fù)雜度:
O(1)
返回值:
具體請參見下面的測試代碼。

?

?

CONFIG GET

CONFIG GET parameter

CONFIG GET?命令用于取得運(yùn)行中的 Redis 服務(wù)器的配置參數(shù)(configuration parameters),不過并非所有配置參數(shù)都被?CONFIG?GET?命令所支持。

CONFIG GET?接受單個(gè)參數(shù)?parameter?作為搜索關(guān)鍵字,查找所有匹配的配置參數(shù),其中參數(shù)和值以“鍵-值對”(key-value pairs)的方式排列。

比如執(zhí)行?CONFIG?GET?s*?命令,服務(wù)器就會返回所有以?s?開頭的配置參數(shù)及參數(shù)的值:

?

?

如果你只是尋找特定的某個(gè)參數(shù)的話,你當(dāng)然也可以直接指定參數(shù)的名字:

?

使用命令?CONFIG?GET?*?,可以列出?CONFIG?GET?命令支持的所有參數(shù):

?

所有被?CONFIG?SET?所支持的配置參數(shù)都可以在配置文件 redis.conf 中找到,不過?CONFIG?GET?和?CONFIG?SET?使用的格式和 redis.conf 文件所使用的格式有以下兩點(diǎn)不同:

  • 10kb?、?2gb?這些在配置文件中所使用的儲存單位縮寫,不可以用在?CONFIG?命令中,?CONFIG?SET?的值只能通過數(shù)字值顯式地設(shè)定。 像?CONFIG?SET?xxx?1k?這樣的命令是錯(cuò)誤的,正確的格式是?CONFIG?SET?xxx?1000?。
  • save?選項(xiàng)在 redis.conf 中是用多行文字儲存的,但在?CONFIG?GET?命令中,它只打印一行文字。 以下是?save?選項(xiàng)在 redis.conf 文件中的表示: save?900?1 save?300?10 save?60?10000 但是?CONFIG?GET?命令的輸出只有一行: redis>?CONFIG?GET?save 1)?"save" 2)?"900?1?300?10?60?10000" 上面?save?參數(shù)的三個(gè)值表示:在 900 秒內(nèi)最少有 1 個(gè) key 被改動,或者 300 秒內(nèi)最少有 10 個(gè) key 被改動,又或者 60 秒內(nèi)最少有 1000 個(gè) key 被改動,以上三個(gè)條件隨便滿足一個(gè),就觸發(fā)一次保存操作。
時(shí)間復(fù)雜度:
不明確
返回值:
給定配置參數(shù)的值。

?

CONFIG SET

CONFIG SET parameter value

CONFIG SET?命令可以動態(tài)地調(diào)整 Redis 服務(wù)器的配置(configuration)而無須重啟。

你可以使用它修改配置參數(shù),或者改變 Redis 的持久化(Persistence)方式。

CONFIG SET?可以修改的配置參數(shù)可以使用命令?CONFIG?GET?*?來列出,所有被?CONFIG SET?修改的配置參數(shù)都會立即生效。

關(guān)于?CONFIG SET?命令的更多消息,請參見命令?CONFIG GET?的說明。

關(guān)于如何使用?CONFIG SET?命令修改 Redis 持久化方式,請參見?Redis Persistence?。

時(shí)間復(fù)雜度:
不明確
返回值:
當(dāng)設(shè)置成功時(shí)返回?OK?,否則返回一個(gè)錯(cuò)誤。

?

CONFIG RESETSTAT

CONFIG RESETSTAT

重置?INFO?命令中的某些統(tǒng)計(jì)數(shù)據(jù),包括:

  • Keyspace hits (鍵空間命中次數(shù))
  • Keyspace misses (鍵空間不命中次數(shù))
  • Number of commands processed (執(zhí)行命令的次數(shù))
  • Number of connections received (連接服務(wù)器的次數(shù))
  • Number of expired keys (過期key的數(shù)量)
時(shí)間復(fù)雜度:
O(1)
返回值:
總是返回?OK?。

?

DEBUG OBJECT

DEBUG OBJECT key

返回給定?key?的調(diào)試信息。

時(shí)間復(fù)雜度:
O(1)
返回值:
當(dāng)?key?存在時(shí),返回有關(guān)信息。 當(dāng)?key?不存在時(shí),返回一個(gè)錯(cuò)誤。

?

DEBUG SEGFAULT

DEBUG SEGFAULT

令 Redis 服務(wù)器崩潰,調(diào)試用。

時(shí)間復(fù)雜度:
不明確
返回值:

?

MONITOR

MONITOR

實(shí)時(shí)打印出 Redis 服務(wù)器接收到的命令,調(diào)試用。

時(shí)間復(fù)雜度:
不明確
返回值:
總是返回?OK?。

?

SYNC

YNC

用于復(fù)制功能(replication)的內(nèi)部命令。

時(shí)間復(fù)雜度:
不明確
返回值:
不明確

轉(zhuǎn)載于:https://www.cnblogs.com/zcy_soft/archive/2012/09/21/2697006.html

總結(jié)

以上是生活随笔為你收集整理的phpredis中文手册——《redis中文手册》 php版的全部內(nèi)容,希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網(wǎng)站內(nèi)容還不錯(cuò),歡迎將生活随笔推薦給好友。

主站蜘蛛池模板: 国产成人自拍在线 | 一区二区日韩欧美 | 国产成人精品午夜福利Av免费 | 在线免费av网 | 日批小视频 | 无码人妻精品一区二区三区不卡 | 性猛交富婆╳xxx乱大交天津 | 久久久国| 高清中文字幕av | 亚洲黄色片免费看 | 一区二区少妇 | 欧美色欧美 | 人妻饥渴偷公乱中文字幕 | 夜av| 午夜激情福利 | 色爱五月天 | 久久久久久九九九九九 | 99国产热| 色偷偷人人澡人人爽人人模 | 日韩在线免费观看视频 | 黄色大片91 | 亚洲视屏在线观看 | 伊人影视久久 | 手机在线永久免费观看av片 | 手机看片日韩久久 | 精品无码一区二区三区 | 97久久国产亚洲精品超碰热 | 丁香六月色婷婷 | 国产xx在线观看 | 999免费| a√天堂网 | 丰满人妻熟妇乱偷人无码 | 熟妇一区二区三区 | 老外毛片 | 欧洲精品一区 | 国产xxx视频 | 麻豆成人免费 | 色婷av| 亚洲精品视频91 | 日韩一级免费观看 | 国产日本欧美在线观看 | 海角社区id:1220.7126,10. | 欧美三极片 | 日本va在线观看 | 国产老熟女一区二区三区 | 在线视频日本 | 老司机久久 | 欧美精品成人一区二区在线观看 | 欧美一级性生活 | 亚洲免费一区视频 | 国产精品久久久久久久久借妻 | 性欧美丰满熟妇xxxx性 | 四川丰满妇女毛片四川话 | 1769国产精品视频 | 日韩美女黄色片 | 蜜臀网在线 | 日本嫩草影院 | 国模二区 | 久久免费精品国产 | 欧美 国产 综合 | 久久久久久久久免费看无码 | 欧美中文字幕一区二区三区 | 婷婷在线视频观看 | 免费一级特黄特色大片 | 日韩aa视频 | 美女又爽又黄免费视频 | 国产第一草草影院 | 免费黄色资源 | 久久综合中文字幕 | 久久网国产 | 色射色| 成人快色| 欧美日韩黄色一区二区 | 午夜影视体验区 | 99re色| 手机看片一区二区三区 | 日韩成人不卡 | 老牛影视少妇在线观看 | 在线视频日韩精品 | 韩国三级做爰高潮 | 风流老熟女一区二区三区 | 精品97人妻无码中文永久在线 | 9191av| 国产区在线观看视频 | 色哟哟精品一区 | 天堂视频在线免费观看 | www.精品在线| 91精品黄色 | 手机看片在线观看 | 久久婷婷五月综合 | 免费黄色小视频 | 亚洲一区二区免费在线观看 | 女人下面无遮挡 | 国产高潮流白浆喷水视频 | 国产网站精品 | 精品视频91 | www视频在线观看网站 | 中文字幕一区二区三区四区不卡 | 天天干天天干天天干天天 |