rate-limit - GitLite

KO | EN

gitlite — search

#python #hacktoberfest #go #golang #android #machine-learning #deep-learning #linux #macos #nodejs #java #cli #pytorch #ios

rate-limit

(★ 274)

🚔 General purpose rate limiter implementation.

File Explorer

Download Latest Version (.zip)

- - build.yml
- - CannotUseRateLimiter.php
  - LimitExceeded.php
  - RateLimitException.php
- ApcuRateLimiter.php
- ConfigurableRateLimiter.php
- InMemoryRateLimiter.php
- MemcachedRateLimiter.php
- PredisRateLimiter.php
- Psr16RateLimiter.php
- Rate.php
- RateLimiter.php
- RedisRateLimiter.php
- RuntimeConfigurableRateLimiter.php
- SilentRateLimiter.php
- Status.php
- - LimitExceededTest.php
- ApcuRateLimiterTest.php
- InMemoryRateLimiterTest.php
- MemcachedRateLimiterTest.php
- PredisRateLimiterTest.php
- Psr16RateLimiterTest.php
- RateLimiterTest.php
- RateTest.php
- RedisRateLimiterTest.php
- RuntimeConfigurableRateLimiterTest.php
.gitattributes
.gitignore
.php-cs-fixer.php
.scrutinizer.yml
CHANGELOG.md
composer.json
LICENSE
phpstan.neon.dist
phpunit.xml.dist
README.md

# Installation Guide

1. Get the code

git clone https://github.com/nikolaposa/rate-limit

Downloads the entire project code from GitHub to your computer.

cd rate-limit

Moves into the project folder you just downloaded.

2. PHP (Composer)

Easy Recommended

Prerequisites

Git Needed to download the project code from GitHub.
PHP A PHP runtime is required.
Composer The package manager used to install PHP libraries.

composer require nikolaposa/rate-limit

Type this command into your terminal and run it.

✅ Run it with a built-in server like php -S localhost:8000, then open http://localhost:8000 in your browser.

Pulled directly from this repo's README.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Rate Limit

[![Build](https://github.com/nikolaposa/rate-limit/workflows/Build/badge.svg?branch=master)](https://github.com/nikolaposa/rate-limit/actions)
[![Scrutinizer Code Quality](https://scrutinizer-ci.com/g/nikolaposa/rate-limit/badges/quality-score.png?b=master)](https://scrutinizer-ci.com/g/nikolaposa/rate-limit/?branch=master)
[![Code Coverage](https://scrutinizer-ci.com/g/nikolaposa/rate-limit/badges/coverage.png?b=master)](https://scrutinizer-ci.com/g/nikolaposa/rate-limit/?branch=master)
[![Latest Stable Version](https://poser.pugx.org/nikolaposa/rate-limit/v/stable)](https://packagist.org/packages/nikolaposa/rate-limit)
[![PDS Skeleton](https://img.shields.io/badge/pds-skeleton-blue.svg)](https://github.com/php-pds/skeleton)

General purpose rate limiter that can be used to limit the rate at which certain operation can be performed. Default implementation uses Redis as backend.
 
## Installation

The preferred method of installation is via [Composer](http://getcomposer.org/). Run the following
command to install the latest version of a package and add it to your project's `composer.json`:

```bash
composer require nikolaposa/rate-limit
```

## Usage

**Terminating rate limiter**

```php
use RateLimit\Exception\LimitExceeded;
use RateLimit\Rate;
use RateLimit\RedisRateLimiter;
use Redis;

$rateLimiter = new RedisRateLimiter(Rate::perMinute(100), new Redis());

$apiKey = 'abc123';

try {
    $rateLimiter->limit($apiKey);
    
    //on success
} catch (LimitExceeded $exception) {
   //on limit exceeded
}
```

**Silent rate limiter**

```php
use RateLimit\Rate;
use RateLimit\RedisRateLimiter;
use Redis;

$rateLimiter = new RedisRateLimiter(Rate::perMinute(100), new Redis());

$ipAddress = '192.168.1.2';
$status = $rateLimiter->limitSilently($ipAddress);

echo $status->getRemainingAttempts(); //99
```

**Practical usage with configuring multiple rate limiting strategies in a project**

```php
use RateLimit\Rate;
use RateLimit\RedisRateLimiter;

$container->set('rate_limiter.api', new RedisRateLimiter(Rate::perSecond(10), $container->get('redis')));
$container->set('rate_limiter.videos', new RedisRateLimiter(Rate::perDay(5), $container->get('redis')));
```

## Supported drivers

- [Redis](src/RedisRateLimiter.php)
- [Predis](src/PredisRateLimiter.php)
- [Memcached](src/MemcachedRateLimiter.php)
- [APCu](src/ApcuRateLimiter.php)
- [In-memory](src/InMemoryRateLimiter.php)

## Credits

- [Nikola Poša][link-author]
- [All Contributors][link-contributors]

## License

Released under MIT License - see the [License File](LICENSE) for details.

[link-author]: https://github.com/nikolaposa
[link-contributors]: ../../contributors