跳转到主内容
趣航编程网 - 趣学编程,启航技术之路!

Laravel怎样使用缓存计数器实现限流_Laravel使用缓存计数器实现限流方法【安全】

可直接利用Laravel内置缓存驱动配合手动计数器实现限流:一、用RateLimiter::attempt执行原子性限流;二、手动调用remaining与hit分步控制;三、自定义缓存键绕过IP共享限制;四、用clear主动重置异常计数器;五、配置缓存驱动强制走Redis防失效。

如果您在 Laravel 应用中需要对高频接口实施轻量、可控的请求频率控制,且不依赖 Redis 或外部缓存服务,可直接利用 Laravel 内置缓存驱动配合手动计数器实现限流。以下是基于缓存计数器的多种实现方法:

一、使用 RateLimiter::attempt 执行原子性限流

该方法通过缓存键自动完成“检查-执行-计数”三步操作,确保并发安全,适用于单次操作(如发送短信、提交表单)的防刷场景。它底层调用 cache store 的 increment 和 ttl 设置,避免竞态条件。

1、在控制器方法中调用 RateLimiter::attempt,传入唯一键(如用户ID或IP拼接)、时间窗口内最大次数及回调函数。

2、键名必须为字符串且不含空格或斜杠,例如

"sms:{$user->id}"或"login:{$request->ip()}"。

3、若返回 false,表示已超限,应立即终止流程并返回错误响应。

4、确认 config/cache.php 中 default 缓存驱动已设为 redis 或 memcached;若使用 array 驱动,该方法在多进程下将完全失效。

二、手动调用 remaining 与 hit 实现分步控制

当需在限流触发前执行前置逻辑(如日志记录、参数校验),或需动态调整配额时,可分离“查询剩余次数”与“手动递增计数”两个动作。此方式提供更高灵活性,但要求开发者确保 hit 操作在业务逻辑成功后才执行。

1、使用 RateLimiter::remaining('key', $maxPerMinute) 查询当前密钥剩余可用次数。

2、若返回值大于 0,继续执行业务逻辑。

3、业务逻辑完成后,显式调用 RateLimiter::hit('key') 更新计数器。

4、若需获取重试等待时间,可在判断 tooManyAttempts 后调用 RateLimiter::availableIn('key'),其返回值为整数秒数,不可为负值或 null。

三、自定义缓存键生成策略绕过 IP 共享限制

当应用部署于 CDN 或负载均衡后,所有请求共享同一源 IP,导致按 IP 限流误伤正常用户。此时必须替换默认 key 生成逻辑,改用设备指纹、Token 哈希或请求头标识等更精细维度。

1、在 App\Providers\AppServiceProvider 的 boot() 方法中注册新策略,例如按 X-Device-ID 头限流。

2、确保请求头值经 trim() 和 urlencode() 处理,且最终 by() 返回值为纯 ASCII 字符串,禁止含冒号、竖线、空格。

Laravel 13.2.0 PHP中文网提供Laravel 13.2.0版本下载,Laravel框架 是基于 PHP 8.3+ 的高性能框架,官方推荐通过 Composer 安装。它内置 AI SDK、JSON:API Resources 及原生向量搜索,支持属性驱动开发与队列路由,大幅提升开发效率。相比旧版,13.2.0 优化了缓存 TTL 管理与实时通信,无需 Redis 即可横向扩展。作为现代 Web 开发首选,它兼顾安全与极速体验,助您快速构建企业级应用。

下载3、调用 RateLimiter::for('device_api', function (Request $request) { return Limit::perMinute(20)->by($request->header('X-Device-ID') ?: 'anonymous'); });4、路由中启用中间件:->middleware('throttle:device_api'),不可写作 throttle:20,1。

四、使用 clear 主动重置异常计数器

当用户反馈被误限、或某类请求因 token 过期/会话残留持续触发 429 错误时,需支持运维侧快速清理对应缓存键。此操作不依赖中间件,可独立用于修复场景。

1、在 tinker 环境或命令行中执行 Cache::get('throttle|192.168.1.100') 验证键是否存在。

2、确认键格式为

throttle|{key},其中 key 必须与 RateLimiter 中 by() 返回值完全一致(大小写敏感、无前后空格)。

3、执行 Cache::forget('throttle|' . $key) 清除该用户/设备的全部计数状态。

4、注意:clear 方法仅清空计数器,不修改限流策略定义;若策略本身有误,需同步修正 configureRateLimiting 中的闭包逻辑。

五、配置缓存驱动强制走 Redis 防止本地失效

Laravel 默认使用 cache 配置中的 default 驱动,而 throttle 中间件实际读写的是 cache store,非 redis 连接本身。若未显式指定 limiter 驱动,多服务器部署下将因缓存隔离导致限流失效。

1、在 config/cache.php 中设置 'limiter' => 'redis',确保限流专用 store 明确指向 Redis。

2、验证 env 文件中 CACHE_DRIVER=redis 且 REDIS_CLIENT=predis 或 phpredis 已正确安装。

3、运行 php artisan config:clear && php artisan cache:clear 清理配置缓存。

4、关键验证点:

php artisan tinker 中执行 Cache::store('redis')->put('test', 'ok', 10) 应成功返回 true,否则限流器无法持久化计数。

相关文章