原文鏈接：https://learnku.com/laravel/t/38917

討論請(qǐng)前往專(zhuān)業(yè)的 Laravel 開(kāi)發(fā)者論壇：https://learnku.com/Laravel

想象一下一個(gè)擁有 100 多個(gè)路由的 Laravel 項(xiàng)目宪彩，其中包括訪客，用戶，管理員等分離的模塊面殖。你真的要將所有內(nèi)容寫(xiě)在在一個(gè)文件中嗎冯袍？那么如何將它們分組，并且為 URL 添加前綴呢？看看有哪些辦法麦萤。

1. 分離 WEB 和 API 路由

這個(gè)簡(jiǎn)單炼吴，因?yàn)?Laravel 已經(jīng)幫你做了本鸣。有如下兩個(gè)文件：

• routes/web.php
• routes/api.php

因此，如果你的項(xiàng)目同時(shí)具有前端頁(yè)面和 API （使用場(chǎng)景越來(lái)越廣）硅蹦，請(qǐng)把 API 的路由放在 api.php 里荣德。

例如，如果你有 /users 頁(yè)面童芹，又有 /api/users/ 端點(diǎn)涮瞻，把他們分別寫(xiě)在自己屬于自己路由文件里，以免在同一文件中出現(xiàn)同一相同名稱(chēng)而產(chǎn)生混淆假褪。

但我最近還是從 官方 Laravel 項(xiàng)目中看到了反例署咽。在 Laravel Horizon 中，Taylor 只有 API 路由生音，但他沒(méi)有分開(kāi)寫(xiě)宁否，還是寫(xiě)在了 routes/web.php :

image

另一個(gè)例子證明 Laravel 還是非常的個(gè)人化，甚至 Taylor 自己也沒(méi)有 100% 按照標(biāo)準(zhǔn)來(lái)久锥。

2. 把 routes/web.php 文件分組結(jié)構(gòu)化

下面例子也是來(lái)自 Laravel 官方文檔 的示例：

Route::middleware(['first', 'second'])->group(function () {
    Route::get('/', function () {
        // 使用 first 和 second 中間件
    });

    Route::get('user/profile', function () {
        // 使用 first 和 second 中間件
    });
});

最基本的用法是將不同的路由分組包含在不同的中間件里面家淤。例如，你希望一個(gè)組默認(rèn)受 auth 中間件限制瑟由，另一組受單獨(dú)的 admin 自定義中間件限制等絮重。

這樣，你還可以使用 名稱(chēng) 和 前綴 等路由分組方法歹苦。同樣青伤，官方文檔中給出了示例：

Route::prefix('admin')->group(function () {
    Route::get('users', function () {
        // 匹配 URL 「/admin/users」
    });
});

Route::name('admin.')->group(function () {
    Route::get('users', function () {
        // 路由名為 「admin.users」...
    })->name('users');
});

另外，如果您要將所有中間件 + 名稱(chēng) + 前綴添加到一個(gè)組中殴瘦，則將它們放入數(shù)組中更容易理解：

// 而不是這樣做： 
Route::name('admin.')->prefix('admin')->middleware('admin')->group(function () {
    // ...
});

// 可以使用數(shù)組
Route::group([
    'name' => 'admin.', 
    'prefix' => 'admin', 
    'middleware' => 'auth'
], function () {
    // ...
});

我們將其結(jié)合為一個(gè)擁有三個(gè)路由分組的真實(shí)示例：

• 帶有 / front / XXXXX URL 且沒(méi)有中間件的「訪客」組
• 帶有 / user / XXXXX URL 和 auth 中間件的「用戶」組
• 帶有 / admin / XXXXX URL 和自定義 admin 中間件的「管理員」組

以下是將所有內(nèi)容分組到 routes / web.php 文件中的一種方法：

Route::group([
    'name' => 'admin.',
    'prefix' => 'admin',
    'middleware' => 'admin'
], function () {

    // URL鏈接：/admin/users
    // 路由名稱(chēng)：admin.users
    Route::get('users', function () {
        return 'Admin: user list';
    })->name('users');

});

Route::group([
    'name' => 'user.',
    'prefix' => 'user',
    'middleware' => 'auth'
], function () {

    // URL鏈接：/user/profile
    // 路由名稱(chēng)：user.profile
    Route::get('profile', function () {
        return 'User profile';
    })->name('profile');

});

Route::group([
    'name' => 'front.',
    'prefix' => 'front'
], function () {

    // 這里沒(méi)有中間件
    // URL鏈接：/front/about-us
    // 路由名稱(chēng)：front.about
    Route::get('about-us', function () {
        return 'About us page';
    })->name('about');

});

3. 使用命名空間對(duì)控制器進(jìn)行分組

在上面的例子中狠角，我們沒(méi)有使用控制器，只是返回了靜態(tài)文本作為示例蚪腋。 讓我們添加一個(gè)控制器丰歌，來(lái)點(diǎn)小花樣 — 我們會(huì)將它們構(gòu)造到各自不同的命名空間的文件夾中姨蟋，如下所示:

image

然后我們可以在路由文件中使用它們：

Route::group([
    'name' => 'front.',
    'prefix' => 'front'
], function () {
    Route::get('about-us', 'Front.boutController@index')->name('about');
});

但是如果在這個(gè)組中我們有很多控制器呢? 我們應(yīng)該一直添加Front.omeController 嗎？ 當(dāng)然不是立帖。您也可以將命名空間作為參數(shù)之一眼溶。

Route::group([
    'name' => 'front.',
    'prefix' => 'front',
    'namespace' => 'Front',
], function () {
    Route::get('about-us', 'AboutController@index')->name('about');
    Route::get('contact', 'ContactController@index')->name('contact');
});

4. 組嵌套組

上面的情況，分為了3個(gè)組晓勇，實(shí)際上這是被簡(jiǎn)化的堂飞， 實(shí)際項(xiàng)目的結(jié)構(gòu)稍有不同 – 是 兩 個(gè)組：front 和 auth 。 然后在 auth 中绑咱，有兩個(gè)子組：user 和 admin 绰筛。為此， 我們可以在 routes/web.php中創(chuàng)建子組描融，并分配不同的中間件/前綴等铝噩。

Route::group([
    'middleware' => 'auth',
], function() {

    Route::group([
        'name' => 'admin.',
        'prefix' => 'admin',
        'middleware' => 'admin'
    ], function () {

        // URL: /admin/users
        // Route name: admin.users
        Route::get('users', 'UserController@index')->name('users');

    });

    Route::group([
        'name' => 'user.',
        'prefix' => 'user',
    ], function () {

        // URL: /user/profile
        // Route name: user.profile
        Route::get('profile', 'ProfileController@index')->name('profile');

    });

});

我們甚至可以多層嵌套，這是開(kāi)源項(xiàng)目的一個(gè)示例稼稿。 Akaunting:

Route::group(['middleware' => 'language'], function () {
    Route::group(['middleware' => 'auth'], function () {
        Route::group(['prefix' => 'uploads'], function () {
            Route::get('{id}', 'Common.ploads@get');
            Route::get('{id}/show', 'Common.ploads@show');
            Route::get('{id}/download', 'Common.ploads@download');
        });

        Route::group(['middleware' => 'permission:read-admin-panel'], function () {
            Route::group(['prefix' => 'wizard'], function () {
                Route::get('/', 'Wizard.ompanies@edit')->name('wizard.index');

        // ...

另一個(gè)例子來(lái)自另一個(gè)流行的Laravel CRM薄榛，名為Monica:

Route::middleware(['auth', 'verified', 'mfa'])->group(function () {
    Route::name('dashboard.')->group(function () {
        Route::get('/dashboard', 'DashboardController@index')->name('index');
        Route::get('/dashboard/calls', 'DashboardController@calls');
        Route::get('/dashboard/notes', 'DashboardController@notes');
        Route::get('/dashboard/debts', 'DashboardController@debts');
        Route::get('/dashboard/tasks', 'DashboardController@tasks');
        Route::post('/dashboard/setTab', 'DashboardController@setTab');
    });

5. RouteServiceProvider 中的全局設(shè)置

有一個(gè)服務(wù)于所有路由設(shè)置的文件 – app/Providers/RouteServiceProvider.php. 它具有綁定兩個(gè)路由文件 – web 和 API 的 map() 方法：

    public function map()
    {
        $this->mapApiRoutes();
        $this->mapWebRoutes();
    }

    protected function mapWebRoutes()
    {
        Route::middleware('web')
             ->namespace($this->namespace)
             ->group(base_path('routes/web.php'));
    }

    protected function mapApiRoutes()
    {
        Route::prefix('api')
             ->middleware('api')
             ->namespace($this->namespace)
             ->group(base_path('routes/api.php'));
    }

您是否注意到方法中提及的 middleware, namespace 和 prefix ？ 這是您可以為整個(gè)文件設(shè)置全局配置的地方让歼，因此不必為文件中的每個(gè)路由組重復(fù)這些設(shè)置敞恋。

它主要用于 API 路由，因?yàn)樗鼈兊脑O(shè)置通常是相同的谋右，如下所示：

protected function mapApiRoutes()
{
    Route::group([
        'middleware' => ['api'],
        'namespace' => $this->namespace,
        'prefix' => 'api/v1',
    ], function ($router) {
        require base_path('routes/api.php');
    });
}

上述方法將在所有 API URLs 的開(kāi)頭加上 api/v1/ 前綴硬猫。

6. 分組成更多文件 – 這值得嗎？

如果您有大量的路由改执，并且希望將它們分組到單獨(dú)的文件中啸蜜，那么您可以使用上一節(jié)中提到的相同文件 – app/Providers/RouteServiceProvider.php。如果您仔細(xì)查看它的 map() 方法辈挂，您將在末尾看到注釋位置：

public function map()
{
    $this->mapApiRoutes();

    $this->mapWebRoutes();

    //
}

如果愿意衬横，您可以將其解釋為添加更多文件的“邀請(qǐng)”。因此终蒂，您可以在此文件內(nèi)創(chuàng)建另一個(gè)方法蜂林，例如 mapAdminRoutes()，然后將其添加到 map() 方法拇泣， 您的文件將被自動(dòng)注冊(cè)并加載噪叙。

但是，就我個(gè)人而言霉翔，我看不出這種方法有什么優(yōu)勢(shì)睁蕾，而且我也沒(méi)有經(jīng)常看到這種做法。它會(huì)帶來(lái)更多的路由分離子眶，但有時(shí)您會(huì)迷失在那些文件中瀑凝，不確定在哪里查找特定的路由。

7. 使用 Artisan route:list 命令查找特定路由

說(shuō)到更大的路由并迷失在那里壹店，我們有一個(gè) Artisan 命令可以幫助定位某個(gè)路由猜丹。

您可能知道 php artisan route:list 將展示項(xiàng)目中的所有路由

image

但您知道還有更多的過(guò)濾功能來(lái)找到您想要的東西嗎？ 只需添加帶參數(shù)的 –method, 或 –name, 或 –path 硅卢。

通過(guò) method 過(guò)濾 – GET, POST 等：

image

按名稱(chēng)或 URL 部分過(guò)濾：

image

這就是我所能告訴的關(guān)于在大型項(xiàng)目中分組路由的全部?jī)?nèi)容。你還有其他例子嗎藏杖？請(qǐng)?jiān)谠u(píng)論中分享将塑。

原文鏈接：https://learnku.com/laravel/t/38917

討論請(qǐng)前往專(zhuān)業(yè)的 Laravel 開(kāi)發(fā)者論壇：https://learnku.com/Laravel