Laravel速率限制通过throttle中间件和RateLimiter门面实现,基于缓存系统为不同用户、IP或API端点设置请求阈值,防止滥用并保护服务器资源。

Laravel的速率限制(Rate Limiting)功能,说白了,就是给你的应用设一道“门禁”,控制在一定时间段内,某个用户、某个IP或者某个API密钥能向你的服务器发送多少次请求。这玩意儿可太重要了,它能有效防止恶意刷接口、DDoS攻击,或者仅仅是避免你的API被过度调用,导致服务器资源耗尽。设置起来其实不复杂,主要通过路由中间件或者更灵活的
RateLimiter
要设置Laravel的请求限制,我们通常有两种主要途径,各有侧重:
1. 使用路由中间件 (Route Middleware) 进行全局或分组限制
这是最常见也最直接的方式。Laravel提供了一个开箱即用的
throttle
首先,你可以在
app/Providers/RouteServiceProvider.php
configureRateLimiting
use Illuminate\Cache\RateLimiting\Limit;
use Illuminate\Support\Facades\RateLimiter;
/**
* Configure the application's rate limiters.
*
* @return void
*/
protected function configureRateLimiting()
{
RateLimiter::for('api', function (Request $request) {
// 针对已认证用户,允许每分钟100次请求
// 如果是未认证用户,则按IP每分钟60次
return $request->user()
? Limit::perMinute(100)->by($request->user()->id)
: Limit::perMinute(60)->by($request->ip());
});
RateLimiter::for('web', function (Request $request) {
// 网页端,通常限制宽松些,或者只限制特定操作
return Limit::perMinute(1000); // 宽松示例
});
// 针对一个特定的上传功能,比如图片上传,限制更严格
RateLimiter::for('uploads', function (Request $request) {
return Limit::perMinute(5)->by($request->user()->id ?: $request->ip());
});
}定义好限制器后,你就可以在路由中应用它们了:
// 应用到整个API路由组
Route::middleware(['api', 'throttle:api'])->group(function () {
Route::get('/user', function () {
// ...
});
});
// 应用到特定路由,使用自定义的限制器名称
Route::post('/upload-image', [ImageController::class, 'upload'])
->middleware('throttle:uploads');
// 你也可以直接在路由中定义简单的限制规则,不依赖预设的限制器
// 例如:每分钟60次请求,每秒1次请求
Route::get('/some-endpoint', function () {
// ...
})->middleware('throttle:60,1');这里的
throttle:60,1
throttle:rate_limit_name
configureRateLimiting
2. 使用 RateLimiter
有时候,你可能需要在代码的某个特定逻辑点进行速率限制,而不是整个路由。
RateLimiter
比如,你有一个发送短信验证码的功能,你可能不希望用户在短时间内频繁点击发送:
use Illuminate\Support\Facades\RateLimiter;
use Illuminate\Http\Request;
class SmsController extends Controller
{
public function sendVerificationCode(Request $request)
{
$key = $request->ip() . '-' . $request->input('phone'); // 或者只用手机号
$decayMinutes = 1; // 衰减时间,1分钟
// 尝试执行,如果达到限制则返回false
if (RateLimiter::tooManyAttempts($key, 3)) { // 允许3次尝试
$retryAfter = RateLimiter::availableIn($key);
return response()->json([
'message' => '发送验证码过于频繁,请稍后重试。',
'retry_after' => $retryAfter, // 告诉用户多久后可以重试
], 429);
}
// 如果没有达到限制,则记录一次尝试
RateLimiter::hit($key, $decayMinutes * 60); // 记录一次尝试,并设置过期时间
// 实际发送验证码的逻辑
// ...
return response()->json(['message' => '验证码已发送。']);
}
}这种方式让你能在业务逻辑内部精确控制速率,非常适合那些需要更细粒度限制的场景。
当我们谈论Laravel的速率限制,它背后其实是一套相对成熟且高效的机制,主要依赖于Laravel的缓存系统。在我看来,理解它的底层工作方式,能帮助我们更好地配置和排查问题。
核心组件是
Illuminate\Cache\RateLimiting\Limit
Illuminate\Cache\RateLimiter
计数与存储: 当一个请求进入被速率限制的路由或代码块时,Laravel会生成一个唯一的“键”(Key)。这个键通常是基于请求的IP地址、认证用户的ID,或者你自定义的任何字符串。例如,
throttle:60,1
缓存驱动器: Laravel的速率限制严重依赖于你的缓存配置。如果你使用Redis或Memcached,性能会非常好,因为它们是内存存储,读写速度快,而且支持原子操作,这对于并发请求下的计数器更新至关重要。如果使用文件缓存或数据库缓存,虽然也能工作,但在高并发场景下可能会有性能瓶颈,甚至出现竞态条件导致计数不准确(尽管Laravel会尽量规避)。我个人在生产环境中总是推荐使用Redis来处理速率限制。
判断与响应: 在每次请求时,
RateLimiter
throttle
TooManyRequestsHttpException
Retry-After
Retry-After
衰减与重置: 计数器并不会一直累加。当一个限制窗口结束时(例如,一分钟过去后),对应的缓存键就会过期,计数器会被自动重置。这就是“衰减”的概念。你配置的
perMinute(X)
perSecond(Y)
简单来说,它的工作流程就是:来一个请求 -youjiankuohaophpcn 检查缓存里有没有这个IP/用户的计数器 -> 有的话加1,没有就创建并设为1 -> 判断是否超过阈值 -> 没超就放行,超了就拒绝并告诉它多久再来。整个过程高效且可靠,很大程度上得益于底层的缓存系统。
在实际项目中,一刀切的速率限制策略往往不够用。比如,付费用户和免费用户、管理员和普通用户、图片上传接口和普通数据查询接口,它们对资源的需求和滥用的风险都不同。因此,定制化策略就显得尤为重要。
最灵活的方式,也是我最常用的方式,就是在
RouteServiceProvider
configureRateLimiting
1. 基于用户认证状态和角色:
你可以根据
$request->user()
use Illuminate\Cache\RateLimiting\Limit;
use Illuminate\Http\Request;
use Illuminate\Support\Facades\RateLimiter;
protected function configureRateLimiting()
{
// API限制:区分普通用户、VIP用户和未认证用户
RateLimiter::for('api', function (Request $request) {
if ($request->user()) {
if ($request->user()->isVip()) { // 假设用户模型有isVip方法
return Limit::perMinute(500)->by($request->user()->id); // VIP用户宽松
}
return Limit::perMinute(100)->by($request->user()->id); // 普通认证用户
}
return Limit::perMinute(60)->by($request->ip()); // 未认证用户按IP
});
// 针对管理员后台的API,通常限制可以更宽松,或者根本不限制(如果内部调用)
RateLimiter::for('admin-api', function (Request $request) {
if ($request->user() && $request->user()->isAdmin()) {
return Limit::perMinute(1000)->by($request->user()->id);
}
// 非管理员尝试访问管理员API,可以给一个很低的限制甚至直接拒绝
return Limit::perMinute(5)->by($request->ip());
});
}然后在路由中应用:
Route::middleware(['auth:api', 'throttle:api'])->group(function () {
// 普通API
});
Route::prefix('admin')->middleware(['auth:api', 'throttle:admin-api'])->group(function () {
// 管理员API
});2. 基于API端点或资源类型:
某些操作(如文件上传、创建新资源)可能比读取操作更耗费资源或更容易被滥用,所以它们需要更严格的限制。
protected function configureRateLimiting()
{
// ... 其他限制器
// 文件上传限制:防止用户短时间上传大量文件
RateLimiter::for('file-upload', function (Request $request) {
return Limit::perMinute(5)->by($request->user()->id ?: $request->ip());
});
// 搜索接口限制:搜索通常耗费数据库资源,可以单独限制
RateLimiter::for('search', function (Request $request) {
return Limit::perMinute(20)->by($request->user()->id ?: $request->ip());
});
}然后在路由中应用:
Route::post('/upload', [UploadController::class, 'store'])
->middleware('throttle:file-upload');
Route::get('/search', [SearchController::class, 'index'])
->middleware('throttle:search');3. 基于API Key:
如果你对外提供API服务,通常会给开发者分发API Key。你可以通过API Key来识别并限制请求。这需要你有一个API Key的验证中间件,并在其中将API Key信息注入到请求对象中。
// 假设你有一个中间件 ValidateApiKey,它会把api_key_id放入$request中
RateLimiter::for('api-key-access', function (Request $request) {
if ($request->has('api_key_id')) { // 假设API Key ID存在
// 根据API Key ID查询其对应的限制策略,例如:
// $apiKey = ApiKey::find($request->input('api_key_id'));
// return Limit::perMinute($apiKey->limit)->by($apiKey->id);
return Limit::perMinute(200)->by($request->input('api_key_id')); // 示例
}
return Limit::perMinute(10)->by($request->ip()); // 没有API Key的按IP限制
});路由应用:
Route::middleware(['validate.api.key', 'throttle:api-key-access'])->group(function () {
// 对外开放的API
});通过这些定制化的策略,我们可以根据业务场景的实际需求,灵活地为不同的用户和功能设置合适的速率限制,从而在保护系统资源的同时,也能提供良好的用户体验。这种细粒度的控制能力,是我认为Laravel速率限制机制最强大之处。
速率限制是一把双刃剑,用得好能保护系统,用得不好则可能损害用户体验。在我看来,理解它对两者的影响,并找到一个恰当的平衡点,是实现一个健壮应用的关键。
对用户体验的影响:
429 Too Many Requests
对系统性能的影响:
如何平衡用户体验与系统性能:
要在这两者之间找到最佳平衡点,需要策略性和持续的优化:
合理设置阈值:
友好的错误提示:
429
Retry-After
429
Retry-After
客户端策略:
429
提供缓冲或弹性:
Limit::perMinute(60)->by($request->ip())
透明的文档:
总而言之,速率限制并非一劳永逸的配置,它需要持续的关注、监控和迭代。只有在充分理解业务需求、用户行为和系统性能的前提下,才能找到那个既能有效保护系统,又能尽可能不影响用户体验的甜蜜点。
以上就是Laravel速率限制?请求限制如何设置?的详细内容,更多请关注php中文网其它相关文章!
每个人都需要一台速度更快、更稳定的 PC。随着时间的推移,垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是,许多工具可以让 Windows 保持平稳运行。
Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号