几天内即可获得 Laravel 代码审查方面的专家指导

大型 Laravel 应用中的路由管理

发布日期 经过

在大型 Laravel 应用程序镜像中管理路由

Laravel 的路由文件可能会变得非常庞大。不知不觉中,你就需要在路由文件中搜索才能找到任何东西。那么,如何解决这个问题呢?

你可以根据自己的喜好,选择多种方法来解决这个问题。在本教程中,我将介绍我见过的一些方法,最后阐述我的方法以及我为什么选择这种方法。

我将举一个简单的例子,但你可以稍微发挥一下想象力!假设我们正在构建一个 API 应用程序,该应用程序允许客户从产品目录在线订购商品,并允许他们的客户跟踪发货情况。

路线服务提供商

使用路由服务提供商,您可以轻松添加其他路由条目。我们来看一个例子:

班级 路由服务提供者 延伸 服务提供者
{
民众 功能 引导 () : 空白
{
$this -> 配置速率限制 ();
$this -> 路线 功能 () : 空白 {
路线 :: 中间件 ‘api’
-> 团体 基本路径 'routes/api.php' ));
});
}
}

这与默认设置类似。 RouteServiceProvider 您可以在 Laravel 项目中获得此功能。具体实现可能因应用程序的开发时间而异。我们如何扩展此功能?我们可以在提供程序中添加额外的路由加载:

班级 路由服务提供者 延伸 服务提供者
{
民众 功能 引导 () : 空白
{
$this -> 配置速率限制 ();
$this -> 路线 功能 () : 空白 {
路线 :: 中间件 ‘api’
-> 团体 基本路径 'routes/api.php' ));
路线 :: 中间件 ‘api’
-> 团体 基本路径 'routes/resource/catalog.php' ));
路线 :: 中间件 ‘api’
-> 团体 基本路径 'routes/resource/orders.php' ));
路线 :: 中间件 ‘api’
-> 团体 基本路径 'routes/resource/payments.php' ));
路线 :: 中间件 ‘api’
-> 团体 基本路径 'routes/resource/deliveries.php' ));
});
}
}

这并非旨在做到完全精确。我只是想用这个例子来说明一些可能至少有 75 条路径的复杂部件。所以,我们在这里进行管理…… RouteServiceProvider 所以一切都围绕着路由的加载方式展开。我发现这种方法最大的问题在于,在路由文件中,你需要知道还加载了哪些其他内容。我之前参与过一个使用这种方法的大型应用程序,需要花费大量精力去反复检查路由是否加载完毕以及它们的加载顺序是否会导致问题。

第一次打开 Laravel 项目时,你需要关注几个关键方面:Eloquent 模式、路由和测试。打开路由文件,查看已注册的路由,以了解应用程序的规模和结构。

需要文件

如果您安装了 Laravel Breeze,您会注意到它会将以下内容添加到您的…… routes/web.php 文件:

要求 __你__ '/auth.php' ;

这会加载软件包自带的身份验证路由,使你的服务提供商更加精简,并让你了解需要检查多少额外的文件才能查看所有路由。让我们以上面的示例为例,并按照这种方法添加路由:

// 你的 `routes/api.php` 文件的其余部分
要求 __你__ '/resource/catalog.php' ;
要求 __你__ '/resource/orders.php' ;
要求 __你__ '/resource/payments.php' ;
要求 __你__ '/resource/deliveries.php' ;

在我看来,这比服务提供商模式有所改进,因为在浏览路由文件时,应用程序的可见性会更高。然而,我非常讨厌引入这些文件。这感觉很混乱,也很敷衍。

好处在于,您可以在一个简洁的位置查看所有路由所需的加载项,位置与您期望查看路由的位置一致。然而,缺点是它只是一个必需的方法,用于在执行此脚本时加载文件。

在我看来,这方面还有很大的改进空间。这里没有说明 URL 结构是什么样的,也没有说明是否有任何额外的中间件应用于所有路由。

路由组

这是我更倾向的方法。我们看到它们在以下方面得到应用: RouteServiceProvider 这就是我获得灵感的地方。这里的基本原理是,在你的主路由文件中( routes/api.php 在我们的例子中),我们像手动添加路由一样构建路由组,然后告诉该组它需要使用单独的文件。

// 你的 `routes/api.php` 文件的其余部分
路线 :: 前缀 '目录' -> 作为 '目录:' -> 中间件 ([ ‘授权:批准’ ]) -> 团体
基本路径 'routes/resources/catalog.php' ),
(英文):
路线 :: 前缀 “命令” -> 作为 '订单:' -> 中间件 ([ ‘授权:批准’ ]) -> 团体
基本路径 'routes/resources/orders.php' ),
(英文):
路线 :: 前缀 “付款” -> 作为 '付款:' -> 中间件 ([ ‘授权:批准’ ]) -> 团体
基本路径 'routes/resources/payments.php' ),
(英文):
路线 :: 前缀 “交付” -> 作为 '交付:' -> 中间件 ([ ‘授权:批准’ ]) -> 团体
基本路径 'routes/resources/deliveries.php' ),
(英文):

如上图所示,我们只是使用了 base_path 辅助函数用于将路由加载到正确的位置。查看路由文件,我们可以看到应用程序的路由组是如何构建的,但它并没有占据整个文件——即使最终有 20-30 个路由组,文件仍然非常易读。

从这里,我们可以在专用路由文件中管理“资源”和“子资源”,这意味着导入时类名类会更少,并且拥有专用文件,您可以轻松地单独理解这些文件,或者在整个应用程序的内容中理解这些文件。

如何应对庞大的路由文件带来的认知负担?您是否找到了什么有趣的方法想要分享?欢迎在 Twitter 上告诉我们。

史蒂夫·麦克杜格尔照片

教育工作者和内容创作者、自由顾问、API 布道者

归档于:
立方体

Laravel 时事通讯

加入超过 4 万名开发者的行列,不错过任何新的技巧、教程等内容。

图像
了解软科技

以每小时 20 美元的价格聘请具备人工智能专业知识的 Laravel 开发人员。48 小时内即可开始工作。

访问 Acquaint Softtech
Tinkerwell 徽标

廷克威尔

Laravel 开发者必备的代码运行器。可在本地和生产环境中体验 AI、自动补全和即时反馈功能。

廷克威尔
几天内即可获得 Laravel 代码审查徽标的专家指导

几天内即可获得 Laravel 代码审查方面的专家指导

专家级代码审查!两位拥有 10 年以上 Laravel 开发经验的开发者将为您提供清晰、实用的反馈,帮助团队构建更优质的应用程序。

几天内即可获得 Laravel 代码审查方面的专家指导
PhpStorm 标志

PhpStorm

首选的 PHP IDE,对 Laravel 及其生态系统提供广泛的开箱即用支持。

PhpStorm
Laravel Cloud 标志

Laravel 云

轻松创建和管理服务器,并在几秒钟内部署 Laravel 应用程序。

Laravel 云
了解 Softtech 的标志

了解软科技

Acquaint Softtech 提供 AI 就绪的 Laravel 开发人员,48 小时内即可上手,每月费用为 3000 美元,没有冗长的销售流程,并提供 100% 退款保证。

了解软科技
Kirschbaum 标志

樱桃树

提供创新和稳定性,确保您的Web应用程序取得成功。

樱桃树
Shift 标志

转移

还在运行旧版本的 Laravel?立即实现 Laravel 自动升级和代码现代化,让您的应用程序保持最新状态。

转移
鱼叉:新一代时间跟踪和发票标志

Harpoon:新一代时间跟踪和发票系统

新一代时间跟踪和计费软件,帮助您的机构规划和预测盈利的未来。

Harpoon:新一代时间跟踪和发票系统
Lucky Media 标志

幸运传媒

Get Lucky Now——拥有十余年经验的 Laravel 开发理想之选!

幸运传媒
SaaSykit:Laravel SaaS 入门套件徽标

SaaSykit:Laravel SaaS 入门套件

SaaSykit 是一个多租户 Laravel SaaS 入门套件,包含运行现代 SaaS 所需的所有功能,例如支付、美观的结账界面、管理面板、用户仪表盘、身份验证、现成组件、统计数据、博客、文档等等。

SaaSykit:Laravel SaaS 入门套件
MongoDB 徽标

MongoDB

Enhance your PHP applications with the powerful integration of MongoDB and Laravel, empowering developers to build applications with ease and efficiency. Support transactional, search, analytics and mobile use cases while using the familiar Eloquent APIs. Discover how MongoDB's flexible, modern database can transform your Laravel applications.

MongoDB
Ship AI with Laravel: Stop Your AI Agent from Guessing image

Ship AI with Laravel: Stop Your AI Agent from Guessing

阅读文章
Laravel Cloud Adds Path Blocking to Prevent Bots From Waking Hibernated Apps image

Laravel Cloud Adds Path Blocking to Prevent Bots From Waking Hibernated Apps

阅读文章
Making Laravel MongoDB Operations Idempotent: Safe Retries for Financial Transactions image

Making Laravel MongoDB Operations Idempotent: Safe Retries for Financial Transactions

阅读文章
FormRequest Strict Mode and Queue Job Inspection in Laravel 13.4.0 image

FormRequest Strict Mode and Queue Job Inspection in Laravel 13.4.0

阅读文章
Pretty PHP Info: A Modern Replacement for `phpinfo()` image

Pretty PHP Info: A Modern Replacement for `phpinfo()`

阅读文章
Laracon US 2026 Announced image

Laracon US 2026 Announced

阅读文章