Laravel如何创建和注册中间件_Laravel中间件编写与应用流程
发表时间：2025-12-03 00:00:00
文章作者：冰火之心
浏览次数：
中间件用于处理请求和响应，可通过Artisan命令创建，如php artisan make:middleware CheckAge，生成的类中handle方法需调用$next($request)以继续流程；中间件需在Kernel.php中注册，支持全局、路由和组三种方式，注册后可在路由或控制器中使用，如middleware('age')，并可传递参数如middleware('role:admin,create-post')，适用于身份验证、日志等场景，提升代码复用与维护性。
在 Laravel 中，中间件是处理请求和响应的过滤器，
可用于身份验证、日志记录、权限检查等场景。创建和注册中间件是开发过程中常见的操作，下面详细介绍中间件的编写与应用流程。
创建中间件
Laravel 提供了 Artisan 命令快速生成中间件类：
php artisan make:middleware CheckAge执行后会在 app/Http/Middleware 目录下生成一个名为 CheckAge.php 的文件。打开该文件可以看到基本结构：
class CheckAge{
public function handle($request, $next)
{
if ($request->age return redirect('home');
}
return $next($request);
}
}
handle 方法接收请求对象和下一个中间件闭包。逻辑处理完成后必须调用 $next($request) 继续请求流程，否则请求会被中断。
注册中间件
中间件需注册后才能使用，Laravel 支持三种注册方式：
- 全局中间件：对所有请求生效。在 app/Http/Kernel.php 的 $middleware 属性中添加： '\\App\\Http\\Middleware\\CheckAge',
- 路由中间件：绑定名称后在路由中使用。在 Kernel.php 的 $routeMiddleware 数组中注册： 'age' => \App\Http\Middleware\CheckAge::class,
- 中间件组：将多个中间件组合使用。可在 $middlewareGroups 中定义如 web 或 api 组。
在路由中使用中间件
注册为路由中间件后，可在路由定义中使用：
Route::get('/profile', function () {//
})->middleware('age');
也可通过控制器构造函数绑定：
public function __construct(){
$this->middleware('age');
}
支持条件过滤，例如排除某些方法：
$this->middleware('age', ['except' => ['index']]);中间件参数传递
中间件支持接收额外参数。修改 handle 方法签名：
public function handle($request, $next, $role, $permission)在路由中传参：
->middleware('role:admin,create-post')注意参数从第三个位置开始传入，前两个固定为请求和 next 闭包。
基本上就这些。掌握中间件的创建、注册与使用方式，能有效组织请求处理逻辑，提升代码可维护性。实际开发中建议将通用逻辑抽象成中间件复用。不复杂但容易忽略的是记得调用 $next($request)。
