macellan / laravel-advanced-route
Laravel高级路由类 - 将隐式控制器恢复到框架中。
Requires
- laravel/framework: >=5.0
README
为Laravel 5.3, 5.4, 5.5, 5.6, 5.8, 6.0, 7.0, 8.0, 9.0提供高级路由支持,以支持控制器。
背景
在Laravel中,高级功能Route::controller已被移除。这个类修复了这个不足。
原因
默认路由器对于小型项目来说是足够的。一旦项目开始增长,将所有可能的路由定义放在路由器文件中开始变得难以理解和跟踪。通常,路由器文件会变得非常混乱,以至于开发者害怕修改/删除路由(即使这些可能未使用),以免意外破坏应用程序。
AdvancedRoute::controller将控制权交给控制器本身,使每个控制器对其自己的路由(目的地)负责。
使用get/post/any前缀指定控制器方法可以改善可读性,并且只需查看方法即可轻松理解正在使用哪种HTTP方法来调用功能。
你的路由器文件是否超出屏幕范围,你必须滚动才能看到所有路由?你有没有将路由拆分到单独的路由文件中,然后将其包含在一个路由文件中?你不喜欢删除路由,因为这些可能被用在某处吗?你使用名称来“命名”你的路由吗?那么是时候跳出思维定式,走向高级了。
如何工作
高级路由允许你轻松定义单个路由来处理控制器类中的每个操作。首先,使用AdvancedRoute::controller方法定义路由。控制器方法接受两个参数。第一个是控制器处理的基URI,第二个是控制器的类名。然后,只需向你的控制器添加方法。方法名应该以响应的HTTP动词开头,后跟URI的标题化版本。
<?php namespace App\Http\Controllers; class UserController extends Controller { /** * Responds to any (GET,POST, etc) request to /users */ public function anyIndex() { // } /** * Responds to requests to GET /users/show/1 */ public function getShow($id) { // } /** * Responds to requests to GET /users/admin-profile */ public function getAdminProfile() { // } /** * Responds to requests to POST /users/profile */ public function postProfile() { // } }
安装
a) 通过composer(推荐)
composer require macellan/laravel-advanced-route
b) 手动
将以下内容添加到你的composer文件中
"repositories": [ { "type": "vcs", "url": "https://github.com/macellan/laravel-advanced-route.git" } ], "require": { "macellan/laravel-advanced-route": "dev-master" },
用法
将以下行添加到你希望控制器映射的位置
AdvancedRoute::controller('/{YOUR PATH}', '{YOUR CONTROLLER FULL NAME}');
完整示例
Route::group(['prefix' => '/', 'middleware' => []], function () { AdvancedRoute::controller('/auth', 'AuthController'); AdvancedRoute::controller('/cms', 'CmsController'); AdvancedRoute::controller('/shop', 'ShopController'); Route::any('/', 'WebsiteController@anyIndex'); });
多个控制器映射
AdvancedRoute::controllers([ '/auth' => 'AuthController', '/cms' => 'CmsController', '/shop' => 'ShopController', ]);
缺少方法
如果你有一个控制器有几个预定义的路由,你可以添加missingMethod()来处理该控制器路径的所有未定义子路径。
class WikiController extends Controller { public function getIndex() { /* show main page or list of content */ } public function getCreate() { /* a page to add a new wiki-page */ } public function postCreate() { /* add a new wiki-page */ } public function missingMethod() { /* do anything elselook up the path in the wiki-database */ } }
致谢
Laravel Advanced Route只可能得益于所有出色的 贡献者!
替代方案
是否觉得Laravel过于臃肿且速度慢?是的,告诉我吧?你想走纯PHP路线?好吧,这里有一些值得注意的包,允许你保留Laravel路由的优雅之处。