本文是参考《redis中文手册》，将示例代码用php来实现，注意php-redis与redis_cli的区别（主要是返回值类型和参数用法）。

redis中文手册下载地址：

redis中文在线手册：

目录(使用CTRL+F快速查找命令)：

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

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

为给定key设置生存时间。

当key过期时，它会被自动删除。

在Redis中，带有生存时间的key被称作“易失的”(volatile)。

OBJECT命令允许从内部察看给定key的Redis对象。

它通常用在除错(debugging)或者了解为了节省空间而对key使用特殊编码的情况。

OBJECT命令有多个子命令：

• 没有被读取也没有被写入)，以秒为单位。

对象可以以多种方式编码：

• 字符串可以被编码为raw(一般字符串)或int(用字符串表示64位数字是为了节约空间)。

• 列表可以被编码为ziplist或linkedlist。ziplist是为节约大小较小的列表空间而作的特殊表示。

• 集合可以被编码为intset或者hashtable。intset是只储存数字的小集合的特殊表示。

• 哈希表可以编码为zipmap或者hashtable。zipmap是小哈希表的特殊表示。

• 有序集合可以被编码为ziplist或者skiplist格式。ziplist用于表示小的有序集合，而skiplist则用于表示任何大小的有序集合。

假如你做了什么让Redis没办法再使用节省空间的编码时(比如将一个只有1个元素的集合扩展为一个有100万个元素的集合)，特殊编码类型(specially encoded types)会自动转换成通用类型(general type)。

• ENCODING返回相应的编码类型。

移除给定key的生存时间。

• 当生存时间移除成功时，返回1.

  如果key不存在或key没有设置生存时间，返回0。

排序之后返回的元素数量可以通过LIMIT修饰符进行限制。

offset指定要跳过的元素数量，count指定跳过offset个指定的元素之后，要返回多少个对象。

以下例子返回排序结果的前5个对象(offset为0表示没有元素被跳过)。

修饰符可以组合使用。以下例子返回降序(从大到小)的前5个对象。

使用外部key进行排序

有时候你会希望使用外部的key作为权重来比较元素，代替默认的对比方法。

假设现在有用户(user)数据如下：

如果希望按level从大到小排序user_id，可以使用以下命令：

但是有时候只是返回相应的id没有什么用，你可能更希望排序后返回id对应的用户名，这样更友好一点，使用GET选项可以做到这一点：

可以多次地、有序地使用GET操作来获取更多外部key。

比如你不但希望获取用户名，还希望连用户的密码也一并列出，可以使用以下命令：

GET还有一个特殊的规则——"GET #"，用于获取被排序对象(我们这里的例子是user_id)的当前元素。

BY修饰符可以将一个不存在的key当作权重，让SORT跳过排序操作。

该方法用于你希望获取外部对象而又不希望引起排序开销时使用。

默认情况下，SORT操作只是简单地返回排序结果，如果你希望保存排序结果，可以给STORE选项指定一个key作为参数，排序结果将以列表的形式被保存到这个key上。(若指定key已存在，则覆盖。)

一个有趣的用法是将SORT结果保存，用EXPIRE为结果集设置生存时间，这样结果集就成了SORT操作的一个缓存。

这样就不必频繁地调用SORT操作了，只有当结果集过期时，才需要再调用一次SORT操作。

有时候为了正确实现这一用法，你可能需要加锁以避免多个客户端同时进行缓存重建(也就是多个客户端，同一时间进行SORT操作，并保存为结果集)，具体参见SETNX命令。

在GET和BY中使用哈希表

可以使用哈希表特有的语法，在SORT命令中进行GET和BY操作。

除此之外，哈希表的BY和GET操作和上面介绍的其他数据结构(列表、集合、有序集合)没有什么不同。

• O(N+M*log(M))，N为要排序的列表或集合内的元素数量，M为要返回的元素数量。

  如果只是使用SORT命令的GET选项获取数据而没有进行排序，时间复杂度O(N)。

• 没有使用STORE参数，返回列表形式的排序结果。

  使用STORE参数，返回排序结果的元素数量。

将字符串值value关联到key。

如果key已经持有其他值，SET就覆写旧值，无视类型。

时间复杂度：O(1)返回值：总是返回OK(TRUE)，因为SET不可能失败。

将key的值设为value，当且仅当key不存在。

若给定的key已经存在，则SETNX不做任何动作。

SETNX可以用作加锁原语(locking primitive)。比如说，要对关键字(key)foo加锁，客户端可以尝试以下方式：

返回key中字符串值的子字符串，字符串的截取范围由start和end两个偏移量决定(包括start和end在内)。

负数偏移量表示从字符串最后开始计数，-1表示最后一个字符，-2表示倒数第二个，以此类推。

GETRANGE通过保证子字符串的值域(range)不超过实际字符串的值域来处理超出范围的值域请求。

• O(N)，N为要返回的字符串的长度。

  复杂度最终由返回值长度决定，但因为从已有字符串中建立子字符串的操作非常廉价(cheap)，所以对于长度不大的字符串，该操作的复杂度也可看作O(1)。

举例来说，每次当某个事件发生时，进程可能对一个名为mycount的key调用INCR操作，通常我们还要在一个原子时间内同时完成获得计数器的值和将计数器值复位为0两个操作。

返回key所储存的字符串值的长度。

当key储存的不是字符串值时，返回一个错误。

• 当 key不存在时，返回0。

将key中储存的数字值增一。

如果key不存在，以0为key的初始值，然后执行INCR操作。

如果值包含错误的类型，或字符串类型的值不能表示为数字，那么返回一个错误。

本操作的值限制在64位(bit)有符号数字表示之内。

• 执行INCR命令之后key的值。

注解:这是一个针对字符串的操作，因为Redis没有专用的整数类型，所以key内储存的字符串被解释为十进制64位有符号整数来执行INCR操作。

如果key不存在，以0为key的初始值，然后执行INCRBY命令。

如果值包含错误的类型，或字符串类型的值不能表示为数字，那么返回一个错误。

本操作的值限制在64位(bit)有符号数字表示之内。

将key中储存的数字值减一。

如果key不存在，以0为key的初始值，然后执行DECR操作。

如果值包含错误的类型，或字符串类型的值不能表示为数字，那么返回一个错误。

本操作的值限制在64位(bit)有符号数字表示之内。

• 执行DECR命令之后key的值。

如果key不存在，以0为key的初始值，然后执行DECRBY操作。

如果值包含错误的类型，或字符串类型的值不能表示为数字，那么返回一个错误。

本操作的值限制在64位(bit)有符号数字表示之内。

对key所储存的字符串值，设置或清除指定偏移量上的位(bit)。

位的设置或清除取决于value参数，可以是0也可以是1。

当key不存在时，自动生成一个新的字符串值。

字符串会增长(grown)以确保它可以将value保存在指定的偏移量上。当字符串值增长时，空白位置以0填充。

• 指定偏移量原来储存的位（"0"或"1"）.

警告:对使用大的offset的SETBIT操作来说，内存分配可能造成Redis服务器被阻塞。具体参考SETRANGE命令，warning(警告)部分。

对key所储存的字符串值，获取指定偏移量上的位(bit)。

当offset比字符串值的长度大，或者key不存在时，返回0。

• 字符串值指定偏移量上的位(bit)。

如果key不存在，一个新的哈希表被创建并进行HSET操作。

如果域field已经存在于哈希表中，旧值将被覆盖。

• 如果field是哈希表中的一个新建域，并且值设置成功，返回1。

  如果哈希表中域field已经存在且旧值已被新值覆盖，返回0。

将哈希表key中的域field的值设置为value，当且仅当域field不存在。

若域field已经存在，该操作无效。

如果key不存在，一个新哈希表被创建并执行HSETNX命令。

• 如果给定域已经存在且没有操作被执行，返回0。

此命令会覆盖哈希表中已存在的域。

如果key不存在，一个空哈希表被创建并执行HMSET操作。

• 如果命令执行成功，返回OK。

  当key不是哈希表(hash)类型时，返回一个错误。

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

• 当给定域不存在或是给定key不存在时，返回nil。

返回哈希表key中，一个或多个给定域的值。

如果给定的域不存在于哈希表，那么返回一个nil值。

因为不存在的key被当作一个空哈希表来处理，所以对一个不存在的key进行HMGET操作将返回一个只带有nil值的表。

• O(N)，N为给定域的数量。

• 一个包含多个给定域的关联值的表，表值的排列顺序和给定域参数的请求顺序一样。

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

在返回值里，紧跟每个域名(field name)之后是域的值(value)，所以返回值的长度是哈希表大小的两倍。

• O(N)，N为哈希表的大小。

• 以列表形式返回哈希表的域和域的值。 若key不存在，返回空列表。

删除哈希表key中的一个或多个指定域，不存在的域将被忽略。

• O(N)，N为要删除的域的数量。

• 被成功移除的域的数量，不包括被忽略的域。

注解:在Redis2.4以下的版本里，HDEL每次只能删除单个域，如果你需要在一个原子时间内删除多个域，请将命令包含在MULTI/ EXEC块内。

返回哈希表key中域的数量。

• 当key不存在时，返回0。

查看哈希表key中，给定域field是否存在。

• 如果哈希表含有给定域，返回1。

  如果哈希表不含有给定域，或key不存在，返回0。

增量也可以为负数，相当于对给定域进行减法操作。

如果key不存在，一个新的哈希表被创建并执行HINCRBY命令。

如果域field不存在，那么在执行命令前，域的值被初始化为0。

对一个储存字符串值的域field执行HINCRBY命令将造成一个错误。

本操作的值限制在64位(bit)有符号数字表示之内。

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

• O(N)，N为哈希表的大小。

• 一个包含哈希表中所有域的表。

  当key不存在时，返回一个空表。

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

• O(N)，N为哈希表的大小。

• 一个包含哈希表中所有值的表。

  当key不存在时，返回一个空表。

头元素指的是列表左端/前端第一个元素，尾元素指的是列表右端/后端第一个元素。

举个例子，列表list包含三个元素：x, y, z，其中x是头元素，而z则是尾元素。

指不包含任何元素的列表，Redis将不存在的key也视为空列表。

将一个或多个值value插入到列表key的表头。

如果有多个value值，那么各个value值按从左到右的顺序依次插入到表头：比如对一个空列表(mylist)执行LPUSH mylist a b c，则结果列表为c b a，等同于执行执行命令LPUSH

如果key不存在，一个空列表会被创建并执行LPUSH操作。

当key存在但不是列表类型时，返回一个错误。

• 执行LPUSH命令后，列表的长度。

将值value插入到列表key的表头，当且仅当key存在并且是一个列表。

和LPUSH命令相反，当key不存在时，LPUSHX命令什么也不做。

• LPUSHX命令执行之后，表的长度。

将一个或多个值value插入到列表key的表尾。

如果有多个value值，那么各个value值按从左到右的顺序依次插入到表尾：比如对一个空列表(mylist)执行RPUSH mylist a b

如果key不存在，一个空列表会被创建并执行RPUSH操作。

当key存在但不是列表类型时，返回一个错误。

• 执行RPUSH操作后，表的长度。

将值value插入到列表key的表尾，当且仅当key存在并且是一个列表。

和RPUSH命令相反，当key不存在时，RPUSHX命令什么也不做。

• RPUSHX命令执行之后，表的长度。

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

• 当key不存在时，返回nil。

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

• 当key不存在时，返回nil。

它是LPOP命令的阻塞版本，当给定列表内没有任何元素可供弹出的时候，连接将被BLPOP命令阻塞，直到等待超时或发现可弹出元素为止。

当给定多个key参数时，按参数key的先后顺序依次检查各个列表，弹出第一个非空列表的头元素。

当BLPOP被调用时，如果给定key内至少有一个非空列表，那么弹出遇到的第一个非空列表的头元素，并和被弹出元素所属的列表的名字一起，组成结果返回给调用者。

当存在多个给定key时，BLPOP按给定key参数排列的先后顺序，依次检查各个列表。

如果所有给定key都不存在或包含空列表，那么BLPOP命令将阻塞连接，直到等待超时，或有另一个客户端对给定key的任意一个执行LPUSH或RPUSH命令为止。

超时参数timeout接受一个以秒为单位的数字作为值。超时参数设为0表示阻塞时间可以无限期延长(block indefinitely) 。

相同的key被多个客户端同时阻塞

相同的key可以被多个客户端同时阻塞。

不同的客户端被放进一个队列中，按”先阻塞先服务”(first-BLPOP，first-served)的顺序为key执行BLPOP命令。

BLPOP可以用于流水线(pipline,批量地发送多个命令并读入多个回复)，但把它用在MULTI/EXEC块当中没有意义。因为这要求整个服务器被阻塞以保证块执行时的原子性，该行为阻止了其他客户端执行LPUSH或RPUSH命令。

因此，一个被包裹在MULTI/EXEC块内的BLPOP命令，行为表现得就像LPOP一样，对空列表返回nil，对非空列表弹出列表元素，不进行任何阻塞操作。

时间复杂度：O(1)返回值：

如果列表为空，返回一个nil。

反之，返回一个含有两个元素的列表，第一个元素是被弹出元素所属的key，第二个元素是被弹出元素的值。

它是RPOP命令的阻塞版本，当给定列表内没有任何元素可供弹出的时候，连接将被BRPOP命令阻塞，直到等待超时或发现可弹出元素为止。

当给定多个key参数时，按参数key的先后顺序依次检查各个列表，弹出第一个非空列表的尾部元素。

关于阻塞操作的更多信息，请查看BLPOP命令，BRPOP除了弹出元素的位置和BLPOP不同之外，其他表现一致。

• 假如在指定时间内没有任何元素被弹出，则返回一个nil和等待时长。

  反之，返回一个含有两个元素的列表，第一个元素是被弹出元素所属的key，第二个元素是被弹出元素的值。

返回列表key的长度。

如果key不存在，则key被解释为一个空列表，返回0.

如果key不是列表类型，返回一个错误。

返回列表key中指定区间内的元素，区间以偏移量start和stop指定。

下标(index)参数start和stop都以0为底，也就是说，以0表示列表的第一个元素，以1表示列表的第二个元素，以此类推。

你也可以使用负数下标，以-1表示列表的最后一个元素，-2表示列表的倒数第二个元素，以此类推。

注意LRANGE命令和编程语言区间函数的区别

假如你有一个包含一百个元素的列表，对该列表执行LRANGE list 0 10，结果是一个包含11个元素的列表，这表明stop下标也在LRANGE命令的取值范围之内(闭区间)，这和某些语言的区间函数可能不一致，比如Ruby的Range.new、Array#slice和Python的range()函数。

超出范围的下标值不会引起错误。

• O(S+N)，S为偏移量start，N为指定区间内元素的数量。

• 一个列表，包含指定区间内的元素。

根据参数count的值，移除列表中与参数value相等的元素。

• count的值可以是以下几种：

• count < 0: 从表尾开始向表头搜索，移除与value相等的元素，数量为count的绝对值。

• O(N)，N为列表的长度。

• 因为不存在的key被视作空表(empty list)，所以当key不存在时，LREM命令总是返回0。

将列表key下标为index的元素的值甚至为value。

更多信息请参考LINDEX操作。

当index参数超出范围，或对一个空列表(key不存在)进行LSET时，返回一个错误。

• 对头元素或尾元素进行LSET操作，复杂度为O(1)。

  其他情况下，为O(N)，N为列表的长度。

• 操作成功返回ok，否则返回错误信息

对一个列表进行修剪(trim)，就是说，让列表只保留指定区间内的元素，不在指定区间之内的元素都将被删除。

举个例子，执行命令LTRIM list 0 2，表示只保留列表list的前三个元素，其余元素全部删除。

下标(index)参数start和stop都以0为底，也就是说，以0表示列表的第一个元素，以1表示列表的第二个元素，以此类推。

你也可以使用负数下标，以-1表示列表的最后一个元素，-2表示列表的倒数第二个元素，以此类推。

当key不是列表类型时，返回一个错误。

LTRIM命令通常和LPUSH命令或RPUSH命令配合使用，举个例子：

这个例子模拟了一个日志程序，每次将最新日志newest_log放到log列表中，并且只保留最新的100项。注意当这样使用LTRIM命令时，时间复杂度是O(1)，因为平均情况下，每次只有一个元素被移除。

注意LTRIM命令和编程语言区间函数的区别

假如你有一个包含一百个元素的列表list，对该列表执行LTRIM list 0 10，结果是一个包含11个元素的列表，这表明stop下标也在LTRIM命令的取值范围之内(闭区间)，这和某些语言的区间函数可能不一致，比如Ruby的Range.new、Array#slice和Python的range()函数。

超出范围的下标值不会引起错误。

stop，LTRIM返回一个空列表(因为LTRIM已经将整个列表清空)。

• O(N)，N为被移除的元素的数量。

• 命令执行成功时，返回ok。

返回列表key中，下标为index的元素。

下标(index)参数start和stop都以0为底，也就是说，以0表示列表的第一个元素，以1表示列表的第二个元素，以此类推。

你也可以使用负数下标，以-1表示列表的最后一个元素，-2表示列表的倒数第二个元素，以此类推。

如果key不是列表类型，返回一个错误。

• O(N)，N为到达下标index过程中经过的元素数量。

  因此，对列表的头元素和尾元素执行LINDEX命令，复杂度为O(1)。

• 列表中下标为index的元素。

将值value插入到列表key当中，位于值pivot之前或之后。

当pivot不存在于列表key时，不执行任何操作。

当key不存在时，key被视为空列表，不执行任何操作。

如果key不是列表类型，返回一个错误。

• O(N)，N为寻找pivot过程中经过的元素数量。

• 如果命令执行成功，返回插入操作完成之后，列表的长度。

  如果没有找到pivot，返回-1。

  如果key不存在或为空列表，返回0。

命令RPOPLPUSH在一个原子时间内，执行以下两个动作：

• 将列表source中的最后一个元素(尾元素)弹出，并返回给客户端。

如果source不存在，值nil被返回，并且不执行其他动作。

如果source和destination相同，则列表中的表尾元素被移动到表头，并返回该元素，可以把这种特殊情况视作列表的旋转(rotation)操作。

设计模式： 一个安全的队列

Redis的列表经常被用作队列(queue)，用于在不同程序之间有序地交换消息(message)。一个程序(称之为生产者，producer)通过LPUSH命令将消息放入队列中，而另一个程序(称之为消费者，consumer)通过RPOP命令取出队列中等待时间最长的消息。

不幸的是，在这个过程中，一个消费者可能在获得一个消息之后崩溃，而未执行完成的消息也因此丢失。

使用RPOPLPUSH命令可以解决这个问题，因为它在返回一个消息之余，还将该消息添加到另一个列表当中，另外的这个列表可以用作消息的备份表：假如一切正常，当消费者完成该消息的处理之后，可以用LREM命令将该消息从备份表删除。

另一方面，助手(helper)程序可以通过监视备份表，将超过一定处理时限的消息重新放入队列中去(负责处理该消息的消费者可能已经崩溃)，这样就不会丢失任何消息了。

当列表source为空时，BRPOPLPUSH命令将阻塞连接，直到等待超时，或有另一个客户端对source执行LPUSH或RPUSH命令为止。

超时参数timeout接受一个以秒为单位的数字作为值。超时参数设为0表示阻塞时间可以无限期延长(block indefinitely) 。

更多相关信息，请参考RPOPLPUSH命令。

• 假如在指定时间内没有任何元素被弹出，则返回一个nil和等待时长。

  反之，返回一个含有两个元素的列表，第一个元素是被弹出元素的值，第二个元素是等待时长。

inter(x, y): 交集，在集合x和集合y中都存在的元素。
union(x, y): 并集，在集合x中或集合y中的元素，如果一个元素在x和y中都出现，那只记录一次即可。
diff(x, y): 差集，在集合x中而不在集合y中的元素。
card(x): 基数，一个集合中元素的数量。
空集： 基数为0的集合。

将一个或多个member元素加入到集合key当中，已经存在于集合的member元素将被忽略。

假如key不存在，则创建一个只包含member元素作成员的集合。

当key不是集合类型时，返回一个错误。

• O(N)，N是被添加的元素的数量。

• 被添加到集合中的新元素的数量，不包括被忽略的元素。

移除集合key中的一个或多个member元素，不存在的member元素会被忽略。

当key不是集合类型，返回一个错误。

• 被成功移除的元素的数量，不包括被忽略的元素。

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

• O(N)，N为集合的基数。

判断member元素是否是集合key的成员。

• 如果member元素是集合的成员，返回1。

  如果member元素不是集合的成员，或key不存在，返回0。

返回集合key的基数(集合中元素的数量)。

• 当key不存在时，返回0。

SMOVE是原子性操作。

如果source集合不存在或不包含指定的member元素，则SMOVE命令不执行任何操作，仅返回0。否则，member元素从source集合中被移除，并添加到destination集合中去。

• 如果member元素被成功移除，返回1。

  如果member元素不是source集合的成员，并且没有任何操作对destination集合执行，那么返回0。

移除并返回集合中的一个随机元素。

• 当key不存在或key是空集时，返回nil。

也可以参考:如果只想获取一个随机元素，但不想该元素从集合中被移除的话，可以使用SRANDMEMBER命令。

返回集合中的一个随机元素。

该操作和SPOP相似，但SPOP将随机元素从集合中移除并返回，而SRANDMEMBER则仅仅返回随机元素，而不对集合进行任何改动。

• 被选中的随机元素。 当key不存在或key是空集时，返回nil。

返回一个集合的全部成员，该集合是所有给定集合的交集。

不存在的key被视为空集。

当给定集合当中有一个空集时，结果也为空集(根据集合运算定律)。

• O(N * M)，N为给定集合当中基数最小的集合，M为给定集合的个数。

此命令等同于SINTER，但它将结果保存到destination集合，而不是简单地返回结果集。

如果destination集合已经存在，则将其覆盖。

• O(N * M)，N为给定集合当中基数最小的集合，M为给定集合的个数。

返回一个集合的全部成员，该集合是所有给定集合的并集。

不存在的key被视为空集。

• O(N)，N是所有给定集合的成员数量之和。

此命令等同于SUNION，但它将结果保存到destination集合，而不是简单地返回结果集。

如果destination已经存在，则将其覆盖。

• O(N)，N是所有给定集合的成员数量之和。

返回一个集合的全部成员，该集合是所有给定集合的差集 。

不存在的key被视为空集。

• O(N)，N是所有给定集合的成员数量之和。

此命令等同于SDIFF，但它将结果保存到destination集合，而不是简单地返回结果集。

如果destination集合已经存在，则将其覆盖。

• O(N)，N是所有给定集合的成员数量之和。

将一个或多个member元素及其score值加入到有序集key当中。

如果某个member已经是有序集的成员，那么更新这个member的score值，并通过重新插入这个member元素，来保证该member在正确的位置上。

score值可以是整数值或双精度浮点数。

如果key不存在，则创建一个空的有序集并执行ZADD操作。

当key存在但不是有序集类型时，返回一个错误。

对有序集的更多介绍请参见sorted set。

• O(M*log(N))，N是有序集的基数，M为成功添加的新成员的数量。

• 被成功添加的新成员的数量，不包括那些被更新的、已经存在的成员。

注解:在Redis2.4版本以前，ZADD每次只能添加一个元素。

移除有序集key中的一个或多个成员，不存在的成员将被忽略。

当key存在但不是有序集类型时，返回一个错误。

• O(M*log(N))，N为有序集的基数，M为被成功移除的成员的数量。

• 被成功移除的成员的数量，不包括被忽略的成员。

注解：在Redis2.4版本以前，ZREM每次只能删除一个元素。

返回有序集key的基数。

• 当key存在且是有序集类型时，返回有序集的基数。

  当key不存在时，返回0。

• O(log(N)+M)，N为有序集的基数，M为值在min和max之间的元素的数量。

• score值在min和max之间的成员的数量。

如果member元素不是有序集key的成员，或key不存在，返回nil。

• member成员的score值，以字符串形式表示。

当key不是有序集类型时，返回一个错误。

score值可以是整数值或双精度浮点数。

• member成员的新score值，以字符串形式表示。

返回有序集key中，指定区间内的成员。

其中成员的位置按score值递增(从小到大)来排序。

如果你需要成员按score值递减(从大到小)来排列，请使用ZREVRANGE命令。

下标参数start和stop都以0为底，也就是说，以0表示有序集第一个成员，以1表示有序集第二个成员，以此类推。

你也可以使用负数下标，以-1表示最后一个成员，-2表示倒数第二个成员，以此类推。

超出范围的下标并不会引起错误。

比如说，当start的值比有序集的最大下标还要大，或是start > stop时，ZRANGE命令只是简单地返回一个空列表。

另一方面，假如stop参数的值比有序集的最大下标还要大，那么Redis将stop当作最大下标来处理。

客户端库可能会返回一些更复杂的数据类型，比如数组、元组等。

• O(log(N)+M)，N为有序集的基数，而M为结果集的基数。

• 指定区间内，带有score值(可选)的有序集成员的列表。

返回有序集key中，指定区间内的成员。

其中成员的位置按score值递减(从大到小)来排列。

除了成员按score值递减的次序排列这一点外，ZREVRANGE命令的其他方面和ZRANGE命令一样。

• O(log(N)+M)，N为有序集的基数，而M为结果集的基数。

• 指定区间内，带有score值(可选)的有序集成员的列表。

返回有序集key中，所有score值介于min和max之间(包括等于min或max)的成员。有序集成员按score值递增(从小到大)次序排列。

具有相同score值的成员按字典序(lexicographical order)来排列(该属性是有序集提供的，不需要额外的计算)。

count)，注意当offset很大时，定位offset的操作可能需要遍历整个有序集，此过程最坏复杂度为O(N)时间。

可选的WITHSCORES参数决定结果集是单单返回有序集的成员，还是将有序集成员及其score值一起返回。

该选项自Redis 2.0版本起可用。

min和max可以是-inf和+inf，这样一来，你就可以在不知道有序集的最低和最高score值的情况下，使用ZRANGEBYSCORE这类命令。

默认情况下，区间的取值使用闭区间(小于等于或大于等于)，你也可以通过给参数前增加(符号来使用可选的开区间(小于或大于)。

• O(log(N)+M)，N为有序集的基数，M为被结果集的基数。

• 指定区间内，带有score值(可选)的有序集成员的列表。

返回有序集key中，score值介于max和min之间(默认包括等于max或min)的所有的成员。有序集成员按score值递减(从大到小)的次序排列。

• O(log(N)+M)，N为有序集的基数，M为结果集的基数。

• 指定区间内，带有score值(可选)的有序集成员的列表。

返回有序集key中成员member的排名。其中有序集成员按score值递增(从小到大)顺序排列。

排名以0为底，也就是说，score值最小的成员排名为0。

使用ZREVRANK命令可以获得成员按score值递减(从大到小)排列的排名。

• 如果member是有序集key的成员，返回member的排名。

  如果member不是有序集key的成员，返回nil。

返回有序集key中成员member的排名。其中有序集成员按score值递减(从大到小)排序。

排名以0为底，也就是说，score值最大的成员排名为0。

使用ZRANK命令可以获得成员按score值递增(从小到大)排列的排名。

• 如果member是有序集key的成员，返回member的排名。

  如果member不是有序集key的成员，返回nil。

移除有序集key中，指定排名(rank)区间内的所有成员。

区间分别以下标参数start和stop指出，包含start和stop在内。

下标参数start和stop都以0为底，也就是说，以0表示有序集第一个成员，以1表示有序集第二个成员，以此类推。

你也可以使用负数下标，以-1表示最后一个成员，-2表示倒数第二个成员，以此类推。

• O(log(N)+M)，N为有序集的基数，而M为被移除成员的数量。

移除有序集key中，所有score值介于min和max之间(包括等于min或max)的成员。

自版本2.1.6开始，score值等于min或max的成员也可以不包括在内，详情请参见ZRANGEBYSCORE命令。

• O(log(N)+M)，N为有序集的基数，而M为被移除成员的数量。

计算给定的一个或多个有序集的交集，其中给定key的数量必须以numkeys参数指定，并将该交集(结果集)储存到destination。

默认情况下，结果集中某个成员的score值是所有给定集下该成员score值之和。

• O(N*K)+O(M*log(M))，N为给定key中基数最小的有序集，K为给定有序集的数量，M为结果集的基数。

计算给定的一个或多个有序集的并集，其中给定key的数量必须以numkeys参数指定，并将该并集(结果集)储存到destination。

默认情况下，结果集中某个成员的score值是所有给定集下该成员score值之和。

使用WEIGHTS选项，你可以为每个给定有序集分别指定一个乘法因子(multiplication factor)，每个给定有序集的所有成员的score值在传递给聚合函数(aggregation function)之前都要先乘以该有序集的因子。

如果没有指定WEIGHTS选项，乘法因子默认设置为1。

使用AGGREGATE选项，你可以指定并集的结果集的聚合方式。

默认使用的参数SUM，可以将所有集合中某个成员的score值之和作为结果集中该成员的score值；使用参数MIN，可以将所有集合中某个成员的最小score值作为结果集中该成员的score值；而参数MAX则是将所有集合中某个成员的最大score值作为结果集中该成员的score值。

• O(N)+O(M log(M))，N为给定有序集基数的总和，M为结果集的基数。

• 接收到信息 message 的订阅者数量。

• O(N)，其中 N 是订阅的频道的数量。

• 接收到的信息(请参见下面的代码说明)。

订阅符合给定模式的频道。

• O(N)， N 是订阅的模式的数量。

• 接收到的信息(请参见下面的代码说明)。

警告:此命令在新版 Redis 中似乎已经被废弃？

警告:此命令在新版 Redis 中似乎已经被废弃？

监视一个(或多个) key ，如果在事务执行之前这个(或这些) key 被其他命令所改动，那么事务将被打断。

如果在执行 WATCH 命令之后， EXEC 命令或 DISCARD 命令先被执行了的话，那么就不需要再执行 UNWATCH 了。

因为 EXEC 命令会执行事务，因此 WATCH 命令的效果已经产生了；而 DISCARD 命令在取消事务的同时也会取消所有对 key 的监视，因此这两个命令执行之后，就没有必要执行 UNWATCH 了。

标记一个事务块的开始。

事务块内的多条命令会按照先后顺序被放进一个队列当中，最后由 EXEC 命令在一个原子时间内执行。

执行所有事务块内的命令。

假如某个(或某些) key 正处于 WATCH 命令的监视之下，且事务块中有和这个(或这些) key 相关的命令，那么 EXEC 命令只在这个(或这些) key 没有被其他命令所改动的情况下执行并生效，否则该事务被打断(abort)。

• 事务块内所有命令的时间复杂度的总和。

• 事务块内所有命令的返回值，按命令执行的先后顺序排列。

  当操作被打断时，返回空值 nil 。

取消事务，放弃执行事务块内的所有命令。

如果正在使用 WATCH 命令监视某个(或某些) key ，那么取消所有监视，等同于执行命令 UNWATCH 。

如果开启了密码保护的话，在每次连接 Redis 服务器之后，就要使用 AUTH 命令解锁，解锁之后才能使用其他 Redis 命令。

如果 AUTH 命令给定的密码 password 和配置文件中的密码相符的话，服务器会返回 OK 并开始接受命令输入。

反之，如果密码不匹配的话，服务器将返回一个错误，并要求客户端需重新输入密码。

警告:因为 Redis 高性能的特点，在很短时间内尝试猜测非常多个密码是有可能的，因此请确保使用的密码足够复杂和足够长，以免遭受密码猜测攻击。

• 密码匹配时返回 OK ，否则返回一个错误。

客户端向服务器发送一个 PING ，然后服务器返回客户端一个 PONG 。

通常用于测试与服务器的连接是否仍然生效，或者用于测量延迟值。

切换到指定的数据库，数据库索引号用数字值指定，以 0 作为起始索引值。

新的链接总是使用 0 号数据库。

打印一个特定的信息 message ，测试时使用。

请求服务器关闭与当前客户端的连接。

一旦所有等待中的回复(如果有的话)顺利写入到客户端，连接就会被关闭。

• 总是返回 OK (但是不会被打印显示，因为当时 Redis-cli 已经退出)。

即使 BGREWRITEAOF 命令执行失败，旧 AOF 文件中的数据也不会因此丢失或改变。

• O(N)， N 为要追加到 AOF 文件中的数据数量。

在后台异步保存当前数据库的数据到磁盘。

BGSAVE 命令执行之后立即返回 OK ，然后 Redis fork出一个新子进程，原来的 Redis 进程(父进程)继续处理客户端请求，而子进程则负责将数据保存到磁盘，然后退出。

客户端可以通过 LASTSAVE 命令查看相关信息，判断 BGSAVE 命令是否执行成功。

• O(N)， N 为要保存到数据库中的 key 的数量。

同步保存当前数据库的数据到磁盘。

• O(N)， N 为要保存到数据库中的 key 的数量。

返回最近一次 Redis 成功执行保存操作的时间点( SAVE 、 BGSAVE 等)，以 UNIX 时间戳格式表示。

返回当前数据库的 key 的数量。

• 当前数据库的 key 的数量。

如果当前服务器已经是某个主服务器(master server)的从属服务器，那么执行 SLAVEOF host port 将使当前服务器停止对旧主服务器的同步，丢弃旧数据集，转而开始对新主服务器进行同步。

另外，对一个从属服务器执行命令 SLAVEOF NO ONE 将使得这个从属服务器关闭复制功能，并从从属服务器转变回主服务器，原来同步所得的数据集不会被丢弃。

利用“ SLAVEOF NO ONE 不会丢弃同步所得数据集”这个特性，可以在主服务器失败的时候，将从属服务器用作新的主服务器，从而实现无间断运行。

清空整个 Redis 服务器的数据(删除所有数据库的所有 key)。

清空当前数据库中的所有 key 。

• 如果有最少一个保存点在等待，执行 SAVE 命令

• 如果 AOF 选项被打开，更新 AOF 文件

如果持久化被打开的话， SHUTDOWN 命令会保证服务器正常关闭而不丢失任何数据。

假如只是单纯地执行 SAVE 命令，然后再执行 QUIT 命令，则没有这一保证 —— 因为在执行 SAVE 之后、执行 QUIT 之前的这段时间中间，其他客户端可能正在和服务器进行通讯，这时如果执行 QUIT 就会造成数据丢失。

• 执行成功时不返回任何信息，服务器和客户端的连接断开，客户端自动退出。

Slow log 是 Redis 用来记录查询执行时间的日志系统。

查询执行时间指的是不包括像客户端响应(talking)、发送回复等 IO 操作，而单单是执行一个查询命令所耗费的时间。

另外，slow log 保存在内存里面，读写速度非常快，因此你可以放心地使用它，不必担心因为开启 slow log 而损害 Redis 的速度。

比如执行以下命令将让 slow log 记录所有查询时间大于等于 100 微秒的查询：

而以下命令记录所有查询时间大于 1000 微秒的查询：

使用 CONFIG GET 命令可以查询两个选项的当前值：

GET number 则只打印指定数量的日志。

最新的日志会最先被打印：

日志的唯一 id 只有在 Redis 服务器重启的时候才会重置，这样可以避免对日志的重复处理(比如你可能会想在每次发现新的慢查询时发邮件通知你)。

使用命令 SLOWLOG LEN 可以查看当前日志的数量。

请注意这个值和 slower-max-len 的区别，它们一个是当前日志的数量，一个是允许记录的最大日志的数量。

返回值：取决于不同命令，返回不同的值。

返回关于 Redis 服务器的各种信息和统计值。

• 具体请参见下面的测试代码。

CONFIG GET 接受单个参数 parameter 作为搜索关键字，查找所有匹配的配置参数，其中参数和值以“键-值对”(key-value pairs)的方式排列。

比如执行 CONFIG GET s* 命令，服务器就会返回所有以 s 开头的配置参数及参数的值：

如果你只是寻找特定的某个参数的话，你当然也可以直接指定参数的名字：

• 10kb 、 2gb 这些在配置文件中所使用的储存单位缩写，不可以用在 CONFIG 命令中， CONFIG SET 的值只能通过数字值显式地设定。

• 上面 save 参数的三个值表示：在 900 秒内最少有 1 个 key 被改动，或者 300 秒内最少有 10 个 key 被改动，又或者 60 秒内最少有 1000 个 key 被改动，以上三个条件随便满足一个，就触发一次保存操作。

你可以使用它修改配置参数，或者改变 Redis 的持久化(Persistence)方式。

• 当设置成功时返回 OK ，否则返回一个错误。

重置 INFO 命令中的某些统计数据，包括：

返回给定 key 的调试信息。

• 当 key 存在时，返回有关信息。

  当 key 不存在时，返回一个错误。

令 Redis 服务器崩溃，调试用。

实时打印出 Redis 服务器接收到的命令，调试用。