如何定義和使用Laravel中的路線組。

Laravel 中的Route Groups 用於統一配置和管理多個共享設置的路由，以減少重複代碼並提高可讀性。通過Route Groups 可集中處理中間件、命名空間、路由前綴、子域名綁定等配置，例如：1. 使用prefix 設置路由前綴，常用於API 或後台路徑；2. 通過middleware 統一應用中間件；3. 利用namespace 簡化控制器調用；4. 使用domain 實現子域名路由；5. 支持嵌套路由組實現更細粒度控制；6. 配合as 參數為路由命名提供統一前綴，提升維護效率。

在Laravel 中，Route Groups 是一種非常實用的功能，它允許你對一組路由進行統一的配置和管理。通過Route Groups，你可以集中處理中間件、命名空間、路由前綴、子域名綁定等設置，避免重複代碼，提高代碼可讀性和維護性。

為什麼使用Route Groups？

在實際開發中，我們經常會遇到多個路由共享相同配置的情況，比如：

• 多個後台管理頁面都需要auth和admin中間件
• API 路由通常都以/api開頭
• 前台頁面都使用App\Http\Controllers\HomeController這樣的命名空間

如果你一個個路由單獨寫配置，不僅重複，而且容易出錯。使用Route Groups 後，這些配置就可以統一設置，只寫一次。

如何定義一個Route Group？

Laravel 的路由組使用Route::group()方法定義，傳入一個數組作為配置項，然後是一個閉包來定義該組內的所有路由。

 Route::group(['prefix' => 'admin', 'middleware' => 'auth'], function () {
    Route::get('dashboard', [AdminController::class, 'dashboard']);
    Route::get('users', [AdminController::class, 'users']);
});

上面這段代碼定義了一個路由組，所有組內的路由都會自動帶上/admin前綴，並應用auth中間件。

常見配置項及使用場景

1. 路由前綴（prefix）

適用於API 或後台管理頁面。例如：

 Route::group(['prefix' => 'api/v1'], function () {
    Route::get('users', [UserController::class, 'index']);
});

訪問路徑為： /api/v1/users

2. 中間件（middleware）

可以為一組路由統一設置中間件：

 Route::group(['middleware' => ['auth', 'admin']], function () {
    Route::get('admin/dashboard', [AdminController::class, 'dashboard']);
});

3. 命名空間（namespace）

如果你的控制器分佈在不同的目錄中，可以使用命名空間：

 Route::group(['namespace' => 'Admin', 'prefix' => 'admin'], function () {
    Route::get('settings', [SettingsController::class, 'index']);
});

這樣就可以直接寫SettingsController::class ，而不用寫完整的命名空間。

4. 子域名路由（domain）

適用於多租戶或子站點：

 Route::group(['domain' => '{account}.example.com'], function () {
    Route::get('users', [UserController::class, 'index']);
});

嵌套路由組（Nested Groups）

你還可以在路由組中再嵌套一個路由組，實現更細粒度的控制：

 Route::group(['prefix' => 'admin', 'middleware' => 'auth'], function () {
    Route::group(['namespace' => 'Settings'], function () {
        Route::get('profile', [ProfileController::class, 'index']);
        Route::get('email', [EmailController::class, 'index']);
    });
});

這樣/admin/profile和/admin/email都會繼承prefix和middleware ，同時控制器使用Settings子命名空間。

小貼士：命名路由組注意事項

如果你希望給組內的路由命名，建議使用as參數為路由組設置前綴：

 Route::group(['prefix' => 'admin', 'as' => 'admin.'], function () {
    Route::get('dashboard', [AdminController::class, 'dashboard'])->name('dashboard');
});

這樣你可以通過route('admin.dashboard')來調用，命名更清晰，也方便維護。

基本上就這些。 Route Groups 的核心是“復用”和“分組管理”，雖然寫法簡單，但用好了能顯著提昇路由的可維護性。

以上是如何定義和使用Laravel中的路線組。的詳細內容。更多資訊請關注PHP中文網其他相關文章！