和散列存储着键与值之间的映射关系类似,有序集合也存储着成员与分值之间的映射,并且提供了分值处理命令,以及根据分值大小有序地获取(fetch)和扫描(scan)成员和分值的命令。这里介绍一些常用命令,以及在 Yii 中的使用。
ZADD
> ZADD:ZADD key-name score member \[score member …\]
> 将带有给定分值的成员添加到有序集合里面。
ZREM
> ZREM:ZREM key-name member \[member …\]
> 从有序集合里面移除给定的成员,并返回被移除成员的数量。
ZCARD
> ZCARD:ZCARD key-name
> 返回有序集合包含的成员数量。
ZINCRBY
> ZINCRBY:ZINCRBY key-name increment member
> 将 member 成员的分值加上 increment。
ZCOUNT
> ZCOUNT:ZCOUNT key-name min max
> 返回分值介于 min 和 max 之间的成员数量。
ZRANK
> ZRANK:ZRANK key-name member
> 返回成员 member 在有序集合中的排名。排名从 0 开始。
ZSCORE
> ZSCORE:ZSCORE key-name member
> 返回成员 member 的分值。
ZRANGE
> ZRANGE:ZRANGE key-name start stop \[WITHSCORES\]
> 返回有序集合中排名介于 start 和 stop 之间的成员,如果给定了可选的 WITHSCORES 选项,那么命令会将成员的分值也一并返回。
ZREVRANK
> ZREVRANK:ZREVRANK key-name member
> 返回有序集合里成员 member 的排名,成员按照分值从大到小排序。
ZREVRANGE
> ZREVRANGE:ZREVRANGE key-name start stop \[WITHSCORES\]
> 返回有序集合给定排名范围内的成员,成员按照分值从大到小排序。
ZRANGEBYSCORE
> ZRANGEBYSCORE:ZRANGEBYSCORE key min max \[WITHSCORES\] \[LIMIT offset count\]
> 返回有序集合中,分值介于 min 和 max 之间的所有成员。
ZREVRANGEBYSCORE
> ZREVRANGEBYSCORE:ZREVRANGEBYSCORE key max min \[WITHSCORES\] \[LIMIT offset count\]
> 获取有序集合中分值介于 min 和 max 之间的所有成员,并按照分值从大到小的顺序来返回它们。
ZREMRANGEBYRANK
> ZREMRANGEBYRANK:ZREMRANGEBYRANK key-name start stop
> 移除有序集合中排名介于 start 和 stop 之间的所有成员。
ZREMRANGEBYSCORE
> ZREMRANGEBYSCORE:ZREMRANGEBYSCORE key-name min max
> 移除有序集合中分值介于 min 和 max 之间的所有成员。
**在 Yii 中使用实例:**
```
// 添加3组成员及其分值
Yii::$app->redis->zadd('testZsetKey', 1, 'a', 2, 'b', 3, 'c'); // 3
// 返回成员数量
Yii::$app->redis->zcard('testZsetKey'); // 3
// 将c成员的分值加3
Yii::$app->redis->zincrby('testZsetKey', 3, 'c'); // 6
// 返回c成员的分值
Yii::$app->redis->zscore('testZsetKey', 'c'); // 6
// 获取c在有序集合中的排名,排名从0开始
Yii::$app->redis->zrank('testZsetKey', 'c'); // 2
// 返回分值介于1和6之间的成员数量
Yii::$app->redis->zcount('testZsetKey', 1, 6); // 3
// 移除成员b
Yii::$app->redis->zrem('testZsetKey', 'b'); // 1
// 返回有序集合中所有成员及分值
Yii::$app->redis->zrange('testZsetKey', 0, -1, 'WITHSCORES'); // ["a","1","c","6"]
```