About

Multiple policy rate limit for laravel

适用于 Laravel 的多策略速率限制包

应用场景

• 多策略的Api请求速率控制

• 多策略的队列速率控制

安装

composer require jiaxincui/laravel-throttler

配置文件

此命令将配置文件copy至config/throttler.php

php artisan vendor:publish --provider="Jiaxincui\Throttler\ThrottlerServiceProvider"

• prefix 限速器 key 前缀，如果有多个应用存在 key 重复的可能你可以设置一个适当的前缀，如果你确定没有重复的可能可忽略。

• limiter 使用的限速器，如果为空，默认使用Iluminate\Cache\RateLimiter， 如果要自定义限速器实现，要确保其实现 Jiaxincui\Throttler\Contracts\Limiter 接口

• guard 限速方案，在使用中没有明确指定 guard 将使用 default 作为限速方案。

每个方案可以设置多条策略，如 default 方案限制每秒钟5次，并且每分钟10次，每小时50次，每24小时100次，可以像下面这样设置:

[
  'guards' => [
    'default' => [
      [5, 1],
      [10, 60],
      [50, 60*60],
      [100, 60*60*24]
    ],

 //   'custom' => [
 //     [5, 1],
 //     [10, 60]
 //   ]
  ]
];

使用

• 一般情况下你只需要在配置文件设置策略即可。

use Jiaxincui\Throttler\Facades\Throttler;

Throttler::for($request->ip)
    ->then(function() {
        // 通过
        var_dump('Hello world!');
    }, function($availableIn) {
        // 未通过
        var_dump($availableIn);
    });

// 使用其他限速方案
Throttler::guard('custom')
    ->for($request->ip)
    ->then(function() {
        // 通过
        var_dump('Hello world!');
    }, function($availableIn) {
        // 未通过
        var_dump($availableIn);
    });

• 如果你要在运行时设置限制策略，可以像下面这样做：

use Jiaxincui\Throttler\Facades\Throttler;

Throttler::for($user->id)
    ->tap([5, 1])
    ->tap([10, 60])
    ->tap([50, 60*60])
    ->then(function() {
        // 通过
        var_dump('Hello world!');
    }, function($availableIn) {
        // 未通过
        var_dump($availableIn);
    });

// 或者
$taps = [
    [5, 1],
    [10, 60],
    [50, 60 * 60]
];

Throttler::throttle($user->id)
    ->tap($taps)
    ->then(function() {
        // 通过
        var_dump('Hello world!');
    }, function($availableIn) {
        // 未通过
        var_dump($availableIn);
    });

• 你也可以在控制器的构造方法里通过依赖注入使用它

<?php

namespace App\Http\Controllers;

use Jiaxincui\Throttler\Throttler;

class UserController extends Controller
{
    protected $throttler;

    /**
     * Create a new controller instance.
     *
     * @param Throttler $throttler
     */
    public function __construct(Throttler $throttler)
    {
        $this->throttler = $throttler;
    }
    public function index(Request $request)
    {
        $this->throttler->for($request->ip)
            ->then(function () {
              // 通过
            }, function ($availableIn) {
              // 未通过
}           );
    }

}

Api

方法	返回	说明
for(string $key)	$this	传入$key创建一个限速器
guard(string $guradName)	$this	应用一个限速方案
tap(array $tapAndTaps)	$this	添加一个或多个限速策略
then(callable $callback, callable $failure)	null	$callback 成功通过的回调, $failure未通过回调，参数$availableIn为距离下次可通过的秒数

License

MIT © JiaxinCui