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)
打赏 微信扫一扫 微信扫一扫 支付宝扫一扫 支付宝扫一扫
上一篇 2025年11月12日 20:00:08
下一篇 2025年11月12日 20:40:52

相关推荐

  • HTMLrev 上的免费 HTML 网站模板

    HTMLrev 是唯一的人工策划的库专门专注于免费 HTML 模板,适用于由来自世界各地慷慨的模板创建者制作的网站、登陆页面、投资组合、博客、电子商务和管理仪表板世界。 这个人就是我自己 Devluc,我已经工作了 1 年多来构建、改进和更新这个很棒的免费资源。我自己就是一名模板制作者,所以我知道如…

    2025年12月24日
    300
  • 如何使用 Laravel 框架轻松整合微信支付与支付宝支付?

    如何通过 laravel 框架整合微信支付与支付宝支付 在 laravel 开发中,为电商网站或应用程序整合支付网关至关重要。其中,微信支付和支付宝是中国最流行的支付平台。本文将介绍如何使用 laravel 框架封装这两大支付平台。 一个简单有效的方法是使用业内认可的 easywechat lara…

    2025年12月24日
    000
  • Laravel 框架中如何无缝集成微信支付和支付宝支付?

    laravel 框架中微信支付和支付宝支付的封装 如何将微信支付和支付宝支付无缝集成到 laravel 框架中? 建议解决方案 考虑使用 easywechat 的 laravel 版本。easywechat 是一个成熟、维护良好的库,由腾讯官方人员开发,专为处理微信相关功能而设计。其 laravel…

    2025年12月24日
    500
  • 如何在 Laravel 框架中轻松集成微信支付和支付宝支付?

    如何用 laravel 框架集成微信支付和支付宝支付 问题:如何在 laravel 框架中集成微信支付和支付宝支付? 回答: 建议使用 easywechat 的 laravel 版,easywechat 是一个由腾讯工程师开发的高质量微信开放平台 sdk,已被广泛地应用于许多 laravel 项目中…

    2025年12月24日
    000
  • 使用Laravel框架如何整合微信支付和支付宝支付?

    使用 Laravel 框架整合微信支付和支付宝支付 在使用 Laravel 框架开发项目时,整合支付网关是常见的需求。对于微信支付和支付宝支付,推荐采用以下方法: 使用第三方库:EasyWeChat 的 Laravel 版本 建议直接使用现有的 EasyWeChat 的 Laravel 版本。该库由…

    2025年12月24日
    000
  • 如何将微信支付和支付宝支付无缝集成到 Laravel 框架中?

    如何简洁集成微信和支付宝支付到 Laravel 问题: 如何将微信支付和支付宝支付无缝集成到 Laravel 框架中? 答案: 强烈推荐使用流行的 Laravel 包 EasyWeChat,它由腾讯开发者维护。多年来,它一直保持更新,提供了一个稳定可靠的解决方案。 集成步骤: 安装 Laravel …

    2025年12月24日
    100
  • Web页面中动态内容与页脚重叠的解决方案

    本教程旨在解决使用php `include`功能构建bootstrap网站时,页脚内容与主体内容重叠的问题。核心在于纠正html结构中的多余 “ 和 ` ` 标签,确保每个页面只包含一个完整的html文档结构,并将javascript脚本正确放置在 “ 结束标签之前,从而实现…

    2025年12月23日
    000
  • Laravel Blade模板中DIV元素样式定制指南:字体、间距与最佳实践

    本教程详细介绍了如何在laravel blade模板中为div元素应用自定义字体、调整大小和设置间距。我们将探讨常见的错误、正确的内联样式方法,并强调使用css类的最佳实践,同时指导如何正确集成自定义字体,以实现清晰、可维护的样式控制。 引言:理解Blade模板中的样式需求 在构建Web应用时,我们…

    2025年12月23日
    200
  • 如何正确构建HTML结构以确保Bootstrap页脚自动下沉

    本教程旨在解决使用php `include` 和 bootstrap 5 时页脚与内容重叠的问题。核心在于纠正不正确的html结构,避免重复的“和` `标签,合理放置css和javascript引用,并移除可能导致布局冲突的`vh-100`类,确保页脚能根据内容动态下沉。 在Web开发中…

    2025年12月23日
    000
  • 优化Web页面布局:确保Bootstrap页脚自动适应内容高度

    当使用php `include` 动态构建页面时,不正确的html结构(如重复的 “ 和 ` ` 标签)常导致页脚与主体内容重叠。本文将指导如何通过修正html文档结构,避免冗余标签,并确保javascript脚本正确放置,从而实现页脚自动向下移动,适应动态内容高度,提升页面布局的稳定性…

    2025年12月23日
    000
  • PHP Include与Bootstrap布局:解决动态内容下的页脚重叠问题

    本文探讨了在使用php `include` 和 bootstrap 构建网页时,因不当的html结构和css应用导致的页脚重叠问题。教程将指导您如何通过规范html文档结构、正确放置脚本文件以及移除冲突的css属性,确保页脚能够随主体内容动态调整位置,实现健壮且响应式的页面布局。 问题分析:页脚重叠…

    2025年12月23日
    000
  • 怎么运行.html.tpl_运行.html.tpl文件步骤【指南】

    .html.tpl文件需通过后端模板引擎解析,不能直接运行;首先搭建PHP环境,安装Smarty等模板引擎,配置模板与编译目录,编写PHP脚本加载.tpl文件并分配数据,最后通过访问PHP文件触发渲染,浏览器查看最终HTML。 运行 `.html.tpl` 文件并不是直接像普通 HTML 文件那样在…

    2025年12月23日
    000
  • 解决PHP Include页面中页脚重叠问题的最佳实践

    本文旨在解决使用PHP `include`功能构建网页时,页脚与主体内容重叠的问题。核心在于纠正不规范的HTML结构,确保每个页面只有一个`html>`和` `标签,并合理组织导航、内容和页脚的PHP包含文件,同时优化脚本加载位置和元素间距,以实现稳固且响应式的页面布局。 理解问题根源:不规范…

    2025年12月23日
    000
  • Laravel开发:如何在编辑界面正确预选数据库中的多选标签

    本文旨在解决laravel应用中编辑界面多选(select multiple)标签无法自动预选数据库中已保存数据的问题。通过详细讲解控制器层的数据准备和视图层的条件渲染逻辑,我们将展示如何利用blade模板引擎和eloquent关系,确保用户在编辑时能直观看到并修改此前选择的标签,同时提供最佳实践,…

    2025年12月23日
    000
  • Laravel Blade 条件渲染:根据数据状态控制 HTML 元素显示

    本文将介绍在 laravel blade 模板中如何根据数据变量的值是否为空或不存在,来有条件地渲染 html 元素,例如 ` ` 标签。通过利用 blade 的 `@if` 指令结合 php 的 `empty()` 函数,开发者可以确保只有当数据有效时才显示相关内容,从而避免渲染空标签或不必要的信…

    2025年12月23日
    000
  • JavaScript按钮实现PUT/POST重定向与数据提交:模拟表单行为的教程

    本教程详细讲解如何通过JavaScript动态创建并提交隐藏表单,以实现从按钮点击触发的PUT或POST请求重定向,并携带请求体数据。这种方法无需使用`fetch` API,能够满足浏览器自动处理Cookie的需求,为需要模拟完整表单提交行为的场景提供了有效的解决方案。 引言:理解PUT/POST重…

    2025年12月23日
    000
  • PHP多语言网站:语言切换与内容翻译的最佳实践

    本教程旨在指导开发者如何在php项目中实现健壮的多语言切换功能。文章详细介绍了基于会话(session)的语言状态管理、通过url参数进行语言切换的方法,并提出了一套功能完善的辅助函数来加载和安全地检索翻译内容,从而有效避免常见的“未定义变量”或“非法字符串偏移”错误。通过结构化的代码示例和最佳实践…

    2025年12月23日
    000
  • 优化长HTML属性值:SonarQube警告与实用策略

    本文探讨html表单`action`属性过长导致sonarqube警告的问题,并提供三种解决方案:优化url结构、通过变量预构建url,以及灵活评估代码规范。重点推荐使用变量预构建url,以提升代码可读性和维护性,同时兼顾静态分析工具的建议与实际开发需求。 引言:处理HTML长属性值的挑战 在现代W…

    2025年12月23日
    000
  • 使用JavaScript从按钮触发GET重定向或模拟POST/PUT提交的教程

    本教程详细介绍了如何通过JavaScript从按钮触发客户端重定向,以实现类似表单提交的效果,同时确保浏览器Cookie的正常处理。文章涵盖了两种主要方法:一是使用location.href进行带查询参数的GET重定向,适用于简单的导航或GET请求触发的动作;二是通过动态创建和提交隐藏表单来模拟PO…

    2025年12月23日
    000
  • Mac Valet一键站点,HTML+CSS开发环境王者!

    首先确认Valet服务已安装并运行,通过valet install和valet start初始化;使用valet park将项目目录设为可自动访问的本地根目录,新增项目即享.test域名;对独立项目可用valet link绑定自定义.test域名;为优化静态文件支持,在项目根目录创建.valet/s…

    2025年12月23日
    000

发表回复

登录后才能评论
关注微信