信息发布→ 登录 注册 退出

Laravel如何创建和注册中间件_Laravel中间件编写与应用流程

发布时间:2025-12-03

点击量:
中间件用于处理请求和响应,可通过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)。

标签:# function  # 也可  # 会在  # 适用于  # 多个  # 的是  # 复用  # 身份验证  # 绑定  # 三种  # 可在  # http  # this  # 对象  # laravel  # 闭包  # public  # class  # 构造函数  # if  # 中间件  # red  # laravel中间件  # 代码复用  # 路由  # app  # php  
在线客服
服务热线

服务热线

4008888355

微信咨询
二维码
返回顶部
×二维码

截屏,微信识别二维码

打开微信

微信号已复制,请打开微信添加咨询详情!