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

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

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

解决方案

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

1. 全局中间件 (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、维护模式检查或者一些基础的请求数据处理。

2. 路由组中间件 (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')

   登录后复制
   ，那代码得多冗余啊。

3. 单个路由中间件 (Individual Route Middleware) 如果你只想给某个特定的路由应用中间件，直接在路由定义后面链式调用

   middleware()

   登录后复制
   方法就行。

   // routes/web.php
   
   Route::get('/admin/settings', 'AdminController@showSettings')->middleware('admin');
   
   Route::post('/logout', 'Auth\LoginController@logout')->middleware('auth');

   登录后复制

   这个方法很直观，适合那些有特殊需求的单个路由。但如果多个路由有相同需求，我肯定会考虑用路由组。

4. 控制器中间件 (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([...])

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

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

1. 全局中间件 (Kernel.php

   $middleware

   登录后复制
   )
2. 路由中间件组 (Kernel.php

   $middlewareGroups

   登录后复制
   ，如果路由使用了组别，如

   web

   登录后复制
   或

   api

   登录后复制
   )
3. 路由组中间件 (

   Route::middleware([...])->group()

   登录后复制
   )
4. 单个路由中间件 (

   ->middleware()

   登录后复制
   ) 或 控制器中间件 (

   $this->middleware()

   登录后复制
   )

值得一提的是，中间件的

handle

terminate

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提供了一个Artisan命令：

AI Sofiya

一款AI驱动的多功能工具

109

查看详情

php artisan make:middleware MyCustomLogger

执行这个命令后，Laravel会在

app/Http/Middleware

MyCustomLogger.php

<?php

namespace App\Http\Middleware;

use Closure;
use Illuminate\Http\Request;
use Symfony\Component\HttpFoundation\Response;

class MyCustomLogger
{
    /**
     * Handle an incoming request.
     *
     * @param  \Illuminate\Http\Request  $request
     * @param  \Closure(\Illuminate\Http\Request): (\Symfony\Component\HttpFoundation\Response)  $next
     * @return \Symfony\Component\HttpFoundation\Response
     */
    public function handle(Request $request, Closure $next): Response
    {
        // 在请求到达控制器之前执行的逻辑
        // 比如，记录请求信息
        \Log::info('Incoming request: ' . $request->method() . ' ' . $request->fullUrl());

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

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

        return $response;
    }
}

handle

$request

$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应用不可或缺的一部分。

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

1. 用户认证 (Authentication)： 这是最常见也是最重要的应用。Laravel内置的

   auth

   登录后复制
   中间件就是为此而生。它会检查用户是否已登录。如果未登录，通常会重定向到登录页面或返回未认证的响应。

   Route::middleware('auth')->group(function () {
       Route::get('/dashboard', 'DashboardController@index');
       // ... 其他需要登录才能访问的路由
   });

   登录后复制

   对于API，

   auth:api

   登录后复制
   或

   auth:sanctum

   登录后复制
   则是验证API令牌或会话的利器。

2. 用户授权 (Authorization)： 在用户认证之后，你可能还需要检查用户是否有权限执行某个操作。Laravel的

   can

   登录后复制
   中间件结合了策略（Policies）或门面（Gates）来实现授权。

   Route::get('/posts/{post}/edit', 'PostController@edit')->middleware('can:update,post');

   登录后复制

   这里

   can:update,post

   登录后复制
   会检查当前用户是否有权限更新传入的

   post

   登录后复制
   模型。

3. CSRF 保护 (CSRF Protection)： Laravel的

   VerifyCsrfToken

   登录后复制
   中间件是默认开启的全局中间件，它能有效防止跨站请求伪造攻击，确保所有非GET请求都带有有效的CSRF令牌。这个真的非常省心，我们几乎不用操心。

4. 请求限流 (Rate Limiting)： 对于API接口，为了防止恶意攻击或资源滥用，限流是必不可少的。Laravel的

   throttle

   登录后复制
   中间件可以轻松实现。

   Route::middleware('throttle:60,1')->group(function () { // 每分钟最多60次请求
       Route::post('/api/submit-form', 'ApiController@submit');
   });

   登录后复制

   这能很好地保护你的后端服务。

5. 维护模式 (Maintenance Mode)： 当你的应用需要进行升级或维护时，

   PreventRequestsDuringMaintenance

   登录后复制
   中间件能让所有请求都重定向到一个维护页面，直到你关闭维护模式。这也是一个默认的全局中间件，非常实用。

6. 日志记录与审计 (Logging & Auditing)： 我上面自定义的

   MyCustomLogger

   登录后复制
   就是一个很好的例子。你可以在中间件中记录请求的详细信息（如IP、User-Agent、请求路径、请求参数），或者记录响应状态、执行时间等，用于监控和审计。

7. 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');
   });

   登录后复制

8. 数据预处理与清理 (Data Preprocessing & Sanitization)： 例如，将所有字符串输入自动去除首尾空格 (

   TrimStrings

   登录后复制
   中间件)，或者将空字符串转换为

   null

   登录后复制
   (

   ConvertEmptyStringsToNull

   登录后复制
   中间件)。这些都是Laravel默认提供的，极大提高了开发效率和数据一致性。

9. 语言本地化 (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);
   }
   // ... 注册并应用

   登录后复制

   这些场景只是冰山一角。中间件的强大之处在于它提供了一个统一且可扩展的机制，来处理请求生命周期中的各种通用逻辑，让你的控制器能更专注于业务逻辑本身，从而实现代码的清晰、解耦和高内聚。

以上就是Laravel路由中间件？中间件如何分配路由？的详细内容，更多请关注php中文网其它相关文章！