coon-design/rate-limit

PSR-7 rate limit implementation

0.5 2023-06-03 11:03 UTC

This package is auto-updated.

Last update: 2024-05-03 13:03:19 UTC


README

PSR-7 Rate limiting using Redis or Memcache. predis is not needed for this middleware. It uses Tinyredisclient by ptrofimov.

Usage

The last constructor argument is the redis password. This is option. When it is not provided the middleware will connect without authenticating.

$rateLimitMiddleware = new \Prezto\RateLimit\RateLimitMiddleware('10.241.25.226', '6379', 'aslkjkrnflawekrmgfslerm')

Setting the limit after instantiating. The first argument is the maximum number of requests. The second argument is the time limit in seconds.

In this example the client is allowed to make 60 requests in 30 seconds.

$rateLimitMiddleware->setRequestsPerSecond(60, 30);

When the request limit has been reached the request statuscode is set to 429 by default.

By default the Redis is used as a storage. To use Memcache instead:

$rateLimitMiddleware->useMemcache();

Custom handler when limit has been reached.

$rateLimitMiddleware->setHandler(function ($request, $response) {
            $response = $response->withStatus(429);
            $response->getBody()->write("Rate limit reached.");
            return $response;
        });