Yii redis zset有序集合的使用

Posted 2020-12-17 幽篁晓筑

 

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