Laravel路由中间件是请求到达控制器前的过滤机制，可用于认证、授权、日志等操作。可通过全局、路由组、单个路由或控制器方式分配，执行顺序遵循“从外到内”原则：全局中间件 → 路由组中间件 → 单个/控制器中间件，响应时则逆序执行后续逻辑。
Laravel的路由中间件，在我看来，就像是HTTP请求抵达你应用核心逻辑（比如控制器方法）前的一道道关卡或守卫。它的核心作用，就是让你能在请求真正被处理之前或之后，执行一些预设的操作。至于如何分配路由，其实Laravel给了我们很多灵活的方式，无论是全局、针对一组路由，还是某个特定的路由，甚至是在控制器内部，都能精准地挂载中间件。
解决方案
要说如何在Laravel里分配中间件给路由，其实方法挺多的，每种都有它适用的场景。我个人觉得，理解这些不同的分配方式，是掌握Laravel请求生命周期的关键一步。
全局中间件 (Global Middleware)这是最粗放也最直接的方式，任何进入你应用的HTTP请求都会经过这些中间件。你可以在
app/Http/Kernel.php
文件的
$middleware
属性中定义它们。
// app/Http/Kernel.phpprotected $middleware = [ AppHttpMiddlewareTrustProxies::class, AppHttpMiddlewarePreventRequestsDuringMaintenance::class, IlluminateFoundationHttpMiddlewareValidatePostSize::class, AppHttpMiddlewareTrimStrings::class, IlluminateFoundationHttpMiddlewareConvertEmptyStringsToNull::class, // AppHttpMiddlewareEncryptCookies::class, // 假设我不想所有请求都加密cookie // ... 其他全局中间件];
坦白讲，全局中间件我用得不多，通常是那些对所有请求都生效的基础性操作，比如处理CORS、维护模式检查或者一些基础的请求数据处理。
路由组中间件 (Route Group Middleware)这是我个人最常用的一种方式，尤其是在构建API或者需要对一组相关路由应用相同策略时。通过
Route::middleware()
方法，你可以将一个或多个中间件应用到一个路由组上。
// routes/web.php 或 routes/api.phpRoute::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.phpRoute::get('/admin/settings', 'AdminController@showSettings')->middleware('admin');Route::post('/logout', 'AuthLoginController@logout')->middleware('auth');
这个方法很直观，适合那些有特殊需求的单个路由。但如果多个路由有相同需求，我肯定会考虑用路由组。
控制器中间件 (Controller Middleware)有时候，你可能希望一个控制器里的所有方法，或者部分方法，都经过某个中间件处理。这时候，可以在控制器的构造函数里定义。
// app/Http/Controllers/PostController.phpclass 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.phpprotected $middleware = [ // 1. 全局中间件 A AppHttpMiddlewareTrustProxies::class, // 2. 全局中间件 B AppHttpMiddlewarePreventRequestsDuringMaintenance::class,];protected $middlewareGroups = [ 'web' => [ // 3. Web组中间件 A AppHttpMiddlewareEncryptCookies::class, // 4. Web组中间件 B IlluminateSessionMiddlewareStartSession::class, ], 'api' => [ // 5. API组中间件 A LaravelSanctumHttpMiddlewareEnsureFrontendRequestsAreStateful::class, // 6. API组中间件 B 'throttle:api', ],];// routes/web.phpRoute::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命令：
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.phpprotected $routeMiddleware = [ 'auth' => AppHttpMiddlewareAuthenticate::class, 'verified' => AppHttpMiddlewareEnsureEmailIsVerified::class, 'my.logger' => AppHttpMiddlewareMyCustomLogger::class, // 注册你的自定义中间件 // ... 其他路由中间件];
注册后，你就可以像使用内置中间件一样，在路由或控制器中通过
my.logger
这个别名来应用它了：
Route::get('/some-path', 'SomeController@index')->middleware('my.logger');
或者，如果你想让它成为全局中间件，那么就把它添加到
$middleware
属性中：
// app/Http/Kernel.phpprotected $middleware = [ // ... AppHttpMiddlewareMyCustomLogger::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.phppublic 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.phpRoute::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.phppublic function handle(Request $request, Closure $next): Response{ if ($request->hasHeader('Accept-Language')) { App::setLocale($request->header('Accept-Language')); } return $next($request);}// ... 注册并应用
这些场景只是冰山一角。中间件的强大之处在于它提供了一个统一且可扩展的机制，来处理请求生命周期中的各种通用逻辑，让你的控制器能更专注于业务逻辑本身，从而实现代码的清晰、解耦和高内聚。
以上就是Laravel路由中间件？中间件如何分配路由？的详细内容，更多请关注php中文网其它相关文章！
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容， 请发送邮件至 chuangxiangniao@163.com 举报，一经查实，本站将立刻删除。
发布者：程序猿，转转请注明出处：https://www.chuangxiangniao.com/p/146792.html
微信扫一扫 
支付宝扫一扫 
