本教程将指导您如何在 laravel 8 中高效地组织路由，通过使用路由分组（route groups）功能，避免为每个路由重复定义中间件，从而提升代码的可读性和维护性。同时，还将介绍如何利用全局约束（global constraints）进一步简化路由参数的定义。
在 Laravel 应用程序开发中，为一系列路由应用相同的中间件（如认证中间件 auth）是常见的需求。然而，如果为每个路由单独添加 ->middleware('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）功能允许您在全局范围内为特定的路由参数定义模式，从而避免在每个路由上重复定义。
要定义全局约束，您可以在 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']);
});优点：
- 极致简化： 路由定义更加简洁，只关注路径和控制器动作。
- 全局一致性： 确保特定参数在整个应用中遵循相同的验证规则。
- 减少错误： 避免因在不同路由中定义不同模式而导致的潜在问题。
高级用法与注意事项
-
多个中间件： 您可以通过数组形式为路由组应用多个中间件：
Route::middleware(['auth', 'admin'])->group(function () { // ... 路由 }); -
嵌套路由分组： 路由分组可以嵌套，内部的分组会继承外部分组的属性，并可以添加自己的属性。
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']); }); }); 其他分组属性： 除了 middleware，路由分组还可以使用 prefix (路由前缀)、name (路由命名空间前缀)、namespace (控制器命名空间前缀) 等属性。
路由缓存： 在生产环境中，请务必使用 php artisan route:cache 命令来缓存路由，以提高性能。路由分组和全局约束在缓存后依然有效。
总结
通过合理利用 Laravel 的路由分组和全局约束功能，开发者可以显著提升路由定义的清晰度、可维护性和开发效率。路由分组是管理具有共同属性的路由集合的强大工具，而全局约束则进一步简化了路由参数的定义。掌握这些技巧，将使您的 Laravel 应用程序的路由层更加健壮和易于管理。
