
本教程将指导您如何在 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 AppHttpControllersPagesController;use IlluminateSupportFacadesRoute;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.phpuse IlluminateSupportFacadesRoute;public function boot(){ // ... 其他代码 Route::pattern('id', '[0-9]+'); // 定义所有名为 'id' 的路由参数必须是数字 // ... 其他代码}
使用全局约束后的路由:
一旦定义了全局约束,所有使用 id 参数的路由将自动应用此模式,无需再使用 ->where() 方法:
use AppHttpControllersPagesController;use IlluminateSupportFacadesRoute;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 应用程序的路由层更加健壮和易于管理。
以上就是Laravel 8 路由分组与中间件应用指南的详细内容,更多请关注php中文网其它相关文章!
版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容, 请发送邮件至 chuangxiangniao@163.com 举报,一经查实,本站将立刻删除。
发布者:程序猿,转转请注明出处:https://www.chuangxiangniao.com/p/1328069.html
微信扫一扫
支付宝扫一扫