redis sorted set命令，php操做Redis sorted set函数介绍

sorted set类型介绍

sorted set是string类型元素的集合。有序集合成员是惟一的，不能出现重复的数据；有序集合和集合的区别在于每一个元素都会关联一个double类型的分数，redis能够经过分数为集合中的成员进行从小到大的排序，有序集合默认的是按分数从小到大排序的；集合的成员是惟一的，但分数是能够重复的。有序集合是经过哈希表实现的，最大的成员数达到2^32-1个php

Sorted Set原生命令

php操做redis Sorted Set的函数

• zAdd(key,score1,value1,[score2,value2, ....])函数
  * 说明：将一个或多个value成员加入到有序集合key中，若value已经存在，则更新value的分数值；
  * 参数：key(有序集合名称)，value(将要插入有序集合key的成员)，score(成员value对应的分数值)
  * 返回值：插入成功返回插入成员的个数，失败则返回0
  * php $ret = $redis->zAdd($key1,3,'k1',5,'k2'); /* 2 */
• zRange(key,start,stop,[withscores]),zRevRange(key,start,stop,[withscores])函数
  * 说明：取出有序集key中给定排名区间[start,stop]的全部成员并写入数组中；withscores表示是否取出成员及其分数值，默认值为false(不取出成员的分数值)；成员排名从前日后（0,1,2...），从后往前(...-2,-1)；zRange和zRevRange二者相似，区别在于：zRange()返回的数组按分数值从小到大排列，zRevRange()返回的数组按分数值从大到小排列
  * 参数：key(有序集合名称)，start(排名区间的左半边)，stop(排名区间的右半边)，withscores(可选项:默认为false)
  * 返回：withscores为true成功则返回给定区间内成员及其分数值组成的关联数组，withscores为false成功则返回给定区间内的全部成员组成的索引数组，失败则返回false
  * 注意： redis的版本>=3.2才能使用count参数
  * php $ret = $redis->zRange($key1,0,-1); /* array(2) { [0]=> string(2) "k1" [1]=> string(2) "k2" } */ $res = $redis->zRange($key1,0,-1,true); /* array(2) { ["k1"]=> string(1) "3" ["k2"]=> string(1) "5" } */ $ret1 = $redis->zRevRange($key1,0,-1);/* array(2) { [0]=> string(2) "k2" [1]=> string(2) "k1" } */ $res1 = $redis->zRevRange($key1,0,-1,true);/* array(2) { ["k2"]=> string(1) "5" ["k1"]=> string(1) "3" } */
• zRangeByScore(key,start,stop,options), zRevRangeByScore(key)函数
  * 说明：取出给定有序集合key中指定分数区间内的全部成员并组成数组返回；zRangeByScore()返回的数组按分数值从小到大排序，zRevRangeByScore()则相反；
  * 参数：key(有序集合名称)，start(指定分数值区间的左半边)，stop(指定分数值区间的右半边)，options(options包含是两个可选项withscores的数组，limit；withscores是bool型数值，表示返回的数组中是否包含成员分数值，true包含，false不包含；limit是数组形式，limit=>array($offset, $count), $offset表示取值的偏移量， $count限制返回成员的个数 )
  * 返回：成功则返回取出成员组成的数组，失败则返回false
  * php $ret = $redis->zRangeByScore($key1,2,6); /* array(2) { [0]=> string(2) "k1" [1]=> string(2) "k2" } */ $res = $redis->zRangeByScore($key1,2,6,array('withscores' => true)); /* array(2) { ["k1"]=> string(1) "3" ["k2"]=> string(1) "5" } */ $rea = $redis->zRangeByScore($key1,2,6,array('withscores' => true,'limit'=>array(1,1))); /* array(1) { ["k2"]=> string(1) "5" } */
• zRangeByLex(key,min,max,[offset],[limit])函数
  * 说明：取出给定的有序集合key中指定字典序区间的全部成员；offset表示偏移量(从偏移量处开始取值)，limit限制返回的成员个数；“(”表示开区间，“[”表示闭区间；该方法必须是3个或5个参数
  * 参数：key(有序集合名称)，min(字典序区间的左半边)，max(字典序区间的右半边 )，offset(可选参数，偏移量)，limit(可选参数，限制返回的成员的个数)
  * 返回：成功则返回取出成员组成的数组，失败则返回false
  * 注意：redis-server > 2.8.9才能使用该方法
  * php $ret = $redis->zRangeByLex($key1,'[a','[l'); /* array(2) { [0]=> string(2) "k1" [1]=> string(2) "k2" } */
• zCard(key), zSize(key)函数
  * 说明：获取有序集合key的大小（成员的个数），两个函数功能是同样的
  * 参数：key(有序集合名称)
  * 返回：执行成功返回有序集合的大小，失败则返回false
  * php $ret = $redis->zCard($key1); /* 2 */ $res = $redis->zSize($key1); /* 2 */
• zCount(key,start,stop)函数
  * 说明：获取有序集合key中在给定分数值区间内的所有成员的个数
  * 参数： key(有序集合的名称)，start(分数区间的左半边，能够为负值)，stop(分数值区间的右半边，能够为负值)
  * 返回：成功返回给定分数值区间内的成员的个数，失败返回false
  * php $ret = $redis->zCount($key1,0,4); /* 1 */ $res = $redis->zCount($key1,-2,0); /* 0 */
• zRem(key,member), zDelete(key,member)函数
  * 说明：从有序集key中删除成员member，两个函数功能是同样的
  * 参数：key(有序集合的名称)，member(将要删除的成员)
  * 返回值：执行成功返回1，失败返回0
  * php $ret = $redis->zRem($key1,'k1'); /* 1 */ $res = $redis->zDelete($key1,'k2'); /* 1 */
• zRemRangeByScore(key,start,stop), zDeleteRangeByScore(key,start,stop)函数
  * 说明: 删除有序集合key中指定分数值区间内的全部成员，二者的功能是同样的
  * 参数： key(有序集合的名称)，start(分数值区间的左半边，能够是负值)，stop(分数值区间的右半边，能够是负值)
  * 返回：成功则返回删除成员的个数，失败则返回false
  * php $ret = $redis->zRemRangeByScore($key1,1,3);/* 1 */ $res = $redis->zDeleteRangeByScore($key1,6,12); /* 2 */
• zRemRangeByRank(key,start,stop), zDeleteRangeByRank(key,start,stop)函数
  * 说明：移除有序集合key中指定排名区间内的全部成员，二者的功能是同样的；排名从0开始依次增长1
  * 参数：key(有序集合的名称)，start(排名区间的左半边，能够为负值)，stop(排名区间的右半边，能够为负值)
  * 返回：成功返回被成功移除的成员的个数，失败则返回false
  * php $ret = $redis->zRemRangeByRank($key1,1,2); /* 2 */ $res = $redis->zDeleteRangeByRank($key1,0,1); /* 2 */
• zScore(key,member)函数
  * 说明：获取给定有序集合key中成员member的分数值
  * 参数：key(有序集合名称)，member(指定的成员)
  * 返回：执行成功返回member的分数值；失败则返回false
  * php $ret = $redis->zScore($key1,'k2'); /* float(4) */
• zIncrBy(key,value,member)函数
  * 说明：给给定的有序集合key中的成员member的分数值加上一个增量value，若是member不存在，则给key新增一个成员member并复制value
  * 参数：key(有序集合名称)，value(增量值)，member(指定的成员)
  * 返回：返回member的新值（浮点数）
  * php $ret = $redis->zIncrBy($key1,3,'k2'); /* float(7) */
• zInter(dstKey,srcKeyArr,,weightsArr,aggregateFunction)函数
  * 说明：获取给定的有序集组成的数组srcKeyArr中成员的交集，并将返回值存储到目标有序集合dstKey中；
  * 参数：dstKey(目标有序集合)，srcKeyArr(给定的有序集合组成的数组)，weightsArr(可选参数)，aggregateFunction(可选参数)
  * 返回：成功返回目标结果集dstKey的大小，失败则返回false
  * php $redis->zAdd($key2,3, 'k2' , 5 , 'k4'); $ret = $redis->zInter($key3,array($key1,$key2)); /* int(2) */ $res = $redis->zRange($key3,0, -1, true); /* array(2) { ["k4"]=> string(1) "9" ["k2"]=> string(2) "10" } */
• zUnion(dstKey,srcKeyArr,weightsArr,aggregateFunction)函数
  * 说明：获取给定的有序集组成的数组srcKeyArr中成员的并集，并将返回值存储到dstKey集合中；
  * 参数：dstKey(目标有序集合)，srcKeyArr(给定的有序集合组成的数组)，weightsArr(可选参数)，aggregateFunction(可选参数)
  * 返回：成功返回目标结果集dstKey的大小，失败则返回false
  * php $ret = $redis->zUnion($key3,array($key1,$key2));/* int(5) */ $res = $redis->zRange($key3,0, -1, true);/* array(5) { ["k3"]=> string(1) "6" ["k1"]=> string(1) "8" ["k5"]=> string(1) "8" ["k4"]=> string(1) "9" ["k2"]=> string(2) "10" } */
• zRank(key,member), zRevRank(key,member)函数
  * 说明：获取给定有序集合key中指定成员member的排名；zRank最小的排名为0，zRevRank最大的排名为0
  * 参数：key(有序集合名称)，member(给定的成员)
  * 返回：成功返回该member的排名，失败返回false
  * php $ret = $redis->zRank($key1,'k2');/* int(2) */
• zScan(key,iterator,pattern,count)函数 * 说明：用迭代器iterator遍历指定模式pattern的有序集合key，并限制返回的成员个数count * 参数：key(有序集合的名称)，iterator(迭代器)，pattern(遍历时的匹配条件)，count(指望返回成员的数量) * 返回：执行成功返回一个数组，失败则返回false