Lar*el API 速率限制核心是 throttle 中间件配合缓存驱动，支持按 IP、用户 ID 或自定义策略（如角色）限流，自动返回 429 状态码及 X-RateLimit-* 响应头，生产环境需用 Redis 避免 file 缓存失效。

在 Lar*el 中实现 API 速率限制，核心是利用框架内置的 throttle 中间件，配合缓存驱动（如 Redis 或 file）来记录请求频次。关键在于合理配置限流策略、作用域和响应行为，而不是手动计数。

基础用法：全局或路由级限流

最简单的方式是在路由定义中直接使用 throttle:60,1，表示每分钟最多 60 次请求：

Route::middleware('throttle:60,1')->group(function () {
  Route::get('/api/posts', [PostController::class, 'index']);
});

其中数字分别代表「最大请求数」和「时间窗口（分钟）」。Lar*el 默认使用 IP 地址作为识别依据，同一 IP 超过阈值会返回 429 状态码。

按用户身份限流（登录用户专属）

对已认证用户启用更精准的限流，避免未登录用户挤占配额：

• 在 app/Http/Kernel.php 的 $middlewareGroups 中确认 throttle:api 已启用
• 使用 throttle:60,1,by=auth 或更明确地写成 throttle:100,1,by=id
• Lar*el 会自动从当前用户模型取 id 作为 key，不同用户互不影响

自定义限流策略（按用户角色或业务逻辑）

在 App\Providers\RouteServiceProvider 的 configureRateLimiting 方法中注册策略：

星声AI

可分享的AI播客内容生成器和效率工具

185 查看详情 RateLimiter::for('premium_api', function (Request $request) {
  return $request->user() && $request->user()->is_premium
    ? Limit::perMinute(500)->by($request->user()->id)
    : Limit::perMinute(60)->by($request->ip());
});

然后在路由中调用：middleware('throttle:premium_api')。这样免费用户走 60 次/分钟，付费用户提升到 500 次/分钟。

响应头与前端友好提示

Lar*el 自动在响应中添加以下 HTTP 头，方便前端控制重试逻辑：

• X-RateLimit-Limit：该窗口允许的最大请求数
• X-RateLimit-Remaining：剩余可用次数
• Retry-After：触发限流后需等待的秒数（仅当耗尽时返回）

你还可以在 app/Exceptions/Handler.php 中捕获 ThrottleRequestsException，自定义 JSON 错误结构，比如返回 {"error": "Too many requests", "retry_after": 60}。

基本上就这些。不复杂但容易忽略的是缓存驱动的选择——生产环境务必用 Redis，file 缓存无法跨进程同步计数，会导致限流失效。

以上就是Lar*el如何实现API速率限制？（Rate Limiting教程）的详细内容，更多请关注php中文网其它相关文章！

相关文章： C++如何跨平台操作文件和目录_C++17标准库std::filesystem的使用教程  漫画星球免费下拉式入口 漫画星球免费漫画在线阅读网站  Lar*el DB::listen 事件中的查询执行时间单位解析  抖音网页版平台入口 抖音网页版官网在线访问教程  AO3同人作品网入口 AO3搜索引擎官网永久地址  CSS图片焦点样式实现教程：理解与应用tabindex属性  处理Kafka消费者会话超时：深入理解消息处理语义与幂等性  蛙漫漫画免费阅读入口_蛙漫官方正版无广告纯净版  怎么去除衣服上的口红印_生活小妙招教你用酒精轻松擦除  快手极速版在线观看 官方网页版登录地址  C++如何连接MySQL数据库_C++使用Connector/C++操作MySQL数据库教程  深入理解Google Cloud Datastore查询：祖先路径与数据一致性  mcjs网页版在线存档 mcjs云存档登录入口  Safari浏览器输入栏卡顿如何解决 Safari搜索建议与缓存清理  Tabulator表格中精确实现日期时间排序的指南  React Router v6 教程：构建认证保护的私有路由与重定向策略  解决PHP集成HTML后CSS和图片路径加载问题的指南  Yandex官方入口网址 Yandex俄罗斯搜索引擎最新在线地址  三星GalaxyZFold5怎样在相册制作折叠屏分镜_iPhone三星GalaxyZFold5相册制作折叠屏分镜【创意编辑】  php源码怎么看淘宝客系统_看php源码淘宝客系统技巧  微信语音通话掉线如何解决 微信语音通话稳定优化方法  c++如何实现一个简单的ECS框架_c++数据驱动设计与游戏开发  如何将HTML表格多行数据保存到Google Sheet  铁路12306的积分有效期是多久_铁路12306积分有效期说明  Lar*el表单中优雅地处理“返回”按钮以规避验证：最佳实践指南  葱吃多了会怎样 葱吃多了会伤胃吗  Golang并发任务中错误如何聚合_Golang goroutine error收集方式  漫蛙Manwa2官网入口地址分享 漫蛙漫画PC版永久访问通道  生成rdflib自定义SPARQL函数：参数匹配与实践指南  在J*a中如何开发简易仓库管理与库存统计_仓库管理库存统计项目实战解析  Lar*el Migration：重命名列后添加新列的正确操作顺序  J*a TimerTask中HashMap意外清空的深层原因与解决方案  WordPress插件开发：正确注册卸载钩子与避免常见陷阱  AngularJS $http POST请求数据传递与Go后端接收实践  cad怎么合并重叠的线段_cad清理重复重叠线条的操作方法  C++编译期如何执行复杂计算_C++模板元编程(TMP)技巧与应用  在J*aScript中复现SciPy的B样条拟合与求值：关键考量  MongoDB Aggregation：在嵌套对象数组中精确匹配ObjectId  微博网页版首页入口 微博电脑端官网登录链接  如何修改开机登录密码_Windows账户安全设置超详细教程【必学】  小米汽车11月交付量突破40000台！雷军：将继续努力  win11 arm版怎么安装 M1/M2 Mac虚拟机安装ARM win11的方法  C++ explicit关键字防止隐式转换_C++构造函数安全规范  曝R星经典之作开发图 设计简陋但信息密集！  离线运行Go语言之旅：本地部署与GOPATH配置指南  c++中为什么推荐使用using替代typedef_c++现代化类型别名  如何在网页中实现特定地点的随机图片展示  Yandex搜索引擎一键访问入口_俄罗斯Yandex官网免登录  如何仅使用CSS更改登录界面背景图像图标的颜色  京东京造J1和网易云音乐氧气真无线有什么不同_国产电商蓝牙耳机音质对比