Laravel中间件是什么_中间件原理及在Laravel中的使用方法-php教程-PHP中文网

Laravel中间件是什么_中间件原理及在Laravel中的使用方法

看不見的法師

发布： 2025-11-22 05:21:22

原创

983人浏览过

Laravel中间件是处理HTTP请求的过滤机制，可在请求到达控制器前后执行逻辑，如认证、权限检查、日志记录等。它基于Pipeline模式，请求依次通过中间件，每个中间件可终止请求或继续传递。主要分为全局中间件（应用于所有请求）和路由中间件（绑定特定路由）。通过Artisan命令可创建中间件，并在Kernel.php中注册，再分配给路由或路由组。中间件支持参数传递，如role:admin用于权限控制。常用内置中间件包括auth、throttle、csrf等，有效提升应用安全性与代码复用性。

laravel中间件是什么_中间件原理及在laravel中的使用方法

Laravel中间件是一种用于过滤进入应用的HTTP请求的机制，可以看作是请求与应用之间的“检查站”。它让你在请求到达控制器之前或之后执行某些逻辑，比如验证用户是否登录、检查权限、记录日志、设置响应头等。中间件让开发者能够以模块化的方式处理横切关注点，提升代码的复用性和可维护性。

中间件的工作原理

当一个HTTP请求进入Laravel应用时，会经过路由系统，而中间件就注册在路由或全局请求处理流程中。Laravel使用Pipeline（管道）设计模式来处理中间件：请求依次通过每一个中间件，每个中间件可以选择允许请求继续向下传递，也可以中断请求并直接返回响应。

每个中间件本质上是一个类，包含一个handle方法，该方法接收请求对象和一个闭包（代表下一个中间件或最终的请求处理逻辑）。基本结构如下：

public function handle($request, Closure $next)
{
    // 请求前的逻辑（如检查权限）
    if (! $request->user()) {
        return redirect('login');
    }

    $response = $next($request); // 交给下一个中间件或控制器

    // 响应后的逻辑（如添加头部信息）
    return $response;
}

登录后复制

中间件的类型

Laravel支持两种主要类型的中间件：

黑色全屏自适应的H5模板

黑色全屏自适应的H5模板 HTML5的设计目的是为了在移动设备上支持多媒体。新的语法特征被引进以支持这一点，如video、audio和canvas 标记。HTML5还引进了新的功能，可以真正改变用户与文档的交互方式，包括：新的解析规则增强了灵活性淘汰过时的或冗余的属性一个HTML5文档到另一个文档间的拖放功能多用途互联网邮件扩展（MIME）和协议处理程序注册在SQL数据库中存

查看详情

全局中间件：对每一个HTTP请求都会执行，例如开启维护模式、设置语言环境等。
路由中间件：只绑定到特定路由或路由组，例如auth中间件用于保护需要登录的页面。

如何在Laravel中使用中间件

以下是中间件在Laravel中的常见使用方式：

创建中间件：使用Artisan命令生成中间件类：
```
php artisan make:middleware CheckAge
```
登录后复制
生成的文件位于app/Http/Middleware/CheckAge.php。
注册中间件：
- 在app/Http/Kernel.php中注册命名中间件，例如：
```
'age' => \App\Http\Middleware\CheckAge::class,
```
  登录后复制
- 也可将中间件加入全局中间件数组，使其对所有请求生效。

分配中间件到路由：

Route::get('/profile', function () {
    //
})->middleware('auth', 'age');

登录后复制

或使用路由组：

Route::middleware(['auth'])->group(function () {
    Route::get('/dashboard', ...);
    Route::post('/update', ...);
});

登录后复制

中间件参数：中间件还支持传参，例如：

Route::put('/post/{id}', function ($id) {
    //
})->middleware('role:editor');

登录后复制

在handle方法中接收参数：

public function handle($request, Closure $next, $role)
{
    if (! $request->user()->hasRole($role)) {
        return redirect('home');
    }
    return $next($request);
}

登录后复制