macellan/laravel-advanced-route

Laravel高级路由类 - 将隐式控制器恢复到框架中。

v1.7.4 2022-09-17 17:47 UTC

This package is auto-updated.

Last update: 2024-09-17 21:59:14 UTC


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路由的优雅之处。

https://github.com/mrjgreen/phroute