README

Adaptive Throttling for Laravel with Optional Graceful Degradation

ThrottleMate helps you handle connection bottleneck and API abuse with dynamic adaptive throttling.

Features

• Adaptive Rate Limiting
• Graceful Degradation (Cache + Queue Fallback)
• Compatible from Laravel 5.x to 11.x
• High Performance with Zero Dependency
• Developer Friendly API
• Automatic Cache Recovery

Install

composer require partimate/throttlemate
php artisan vendor:publish --tag=throttlemate

Usage

Basic Throttling

use PartiMate\ThrottleMate\AdaptiveThrottler;

$result = AdaptiveThrottler::make()
    ->throttle(fn () => 'Process Request', 'api:request', 100, 60);

Graceful Degradation (Cache Fallback)

$result = AdaptiveThrottler::make('cache', true)
    ->throttle(fn () => 'Fetch User Data', 'user:fetch', 50, 30);

Graceful Degradation (Queue Fallback)

$result = AdaptiveThrottler::make('queue', true)
    ->throttle(fn () => 'Send Email', 'email:send', 100, 60);

Throttle Middleware

Route::get('/api/data', [DataController::class, 'index'])->middleware('throttle.mate');

Configurable Rate Limit & TTL

Modify config/throttlemate.php:

return [
    'limit' => 200, // Requests per minute
    'ttl' => 120,  // Expire time in seconds
];

Benchmark Results ⚡️

Why ThrottleMate?

Contributing

Any contributions are welcome! Feel free to submit a pull request or open an issue.

License

ThrottleMate is open-source software licensed under the MIT License.

Contact

Developed with ❤️ by Deden Farhan