oltrematica/laravel-ratelimiter

a lightweight Laravel package that provides simple role management functionality.

v1.0.1 2025-03-07 11:22 UTC

Requires

• php: ^8.3
• illuminate/contracts: ^10.0|^11.0|^12.0

Requires (Dev)

• driftingly/rector-laravel: ^2.0
• larastan/larastan: ^3.0
• laravel/pint: ^1.21
• nunomaduro/collision: ^8.6
• orchestra/testbench: ^10.0
• pestphp/pest: ^3.7
• pestphp/pest-plugin-arch: ^3.0
• pestphp/pest-plugin-laravel: ^3.1
• phpstan/phpstan-deprecation-rules: ^2.0
• phpstan/phpstan-phpunit: ^2.0
• rector/rector: ^2.0

MIT

• Mircha Emanuel D'Angelo

• laravel
• rate limiter
• oltrematica
• api throttling

README

Oltrematica API Rate Limiter

A Laravel package to manage rate limiters for APIs, used internally at Oltrematica for our projects.

Introduction

This package provides a simple configuration for rate limiters in APIs, allowing easy management of requests for login, registration, and general API routes. It is designed to be straightforward to integrate and configure within Laravel projects.

Installation

To install the package, run the following command in your terminal:

composer require oltrematica/laravel-rate-limiter

Configuration

The package includes a configuration file that can be customized. To publish the configuration file to your project, run the following command:

php artisan vendor:publish --provider="Oltrematica\RateLimiter\RateLimiterServiceProvider" --tag="ratelimiter-config"

This will publish the rate-limiter.php configuration file into your project's config directory.

Usage

To apply rate limiters, use the following middleware in your routes:

• API Rate Limiter: Use the throttle:api middleware to apply rate limiting to API requests.
• Login Rate Limiter: Use the throttle:login middleware to apply rate limiting to login requests.
• Register Rate Limiter: Use the throttle:register middleware to apply rate limiting to registration requests.

Examples

Applying Rate Limiting to API Routes

In routes/api.php:

Route::middleware(['throttle:api'])->group(function () {
// API routes go here
});

Applying Rate Limiting to Login Route

In routes/web.php:

Route::post('/login', 'LoginController@login')->middleware('throttle:login');

Applying Rate Limiting to Registration Route

In routes/web.php:

Route::post('/register', 'RegisterController@register')->middleware('throttle:register');

Configuration Options

The rate-limiter.php configuration file allows you to customize request limits for each type of rate limiter. You can override default values using environment variables in your .env file.

Example .env Variables

RATE_LIMITING_API_IGNORE_ADMINS=true
RATE_LIMITING_API_LIMIT=60
RATE_LIMITING_API_LOGIN_LIMIT=60
RATE_LIMITING_API_LOGIN_LIMIT_PER_EMAIL=10
RATE_LIMITING_API_REGISTER_LIMIT=60

Code Quality

The project includes automated tests and tools for code quality control.

Rector

Rector is a tool for automating code refactoring and migrations. It can be run using the following command:

composer refactor

PhpStan

PhpStan is a tool for static analysis of PHP code. It can be run using the following command:

composer analyse

Pint

Pint is a tool for formatting PHP code. It can be run using the following command:

composer format

Automated Tests

The project includes automated tests and tools for code quality control.

composer test

Contributing

Feel free to contribute to this package by submitting issues or pull requests. We welcome any improvements or bug fixes you may have.