限流

未匹配的标注
本文档最新版为 10.x,旧版本可能放弃维护,推荐阅读最新版!

限流

介绍

Laravel 包含了一个开箱即用的,基于缓存实现的限流器,提供了一个简单的方法来限制指定时间内的任何操作。

技巧:了解更多关于如何限制 HTTP 请求,请参考 请求频率限制中间件.

缓存配置

通常情况下,限流器使用你默认的缓存驱动,由 cache 配置文件中的 default 键定义。你也可以通过在你的应用程序的 cache 配置文件中定义一个 limiter 来指定限流器应该使用哪一个缓存来驱动:

'default' => 'memcached',
'limiter' => 'redis',

基础用法

可以通过 Illuminate\Support\Facades\RateLimiter 来操作限流器。限流器提供的最简单的方法是 attempt 方法,它将一个给定的回调函数执行次数限制在一个给定的秒数内。

当回调函数执行次数超过限制时, attempt 方法返回 false ;否则, attempt 方法将返回回调的结果或 trueattempt 方法接受的第一个参数是一个速率限制器 key ,它可以是你选择的任何字符串,代表被限制速率的动作:

    use Illuminate\Support\Facades\RateLimiter;

    $executed = RateLimiter::attempt(
        'send-message:'.$user->id,
        $perMinute = 5,
        function() {
            // 发送消息...
        }
    );

    if (! $executed) {
      return 'Too many messages sent!';
    }

手动配置尝试次数

如果您想手动与限流器交互,可以使用多种方法。例如,您可以调用 tooManyAttempts 方法来确定给定的限流器是否超过了每分钟允许的最大尝试次数

use Illuminate\Support\Facades\RateLimiter;

if (RateLimiter::tooManyAttempts('send-message:'.$user->id, $perMinute = 5)) {
    return 'Too many attempts!';
}

或者,您可以使用 remaining 方法检索给定密钥的剩余尝试次数。如果给定的密钥还有重试次数,您可以调用 hit 方法来增加总尝试次数:

use Illuminate\Support\Facades\RateLimiter;

if (RateLimiter::remaining('send-message:'.$user->id, $perMinute = 5)) {
    RateLimiter::hit('send-message:'.$user->id);

    // 发送消息。。。
}

确定限流器可用性

当一个键没有更多的尝试次数时,availableIn 方法返回在更多尝试可用之前剩余的秒数:

use Illuminate\Support\Facades\RateLimiter;

if (RateLimiter::tooManyAttempts('send-message:'.$user->id, $perMinute = 5)) {
    $seconds = RateLimiter::availableIn('send-message:'.$user->id);

    return 'You may try again in '.$seconds.' seconds.';
}

清除尝试次数

您可以使用 clear 方法重置给定速率限制键的尝试次数。例如,当接收者读取给定消息时,您可以重置尝试次数:

use App\Models\Message;
use Illuminate\Support\Facades\RateLimiter;

/**
 * 将邮件标记为已读。
 *
 * @param  \App\Models\Message  $message
 * @return \App\Models\Message
 */
public function read(Message $message)
{
    $message->markAsRead();

    RateLimiter::clear('send-message:'.$message->user_id);

    return $message;
}

本文章首发在 LearnKu.com 网站上。

本译文仅用于学习和交流目的,转载请务必注明文章译者、出处、和本文链接
我们的翻译工作遵照 CC 协议,如果我们的工作有侵犯到您的权益,请及时联系我们。

原文地址:https://learnku.com/docs/laravel/9.x/rat...

译文地址:https://learnku.com/docs/laravel/9.x/rat...

上一篇 下一篇
《L02 从零构建论坛系统》
以构建论坛项目 LaraBBS 为线索,展开对 Laravel 框架的全面学习。应用程序架构思路贴近 Laravel 框架的设计哲学。
《G01 Go 实战入门》
从零开始带你一步步开发一个 Go 博客项目,让你在最短的时间内学会使用 Go 进行编码。项目结构很大程度上参考了 Laravel。
贡献者:2
讨论数量: 0
发起讨论 查看所有版本


暂无话题~