symfony/rate-limiter

Provides a Token Bucket implementation to rate limit input and output in your application

Maintainers

Details

github.com/symfony/rate-limiter

Homepage

Source

Fund package maintenance!
fabpot
Tidelift
symfony.com/sponsor

Installs: 25 086 111

Dependents: 76

Suggesters: 1

Security: 0

Stars: 239

Watchers: 8

Forks: 11

v7.2.0-RC1 2024-11-09 09:29 UTC

Requires

Requires (Dev)

MIT bb6b14ee6c1c4d2722a30d46fb92714943526804

limiterrate-limiter

This package is auto-updated.

Last update: 2024-11-13 15:17:04 UTC

README

The Rate Limiter component provides a Token Bucket implementation to rate limit input and output in your application.

Getting Started

composer require symfony/rate-limiter
use Symfony\Component\RateLimiter\Storage\InMemoryStorage;
use Symfony\Component\RateLimiter\RateLimiterFactory;

$factory = new RateLimiterFactory([
    'id' => 'login',
    'policy' => 'token_bucket',
    'limit' => 10,
    'rate' => ['interval' => '15 minutes'],
], new InMemoryStorage());

$limiter = $factory->create();

// blocks until 1 token is free to use for this process
$limiter->reserve(1)->wait();
// ... execute the code

// only claims 1 token if it's free at this moment (useful if you plan to skip this process)
if ($limiter->consume(1)->isAccepted()) {
   // ... execute the code
}

Resources