Ranking API for Redis

Requirements

• Redis
  • >=2.4
• PhpRedis extension
  • https://github.com/nicolasff/phpredis
• PHP
  • >=7,>=8
• Composer

Installation

• Using composer

{
    "require": {
       "redis/ranking": "1.2.*"
    }
}

$ composer update redis/ranking --dev

Benchmark sample

% php sample/benchmark.php
Add: 18,350 queries/s
Update: 17,876 queries/s
Get score: 21,361 queries/s
Get rank: 22,123 queries/s
php sample/benchmark.php  1.50s user 2.96s system 43% cpu 10.203 total

How to run unit test

Run with default setting.

% vendor/bin/phpunit -c phpunit.xml.dist

Currently tested with PHP 7.4.5 + Redis 5.0.7.

TODO

• Implement following APIs
  • zRemRangeByRank, zDeleteRangeByRank - Remove all members in a sorted set within the given indexes
  • zRemRangeByScore, zDeleteRangeByScore - Remove all members in a sorted set within the given scores
• Implement zUnion API as a static helper API.

History

• 1.3.0
  • Updated libraries
  • Added PHP 8 Support and omit PHP 5 support.
• 1.2.0
  • Updated dev tools
• 1.1.0
  • Code Refactoring
  • Added PHP 7.0 support
  • Library update
  • Removed PHP5.3 and PHP5.4 compatibility
• 1.0.1
  • bugfix: correct variable name.
  • supports travis CI and passed test.
• 1.0.0
  • Published

License

It is released under the PHP License, version 3.01.

Copyright

• Yuki Matsukura
  • https://matsu.teraren.com/blog/