和散列存储着键与值之间的映射关系类似,有序集合也存储着成员与分值之间的映射,并且提供了分值处理命令,以及根据分值大小有序地获取(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"]