Laravel路由中间件？中间件如何分配路由？

畫卷琴夢

发布时间：2025-09-16 08:40:02

325人浏览过

来源于php中文网

原创

Laravel路由中间件是请求到达控制器前的过滤机制，可用于认证、授权、日志等操作。可通过全局、路由组、单个路由或控制器方式分配，执行顺序遵循“从外到内”原则：全局中间件 → 路由组中间件 → 单个/控制器中间件，响应时则逆序执行后续逻辑。

laravel路由中间件？中间件如何分配路由？

Laravel的路由中间件，在我看来，就像是HTTP请求抵达你应用核心逻辑（比如控制器方法）前的一道道关卡或守卫。它的核心作用，就是让你能在请求真正被处理之前或之后，执行一些预设的操作。至于如何分配路由，其实Laravel给了我们很多灵活的方式，无论是全局、针对一组路由，还是某个特定的路由，甚至是在控制器内部，都能精准地挂载中间件。

解决方案

要说如何在Laravel里分配中间件给路由，其实方法挺多的，每种都有它适用的场景。我个人觉得，理解这些不同的分配方式，是掌握Laravel请求生命周期的关键一步。

全局中间件 (Global Middleware) 这是最粗放也最直接的方式，任何进入你应用的HTTP请求都会经过这些中间件。你可以在

app/Http/Kernel.php

文件的

$middleware

属性中定义它们。

// app/Http/Kernel.php

protected $middleware = [
    \App\Http\Middleware\TrustProxies::class,
    \App\Http\Middleware\PreventRequestsDuringMaintenance::class,
    \Illuminate\Foundation\Http\Middleware\ValidatePostSize::class,
    \App\Http\Middleware\TrimStrings::class,
    \Illuminate\Foundation\Http\Middleware\ConvertEmptyStringsToNull::class,
    // \App\Http\Middleware\EncryptCookies::class, // 假设我不想所有请求都加密cookie
    // ... 其他全局中间件
];

坦白讲，全局中间件我用得不多，通常是那些对所有请求都生效的基础性操作，比如处理CORS、维护模式检查或者一些基础的请求数据处理。

路由组中间件 (Route Group Middleware) 这是我个人最常用的一种方式，尤其是在构建API或者需要对一组相关路由应用相同策略时。通过

Route::middleware()

方法，你可以将一个或多个中间件应用到一个路由组上。

// routes/web.php 或 routes/api.php

Route::middleware(['auth', 'verified'])->group(function () {
    Route::get('/dashboard', function () {
        // 需要认证且邮箱已验证才能访问
    });

    Route::get('/profile', 'UserProfileController@show');
});

// 也可以是多个中间件链式调用
Route::middleware('auth')->middleware('throttle:60,1')->group(function () {
    Route::post('/order', 'OrderController@store');
});

这种方式的好处在于，它能让你的路由文件看起来更整洁，逻辑也更清晰。想象一下，如果每个路由都单独写

->middleware('auth')

，那代码得多冗余啊。

单个路由中间件 (Individual Route Middleware) 如果你只想给某个特定的路由应用中间件，直接在路由定义后面链式调用
```
middleware()
```
方法就行。
```
// routes/web.php

Route::get('/admin/settings', 'AdminController@showSettings')->middleware('admin');

Route::post('/logout', 'Auth\LoginController@logout')->middleware('auth');
```
这个方法很直观，适合那些有特殊需求的单个路由。但如果多个路由有相同需求，我肯定会考虑用路由组。

控制器中间件 (Controller Middleware) 有时候，你可能希望一个控制器里的所有方法，或者部分方法，都经过某个中间件处理。这时候，可以在控制器的构造函数里定义。

// app/Http/Controllers/PostController.php

class PostController extends Controller
{
    public function __construct()
    {
        $this->middleware('auth'); // 所有方法都需要认证
        $this->middleware('can:update,post')->only('edit', 'update'); // 只有edit和update方法需要授权
        $this->middleware('log.access')->except('show'); // 除了show方法，其他方法都要记录访问日志
    }

    public function index() { /* ... */ }
    public function create() { /* ... */ }
    public function store() { /* ... */ }
    public function show(Post $post) { /* ... */ }
    public function edit(Post $post) { /* ... */ }
    public function update(Request $request, Post $post) { /* ... */ }
    public function destroy(Post $post) { /* ... */ }
}

我个人觉得控制器中间件非常方便，尤其是在处理资源控制器（Resource Controllers）时，它能让你在控制器层面进行更细粒度的控制，避免了路由文件过于臃肿。

only()

和

except()

方法的组合拳，更是让这种控制变得异常强大。

Laravel中间件的执行顺序是怎样的？

说实话，中间件的执行顺序是个常常让人感到困惑，但又极其重要的问题。理解它，能帮你更好地调试请求流程，避免一些意想不到的行为。在我看来，Laravel中间件的执行顺序，可以大致概括为“从外到内，再从内到外”的原则。

具体来说，当一个HTTP请求进入Laravel应用时，它会首先经过

app/Http/Kernel.php

中

$middleware

属性里定义的全局中间件。这些中间件是所有请求的“必经之路”，它们按照你在数组中定义的顺序依次执行。

紧接着，如果请求命中了某个路由组，那么这个路由组上挂载的中间件会开始执行。这些中间件的执行顺序，就是你在

Route::middleware([...])

数组中定义的顺序。

再往里走，如果路由组内的某个具体路由还单独挂载了中间件，或者你是在控制器构造函数里为特定方法定义了中间件，那么这些中间件会在路由组中间件之后执行。同样，它们的顺序也取决于定义时的顺序。

总结一下，一个请求的中间件执行顺序大概是：

全局中间件 (Kernel.php
```
$middleware
```
)
路由中间件组 (Kernel.php
```
$middlewareGroups
```
，如果路由使用了组别，如
```
web
```
或
```
api
```
)
路由组中间件 (
```
Route::middleware([...])->group()
```
)
单个路由中间件 (
```
->middleware()
```
) 或 控制器中间件 (
```
$this->middleware()
```
)

值得一提的是，中间件的

handle

方法在请求到达控制器之前执行，而中间件中的

terminate

方法（如果你定义了的话）则是在HTTP响应发送给浏览器之后才执行。这意味着

terminate

方法非常适合做一些清理、日志记录等不影响响应速度的操作。

// app/Http/Kernel.php
protected $middleware = [
    // 1. 全局中间件 A
    \App\Http\Middleware\TrustProxies::class,
    // 2. 全局中间件 B
    \App\Http\Middleware\PreventRequestsDuringMaintenance::class,
];

protected $middlewareGroups = [
    'web' => [
        // 3. Web组中间件 A
        \App\Http\Middleware\EncryptCookies::class,
        // 4. Web组中间件 B
        \Illuminate\Session\Middleware\StartSession::class,
    ],
    'api' => [
        // 5. API组中间件 A
        \Laravel\Sanctum\Http\Middleware\EnsureFrontendRequestsAreStateful::class,
        // 6. API组中间件 B
        'throttle:api',
    ],
];

// routes/web.php
Route::middleware(['auth', 'check.role:admin'])->group(function () {
    // 7. 路由组中间件 auth
    // 8. 路由组中间件 check.role:admin
    Route::get('/admin', 'AdminController@index')->middleware('log.activity');
    // 9. 单个路由中间件 log.activity
});

所以，请求的实际路径是：全局A -> 全局B -> Web组A -> Web组B -> auth -> check.role:admin -> log.activity -> 控制器方法。然后响应回来的时候，这个顺序会反过来执行中间件的后续逻辑（如果

handle

方法中有

$next($request)

之后的代码）和

terminate

方法。这种层层嵌套的机制，是Laravel中间件强大灵活的基础。

如何在Laravel中创建和注册自定义中间件？

创建和注册自定义中间件，是Laravel开发中非常常见且实用的操作。它允许你根据自己的业务需求，定制请求处理流程中的任何环节。

首先，创建中间件非常简单，Laravel提供了一个Artisan命令：

Interior AI

AI室内设计，上传室内照片自动帮你生成多种风格的室内设计图

下载

php artisan make:middleware MyCustomLogger

执行这个命令后，Laravel会在

app/Http/Middleware

目录下生成一个名为

MyCustomLogger.php

的文件。文件内容大致如下：

method() . ' ' . $request->fullUrl());

        $response = $next($request); // 将请求传递给下一个中间件或控制器

        // 在请求离开控制器之后执行的逻辑
        // 比如，记录响应状态码
        \Log::info('Outgoing response status: ' . $response->getStatusCode());

        return $response;
    }
}

handle

方法是中间件的核心。它接收两个参数：

$request

（当前的HTTP请求）和

$next

（一个闭包，代表请求流中的下一个处理者，可能是另一个中间件，也可能是控制器）。

```
$next($request)
```
之前的代码，会在请求到达控制器之前执行。
```
$next($request)
```
之后的代码，会在控制器处理完请求并生成响应之后，但在响应返回给客户端之前执行。

接下来是注册。自定义中间件创建好之后，你需要让Laravel知道它的存在。这通常在

app/Http/Kernel.php

文件中完成。

如果你想将它注册为路由中间件（即可以通过别名在路由或控制器中使用），你需要把它添加到

$routeMiddleware

属性中：

// app/Http/Kernel.php

protected $routeMiddleware = [
    'auth' => \App\Http\Middleware\Authenticate::class,
    'verified' => \App\Http\Middleware\EnsureEmailIsVerified::class,
    'my.logger' => \App\Http\Middleware\MyCustomLogger::class, // 注册你的自定义中间件
    // ... 其他路由中间件
];

注册后，你就可以像使用内置中间件一样，在路由或控制器中通过

my.logger

这个别名来应用它了：

Route::get('/some-path', 'SomeController@index')->middleware('my.logger');

或者，如果你想让它成为全局中间件，那么就把它添加到

$middleware

属性中：

// app/Http/Kernel.php

protected $middleware = [
    // ...
    \App\Http\Middleware\MyCustomLogger::class, // 作为全局中间件注册
];

一旦注册为全局中间件，所有进入应用的请求都会经过

MyCustomLogger

处理。选择哪种注册方式，完全取决于你的业务需求。大多数情况下，我更倾向于注册为路由中间件，这样可以更灵活地控制哪些请求需要经过我的自定义逻辑。

Laravel中间件在实际项目中常见的应用场景有哪些？

在实际的Laravel项目开发中，中间件几乎无处不在，它的设计哲学就是为了让你能优雅地解耦请求处理前的各种“横切关注点”。在我看来，中间件是构建健壮、可维护的Laravel应用不可或缺的一部分。

这里我列举一些我个人在项目中经常用到，或者觉得非常典型的应用场景：

用户认证 (Authentication)：这是最常见也是最重要的应用。Laravel内置的
```
auth
```
中间件就是为此而生。它会检查用户是否已登录。如果未登录，通常会重定向到登录页面或返回未认证的响应。
```
Route::middleware('auth')->group(function () {
    Route::get('/dashboard', 'DashboardController@index');
    // ... 其他需要登录才能访问的路由
});
```
对于API，
```
auth:api
```
或
```
auth:sanctum
```
则是验证API令牌或会话的利器。
用户授权 (Authorization)：在用户认证之后，你可能还需要检查用户是否有权限执行某个操作。Laravel的
```
can
```
中间件结合了策略（Policies）或门面（Gates）来实现授权。
```
Route::get('/posts/{post}/edit', 'PostController@edit')->middleware('can:update,post');
```
这里
```
can:update,post
```
会检查当前用户是否有权限更新传入的
```
post
```
模型。
CSRF 保护 (CSRF Protection)： Laravel的
```
VerifyCsrfToken
```
中间件是默认开启的全局中间件，它能有效防止跨站请求伪造攻击，确保所有非GET请求都带有有效的CSRF令牌。这个真的非常省心，我们几乎不用操心。
请求限流 (Rate Limiting)：对于API接口，为了防止恶意攻击或资源滥用，限流是必不可少的。Laravel的
```
throttle
```
中间件可以轻松实现。
```
Route::middleware('throttle:60,1')->group(function () { // 每分钟最多60次请求
    Route::post('/api/submit-form', 'ApiController@submit');
});
```
这能很好地保护你的后端服务。
维护模式 (Maintenance Mode)：当你的应用需要进行升级或维护时，
```
PreventRequestsDuringMaintenance
```
中间件能让所有请求都重定向到一个维护页面，直到你关闭维护模式。这也是一个默认的全局中间件，非常实用。
日志记录与审计 (Logging & Auditing)：我上面自定义的
```
MyCustomLogger
```
就是一个很好的例子。你可以在中间件中记录请求的详细信息（如IP、User-Agent、请求路径、请求参数），或者记录响应状态、执行时间等，用于监控和审计。

API 密钥验证 (API Key Validation)：如果你在构建一个公共API，可能需要验证请求头中是否包含有效的API Key。

// app/Http/Middleware/VerifyApiKey.php
public function handle(Request $request, Closure $next): Response
{
    if (!$request->header('X-API-Key') || !$this->isValidApiKey($request->header('X-API-Key'))) {
        return response()->json(['message' => 'Unauthorized: Invalid API Key'], 401);
    }
    return $next($request);
}

// routes/api.php
Route::middleware('verify.api.key')->group(function () {
    Route::get('/api/data', 'ApiController@getData');
});

数据预处理与清理 (Data Preprocessing & Sanitization)：例如，将所有字符串输入自动去除首尾空格 (
```
TrimStrings
```
中间件)，或者将空字符串转换为
```
null
```
(
```
ConvertEmptyStringsToNull
```
中间件)。这些都是Laravel默认提供的，极大提高了开发效率和数据一致性。
语言本地化 (Localization)：根据用户的请求头（如
```
Accept-Language
```
）或者URL参数，动态设置应用的语言环境。
```
// app/Http/Middleware/SetLocale.php
public function handle(Request $request, Closure $next): Response
{
    if ($request->hasHeader('Accept-Language')) {
        \App::setLocale($request->header('Accept-Language'));
    }
    return $next($request);
}
// ... 注册并应用
```
这些场景只是冰山一角。中间件的强大之处在于它提供了一个统一且可扩展的机制，来处理请求生命周期中的各种通用逻辑，让你的控制器能更专注于业务逻辑本身，从而实现代码的清晰、解耦和高内聚。