Skip to content

基于 Redis 的有序集实现的排行榜组件,包含:总排行榜、日排行榜、周排行榜、月排行榜、季度排行榜、年排行榜。

Notifications You must be signed in to change notification settings

zqhong/redis-ranking

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

17 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Redis-Ranking

Redis-Ranking 库使用 Redis 的 SortedSet 存储排行数据。其中,

  1. 使用 ZINCRBY 导入单条分数变更记录;
  2. 使用 ZREVRANGE 获取 top x 的用户数据(按照 score 从大到小排序);
  3. 使用 ZRANK 获取某个用户的排名;
  4. 使用 ZSCORE 获取某个用户的分数;

安装

$ composer require -vvv zqhong/redis-ranking

使用

<?php
require __DIR__ . '/vendor/autoload.php';

use Predis\Client;
use Zqhong\RedisRanking\Ranking\TotalRanking;
use Zqhong\RedisRanking\RankingManger;
use Zqhong\RedisRanking\Test\Fixture\DummyTotalDataSource;

$redisClient = new Client([
    'scheme' => 'tcp',
    'host' => '127.0.0.1',
    'port' => 6379,
    'password' => 'secret',
    'database ' => 1,
]);

$rankingManager = (new RankingManger())
    // 这里的 DataSource 类需要自己实现
    ->setDataSource(new DummyTotalDataSource())
    // 设置需要获取的排行数据,目前有:
    // 总排行、日排行、周排行、月排行、季排行、年排行
    ->setRankingClasses([
        TotalRanking::class,
    ])
    // 设置当前排行数据的 namespace
    ->setRankingName('test')
    // 注入 Redis 客户端
    ->setRedisClient($redisClient)
    // 初始化
    ->init();

// 获取总排行榜中前三名用户的数据(带分数)
$rankingManager->totalRanking->top(3);

// 获取总排行榜中前三名用户的数据(不带分数)
$rankingManager->totalRanking->top(3, false);

// 获取用户 akira 的排名(总排行榜中)
$rankingManager->totalRanking->rank('akira');

// 获取用户 akira 的分数(总排行榜中)
$rankingManager->totalRanking->score('akira');

// 添加一条分数变更记录(总排行榜)
// 如果用户 test 不存在,则会添加该用户,分数为 1
// 如果用户 test 已存在,该用户的分数则会在原分数基础上 + 1
$rankingManager->totalRanking->add('test', 1);

// 获取参与该排行榜的人数
echo $rankingManager->totalRanking->cardinality();

目前存在问题:

如果排名规则不仅仅是依靠 score 的话,这种方式的实现就不大合适。

About

基于 Redis 的有序集实现的排行榜组件,包含:总排行榜、日排行榜、周排行榜、月排行榜、季度排行榜、年排行榜。

Topics

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages