Laravel如何进行路由分组?6 种路由组织技术分享

Laravel如何进行路由分组?6 种路由组织技术分享

Laravel 路由是开发人员从一开始就学习的特性。但是随着他们项目的增长,管理不断增长的路由文件变得越来越困难,经常需要滚动查找正确的 Route::get() 语句。幸运的是,有一些技术可以使路由文件更短、更易读,让我们来看看以不同的方式对路由及其设置进行分组。

我们不会只谈论一般简单的 Route::group(),那是初学者级别。 让我们再深入一点。

分组 1. Route::resource 和 Route::apiResource

让我们从房间里的大象开始:这可能是最常用的分组。如果您围绕一个模型有一组典型的 CRUD 操作,则应该将它们分组到 资源控制器

此类控制器包含 多达 7 种方法(但可能更少):

index()create()store()show()edit()update()destroy()

因此,如果您的路由集对应于这些方法,请不要使用:

Route::get('books', [BookController::class, 'index'])->name('books.index');Route::get('books/create', [BookController::class, 'create'])->name('books.create');Route::post('books', [BookController::class, 'store'])->name('books.store');Route::get('books/{book}', [BookController::class, 'show'])->name('books.show');Route::get('books/{book}/edit', [BookController::class, 'edit'])->name('books.edit');Route::put('books/{book}', [BookController::class, 'update'])->name('books.update');Route::delete('books/{book}', [BookController::class, 'destroy'])->name('books.destroy');

… 您可能只有一行:

Route::resource('books', BookController::class);

如果您使用 API 项目,则不需要用于创建 / 编辑的可视化表单,因此您可以使用 apiResource() 的涵盖 7 种方法中的 5 种不同语法:

Route::apiResource('books', BookController::class);

此外,我建议您考虑资源控制器,即使您有 2-4 个方法,而不是完整的 7 个。只是因为它保持标准命名约定 – 对于 URL、方法和路由名称。 例如,在这种情况下,您不需要手动提供名称:

Route::get('books/create', [BookController::class, 'create'])->name('books.create');Route::post('books', [BookController::class, 'store'])->name('books.store');// 相反,这里的名称“books.create”和“books.store”是自动分配的Route::resource('books', BookController::class)->only(['create', 'store']);

分组 2.  嵌套子路由组

当然,一般的 路由分组 大家都知道。 但对于更复杂的项目,一级分组可能还不够。

实际示例:您希望授权路由与 auth 中间件进行分组,但在内部您需要分隔更多子组,例如管理员和简单用户。

Route::middleware('auth')->group(function() {    Route::middleware('is_admin')->prefix('admin')->group(function() {     Route::get(...) // administrator routes    });    Route::middleware('is_user')->prefix('user')->group(function() {     Route::get(...) // user routes    });});

分组 3. 将重复的中间件分组

如果你有很多中间件,有一些在路由组中重复出现怎么办?

Route::prefix('students')->middleware(['auth', 'check.role', 'check.user.status', 'check.invoice.status', 'locale'])->group(function () {    // ... 学生路由});Route::prefix('managers')->middleware(['auth', 'check.role', 'check.user.status', 'locale'])->group(function () {    // ... 管理员路由});

如您所见,有 5 个中间件,其中 4 个是重复的。因此,在 app/Http/Kernel.php 文件里,我们可以将这 4 个移动到单独的中间件组中:

protected $middlewareGroups = [    // 此组是 Laravel 默认中间件组    'web' => [        AppHttpMiddlewareEncryptCookies::class,        IlluminateCookieMiddlewareAddQueuedCookiesToResponse::class,        IlluminateSessionMiddlewareStartSession::class,        IlluminateViewMiddlewareShareErrorsFromSession::class,        AppHttpMiddlewareVerifyCsrfToken::class,        IlluminateRoutingMiddlewareSubstituteBindings::class,    ],    // 此组是 Laravel 默认中间件组    'api' => [        // LaravelSanctumHttpMiddlewareEnsureFrontendRequestsAreStateful::class,        'throttle:api',        IlluminateRoutingMiddlewareSubstituteBindings::class,    ],    // 这是我们新的中间件组    'check_user' => [        'auth',        'check.role',        'check.user.status',        'locale'    ],];

所以将我们的中间件组命明为 check_user,现在我们可以缩写路由:

Route::prefix('students')->middleware(['check_user', 'check.invoice.status'])->group(function () {    // ... student routes});Route::prefix('managers')->middleware(['check_user'])->group(function () {    // ... manager routes});

分组 4. 同名控制器,不同命名空间

很常见的情况是,例如,为不同的用户角色设置了 HomeController,例如 Admin/HomeControllerUser/HomeController。 如果在路由中使用完整路径,它看起来像这样:

Route::prefix('admin')->middleware('is_admin')->group(function () {    Route::get('home', [AppHttpControllersAdminHomeController::class, 'index']);});Route::prefix('user')->middleware('is_user')->group(function () {    Route::get('home', [AppHttpControllersUserHomeController::class, 'index']);});

每个控制器都是用了完整的路径这看上去很冗余,对吧? 这就是为什么许多开发人员更喜欢在路由列表中只包含 HomeController::class 并在顶部添加类似这样的内容:

use AppHttpControllersAdminHomeController;

但是这里的问题是我们有相同的控制器类名! 所以,这行不通:

use AppHttpControllersAdminHomeController;use AppHttpControllersUserHomeController;

哪一个是「管理后台」的控制器?好吧,一种方法是更改名称并为其中之一分配别名:

use AppHttpControllersAdminHomeController as AdminHomeController;use AppHttpControllersUserHomeController;Route::prefix('admin')->middleware('is_admin')->group(function () {    Route::get('home', [AdminHomeController::class, 'index']);});Route::prefix('user')->middleware('is_user')->group(function () {    Route::get('home', [HomeController::class, 'index']);});

但是,就个人而言,更改顶部类的名称让我很困惑,我喜欢另一种方法:为控制器的子文件夹添加一个命名空间():

Route::prefix('admin')->namespace('AppHttpControllersAdmin')->middleware('is_admin')->group(function () {    Route::get('home', [HomeController::class, 'index']);    // ... Admin 命名空间中的其他控制器});Route::prefix('user')->namespace('AppHttpControllersUser')->middleware('is_user')->group(function () {    Route::get('home', [HomeController::class, 'index']);    // ... 来自用户命名空间的其他控制器});

分组 5. 分离路由文件

如果你觉得 routes/web.phproutes/api.php 太大了,可以把一些路由放到一个单独的文件中,你可以为它任意命名,例如 routes/admin.php

要加载该文件,有两种方法:我称之为 「Laravel 方式」 和 「PHP 方式」 。

如果你想遵循 Laravel 构建其默认路由文件的结构,查看 app/Providers/RouteServiceProvider.php

public function boot(){    $this->configureRateLimiting();    $this->routes(function () {        Route::middleware('api')            ->prefix('api')            ->group(base_path('routes/api.php'));        Route::middleware('web')            ->group(base_path('routes/web.php'));    });}

routes/api.phproutes/web.php 都在这里,但设置略有不同。因此,你只需要在此处添加 admin 文件:

$this->routes(function () {    Route::middleware('api')        ->prefix('api')        ->group(base_path('routes/api.php'));    Route::middleware('web')        ->group(base_path('routes/web.php'));    Route::middleware('is_admin')        ->group(base_path('routes/admin.php'));});

如果你不想深入研究 服务提供者,还有一种更简单的方法 – 只需 include/require 您的路由文件到另一个文件中,就像你在 Laravel 框架之外的任何 PHP 文件。

事实上,这是由 Taylor Otwell 完成的,只需将 routes/auth.php 文件直接放入 Laravel Breeze 路由:

routes/web.php:

Route::get('/', function () {    return view('welcome');});Route::get('/dashboard', function () {    return view('dashboard');})->middleware(['auth'])->name('dashboard');require __DIR__.'/auth.php';

分组 6. Laravel 9 中的新功能: Route::controller ()

如果你的 Controller 中有一些方法,但它们不遵循标准的 Resource 结构,您仍然可以对它们进行分组,而无需为每个方法重复 Controller 名称。

取而代之的是:

Route::get('profile', [ProfileController::class, 'getProfile']);Route::put('profile', [ProfileController::class, 'updateProfile']);Route::delete('profile', [ProfileController::class, 'deleteProfile']);

您可以这样做:

Route::controller(ProfileController::class)->group(function() {    Route::get('profile', 'getProfile');    Route::put('profile', 'updateProfile');    Route::delete('profile', 'deleteProfile');});

此功能在 Laravel 9 和 Laravel 8 的最新小版本中可用。

就是这样,这些分组技术有望帮助你组织和维护的路由,无论你的项目发展到多大。

原文地址:https://laravel-news.com/laravel-route-organization-tips译文地址:https://learnku.com/laravel/t/68476

【相关推荐:laravel视频教程】

以上就是Laravel如何进行路由分组?6 种路由组织技术分享的详细内容,更多请关注创想鸟其它相关文章!

版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容, 请发送邮件至 chuangxiangniao@163.com 举报,一经查实,本站将立刻删除。
发布者:程序猿,转转请注明出处:https://www.chuangxiangniao.com/p/68814.html

(0)
打赏 微信扫一扫 微信扫一扫 支付宝扫一扫 支付宝扫一扫
企业必备:6款本地部署项目管理软件对比分析
上一篇 2025年11月12日 20:22:58
项目集管理系统实战选型:7款产品评测报告
下一篇 2025年11月12日 20:23:46

相关推荐

  • laravel如何使用Pipeline模式处理复杂逻辑_Laravel Pipeline模式处理复杂逻辑方法

    Laravel Pipeline通过将复杂流程拆分为多个独立处理步骤,实现代码解耦与职责分离。以用户注册为例,可依次执行发送欢迎邮件、分配角色、记录日志等操作,每个步骤由单独类实现__invoke方法,通过Pipeline::send($user)->through([…])-&g…

    2026年9月22日
    200
  • PHP日志记录怎么做_PHP中Monolog库实现灵活强大的日志系统

    Monolog是PHP中基于PSR-3标准的主流日志库,通过Composer安装后可轻松实现日志记录。使用Logger类创建实例并添加Handler(如StreamHandler写入文件、NativeMailerHandler邮件报警)来管理不同级别(debug、info、error等)日志输出,支…

    2026年9月22日
    200
  • PHP框架日志系统怎么记录错误_PHP框架日志系统配置指南

    PHP框架通过配置日志级别、通道和处理器,结合Monolog库实现错误记录。以Laravel和Symfony为例,可在配置文件中定义多通道(如文件、Slack)、设置不同级别(ERROR、CRITICAL),并通过门面或服务在代码中捕获异常并写入上下文信息。 PHP框架的日志系统记录错误,核心在于通…

    2026年9月22日
    000
  • Laravel 8 注册成功但登录失败的解决方案

    本文针对 Laravel 8 中使用 php artisan ui:auth 生成的认证系统,注册功能正常但登录功能失效的问题,提供了一种解决方案。通过重写 LoginController 中的 username() 方法,将认证字段从默认的 email 修改为 username,从而解决登录失败的…

    2026年9月22日
    200
  • laravel+redis有哪些用法

    laravel+redis有用法有:1、使用Redis作为缓存驱动器;2、使用Laravel提供的缓存操作方法来操作Redis缓存;3、使用Redis作为数据存储系统,Laravel提供了与Redis交互的方法,使我们能够方便地进行数据存储和读取;4、还提供了其他高级功能,如发布订阅、事务和管道等,…

    2026年9月22日
    700
  • laravel路由错误怎么办

    laravel路由错误解决方法:1、检查路由定义是否正确,如果错误,根据错误提示进行修改;2、检查路由命名冲突,可以修改其中一个路由的名称来解决冲突;3、清除路由缓存,使用“php artisan route:clear”命令来清除路由缓存;4、检查路由参数,可以在路由定义中使用正则表达式来限制参数…

    2026年9月22日
    1400
  • 使用空值合并运算符为数组元素设置默认值

    本文将介绍如何使用 PHP 的空值合并运算符 (??) 为数组元素设置默认值,尤其是在处理用户输入时。 通过该运算符,可以在变量值为 null 或不存在时,提供一个备选值,从而简化代码并提高可读性。我们将通过一个实际的 Laravel 邮件发送示例,演示如何在请求参数中缺失主题时,设置默认主题。 空…

    2026年9月22日
    600
  • laravel表单类用法是什么

    laravel表单类用法有:1、表单验证,提供了一种简单而强大的方式来验证表单数据,可以使用validate方法来定义验证规则和错误消息;2、表单重填,提供了一个方便的方式来重新填充表单字段的值,可以使用old方法来获取上一次提交的值;3、文件上传,提供了一个方便的方式来处理文件上传,可以在表单中添…

    2026年9月22日
    500
  • laravel Spatie/laravel-medialibrary包高级用法_Laravel Spatie Medialibrary高级功能使用方法

    Spatie/laravel-medialibrary 支持自定义磁盘路径、响应式图像、WebP格式、媒体集合分类、自定义属性存储及签名URL安全访问,并可通过队列异步处理文件转换,提升性能与安全性。 在 Laravel 应用中,Spatie/laravel-medialibrary 是处理文件上传…

    2026年9月22日
    1300
  • PHP中为数组元素设置默认值的最佳实践:使用Null合并运算符

    本教程将介绍如何在PHP中为数组元素设置默认值,尤其当源数据可能为空或缺失时。通过利用PHP 7+提供的Null合并运算符(??),可以简洁高效地实现这一需求,避免冗长的条件判断,提高代码可读性和健壮性。 引言:处理缺失或空值时的数组赋值 在Web开发中,我们经常需要从用户请求、数据库查询或其他外部…

    2026年9月22日
    100
  • Laravel 8 登录后重定向至仪表盘的策略与实践

    本教程详细阐述了在 Laravel 8 中实现用户登录后重定向到仪表盘的多种策略。我们将探讨如何通过配置 LoginController 的 $redirectTo 属性、利用 RouteServiceProvider 定义常量以及在自定义登录方法中进行精确控制来管理重定向流程。文章还涵盖了相关中间…

    2026年9月22日
    100
  • laravel中的契约(Contracts)和门面(Facades)有什么关系_Laravel契约与门面关系解析

    Laravel中的契约定义服务接口,门面提供静态代理,二者协同实现松耦合与易用性:契约通过依赖注入保障可测试性与类型安全,门面通过静态调用简化语法,实际底层对象通常实现对应契约,如Cache门面代理实现IlluminateContractsCacheRepository接口的实例,两者可依场景灵活选…

    2026年9月22日
    100
  • Laravel 8 登录后重定向到仪表盘:完整教程

    本教程详细阐述了在 Laravel 8 中实现用户登录后重定向到仪表盘的多种方法。我们将探讨 Laravel 默认的重定向机制、如何正确配置仪表盘路由及其中间件,并提供通过自定义 LoginController 实现精确重定向的示例代码。通过本文,您将全面掌握 Laravel 认证后的重定向流程,并…

    2026年9月22日
    500
  • MySQL字段注释快速补全方法_Sublime脚本自动生成标准文档结构

    MySQL字段注释快速补全方法_Sublime脚本自动生成标准文档结构MySQL字段注释快速补全方法_Sublime脚本自动生成标准文档结构MySQL字段注释快速补全方法_Sublime脚本自动生成标准文档结构MySQL字段注释快速补全方法_Sublime脚本自动生成标准文档结构

    要快速补全mysql字段注释,可通过sublime text编写python脚本实现自动化;1. 脚本获取表名,可手动输入或从当前sql文件解析;2. 通过subprocess调用mysql命令行获取show full columns信息;3. 解析输出内容,提取字段名和现有注释;4. 生成alte…

    2026年9月21日 用户投稿
    300
  • laravel集合有where方法吗

    有。Laravel集合中的where方法是一个非常有用的方法,用于在集合中筛选元素,根据指定的条件返回匹配的元素。使用where方法,可以根据不同的条件来过滤集合中的元素,where方法接受一个闭包作为参数,闭包中可以定义筛选的条件,闭包的每个元素都会传递给闭包。无论是对关联数组还是对对象集合,wh…

    2026年9月21日
    100
  • laravel如何判断请求类型

    laravel判断请求类型的方法:1、使用Request对象的方法,在Laravel中,每个请求都会通过Request对象进行处理。Request对象提供了一些有用的方法来判断请求类型;2、使用路由方法,在Laravel中,路由文件定义了应用程序的请求路由,可以使用路由方法来判断请求类型;3、使用中…

    2026年9月21日
    200
  • Laravel 8 登录后重定向到仪表盘的完整教程

    本教程详细介绍了在 Laravel 8 中实现用户登录后重定向到仪表盘的多种方法。我们将探讨如何利用 Laravel 内置的 $redirectTo 属性,以及如何通过重写 LoginController 中的 login 方法来实现自定义重定向逻辑。此外,教程还将重点讲解正确的路由配置和中间件使用…

    2026年9月21日
    100
  • laravel怎么监控错误

    laravel监控错误的方法:1、错误日志记录,Laravel内置了一个非常强大的日志系统,可以通过查看这些日志文件来了解应用程序中发生的错误;2、异常处理,Laravel提供了一个Exception类,可以用来捕获和处理异常;3、自定义错误页面,创建不同的视图文件,用于处理特定类型错误,当发生相应…

    2026年9月21日
    200
  • Laravel中的用户认证和授权:保护应用程序的安全和隐私

    Laravel中的用户认证和授权:保护应用程序的安全和隐私 引言:在众多Web应用程序中,用户认证和授权是保护应用程序安全和隐私的重要方面。Laravel作为一个流行的PHP框架,提供了一套强大而灵活的用户认证和授权系统。 本文将介绍Laravel中的用户认证和授权的基本概念和实现方式,并通过示例代…

    2026年9月21日
    000
  • laravel如何进行安全的SQL查询以防止注入_Laravel安全SQL查询防注入方法

    使用Eloquent和Query Builder并配合参数绑定可有效防止SQL注入。Laravel通过PDO预处理机制自动转义参数,确保安全;应避免拼接用户输入,尤其在whereRaw等原生语句中需使用?占位符绑定变量;所有用户输入均需验证,对ID类字段强制类型转换,并禁止将用户输入直接用于表名、字…

    2026年9月21日
    100

发表回复

登录后才能评论
关注微信