Laravel 8 路由分组与中间件应用指南

本教程将指导您如何在 laravel 8 中高效地组织路由，通过使用路由分组（route groups）功能，避免为每个路由重复定义中间件，从而提升代码的可读性和维护性。同时，还将介绍如何利用全局约束（global constraints）进一步简化路由参数的定义。

在 Laravel 应用程序开发中，为一系列路由应用相同的中间件（如认证中间件 auth）是常见的需求。然而，如果为每个路由单独添加 -youjiankuohaophpcnmiddleware('auth')，不仅会导致代码冗余，还会降低可读性和维护性。Laravel 提供了强大的路由分组功能，可以优雅地解决这个问题。

使用路由分组应用公共中间件

Laravel 的路由分组允许您将一组具有相同属性（如中间件、前缀、命名空间等）的路由集合起来。要为一组路由应用公共中间件，可以使用 Route::middleware() 方法结合 group() 方法。

原始的重复定义方式：

考虑以下路由定义，每个路由都单独应用了 auth 中间件：

Route::get('/', [PagesController::class,'index'])
    ->middleware('auth');

Route::get('edit/{id}', [PagesController::class,'editPage'])
    ->middleware('auth')
    ->where('id', '[0-9]+');

Route::post('edit/{id}', [PagesController::class,'editItem'])
    ->middleware('auth')
    ->where('id', '[0-9]+');

Route::get('delete/{id}', [PagesController::class,'deletePage'])
    ->middleware('auth')
    ->where('id', '[0-9]+');

Route::post('delete/{id}', [PagesController::class,'deleteItem'])
    ->middleware('auth')
    ->where('id', '[0-9]+');

这种方式在路由数量增多时，维护成本会急剧上升。

使用路由分组优化：

通过将这些路由包裹在一个 middleware 组中，可以避免重复定义中间件。所有在 group() 回调函数内部定义的路由都将自动应用该中间件。

use App\Http\Controllers\PagesController;
use Illuminate\Support\Facades\Route;

Route::middleware(['auth'])->group(function () {
    Route::get('/', [PagesController::class,'index']);

    Route::get('edit/{id}', [PagesController::class,'editPage'])
        ->where('id', '[0-9]+');

    Route::post('edit/{id}', [PagesController::class,'editItem'])
        ->where('id', '[0-9]+');

    Route::get('delete/{id}', [PagesController::class,'deletePage'])
        ->where('id', '[0-9]+');

    Route::post('delete/{id}', [PagesController::class,'deleteItem'])
        ->where('id', '[0-9]+');
});

// 如果有其他非认证路由，可以在分组外部定义
// require __DIR__.'/auth.php'; // Laravel 8 默认的认证路由文件

优点：

• 代码简洁： 避免了重复的 ->middleware('auth') 调用。
• 易于维护： 如果需要更改或移除中间件，只需修改一处即可。
• 可读性强： 路由的逻辑结构更加清晰，一目了然地知道哪些路由受同一组中间件保护。

利用全局约束简化路由参数

在上述示例中，我们多次为 id 参数定义了 ->where('id', '[0-9]+') 约束，以确保 id 始终是数字。Laravel 的全局约束（Global Constraints）功能允许您在全局范围内为特定的路由参数定义模式，从而避免在每个路由上重复定义。

AppMall应用商店

AI应用商店，提供即时交付、按需付费的人工智能应用服务

56

查看详情

要定义全局约束，您可以在 app/Providers/RouteServiceProvider.php 文件的 boot 方法中添加 Route::pattern() 调用。

定义全局 id 约束：

打开 app/Providers/RouteServiceProvider.php 文件，并在 boot 方法中添加以下代码：

// app/Providers/RouteServiceProvider.php

use Illuminate\Support\Facades\Route;

public function boot()
{
    // ... 其他代码

    Route::pattern('id', '[0-9]+'); // 定义所有名为 'id' 的路由参数必须是数字

    // ... 其他代码
}

使用全局约束后的路由：

一旦定义了全局约束，所有使用 id 参数的路由将自动应用此模式，无需再使用 ->where() 方法：

use App\Http\Controllers\PagesController;
use Illuminate\Support\Facades\Route;

Route::middleware(['auth'])->group(function () {
    Route::get('/', [PagesController::class,'index']);

    // 'id' 参数将自动匹配 '[0-9]+'
    Route::get('edit/{id}', [PagesController::class,'editPage']);

    Route::post('edit/{id}', [PagesController::class,'editItem']);

    Route::get('delete/{id}', [PagesController::class,'deletePage']);

    Route::post('delete/{id}', [PagesController::class,'deleteItem']);
});

优点：

• 极致简化： 路由定义更加简洁，只关注路径和控制器动作。
• 全局一致性： 确保特定参数在整个应用中遵循相同的验证规则。
• 减少错误： 避免因在不同路由中定义不同模式而导致的潜在问题。

高级用法与注意事项

1. 多个中间件： 您可以通过数组形式为路由组应用多个中间件：

   Route::middleware(['auth', 'admin'])->group(function () {
       // ... 路由
   });

   登录后复制

2. 嵌套路由分组： 路由分组可以嵌套，内部的分组会继承外部分组的属性，并可以添加自己的属性。

   Route::middleware(['auth'])->group(function () {
       Route::get('/dashboard', [DashboardController::class, 'index']);
   
       Route::prefix('admin')->middleware(['admin'])->group(function () {
           // 此组内的路由将同时应用 'auth' 和 'admin' 中间件，并带有 'admin' 前缀
           Route::get('/users', [AdminController::class, 'users']);
       });
   });

   登录后复制

3. 其他分组属性： 除了 middleware，路由分组还可以使用 prefix (路由前缀)、name (路由命名空间前缀)、namespace (控制器命名空间前缀) 等属性。

4. 路由缓存： 在生产环境中，请务必使用 php artisan route:cache 命令来缓存路由，以提高性能。路由分组和全局约束在缓存后依然有效。

总结

通过合理利用 Laravel 的路由分组和全局约束功能，开发者可以显著提升路由定义的清晰度、可维护性和开发效率。路由分组是管理具有共同属性的路由集合的强大工具，而全局约束则进一步简化了路由参数的定义。掌握这些技巧，将使您的 Laravel 应用程序的路由层更加健壮和易于管理。

以上就是Laravel 8 路由分组与中间件应用指南的详细内容，更多请关注php中文网其它相关文章！