Laravel路由組件：簡(jiǎn)化高效的路由管理

本文探討Laravel強(qiáng)大的路由組件，它提供簡(jiǎn)潔高效的路由管理方式，支持簡(jiǎn)潔的URL、參數(shù)、分組、命名以及路由組的事件保護(hù)等特性。其路由模型綁定功能通過(guò)類型提示模型名稱而非ID參數(shù)，簡(jiǎn)化了重複性任務(wù)的處理。

核心要點(diǎn)：

• Laravel的路由組件提供簡(jiǎn)單高效的路由管理方式，支持簡(jiǎn)潔URL、參數(shù)、分組、命名以及事件保護(hù)路由組等功能。路由模型綁定功能通過(guò)類型提示模型名稱而非ID參數(shù)，簡(jiǎn)化了重複性任務(wù)處理。
• Laravel的路由模型綁定會(huì)自動(dòng)使用ID參數(shù)解析模型，如果模型不存在則拋出異常。 App\Exceptions\Handler@render方法負(fù)責(zé)將異常轉(zhuǎn)換為HTTP響應(yīng)，可用於處理ModelNotFoundException並重定向到404頁(yè)面。
• Laravel允許自定義路由模型綁定，例如重寫(xiě)父模型類的getRouteKeyName方法來(lái)使用不同的屬性名稱，比如UUID。這有助於避免將內(nèi)部ID暴露給最終用戶。

示例：管理後臺(tái)類別

假設(shè)數(shù)據(jù)庫(kù)中有一系列類別，管理員可在後臺(tái)管理這些類別。路由文件如下：

Route::group(['namespace' => 'Admin', 'prefix' => 'admin', 'middleware' => 'admin'], function () {
    Route::resource('categories', 'CategoriesController');
});

CategoriesController類包含七個(gè)資源方法。在edit操作中，需要檢查待編輯的類別是否存在於數(shù)據(jù)庫(kù)中，否則返回錯(cuò)誤消息並重定向：

public function edit($id)
{
    $category = Category::find($id);
    if (!$category) {
        return redirect()->route('admin.categories.index')->withErrors([trans('errors.category_not_found')]);
    }

    // ...
}

路由模型綁定

這是常規(guī)做法，但Laravel提供了一種更優(yōu)化的方式——路由模型綁定。只需類型提示模型名稱即可，無(wú)需ID參數(shù)。

可用路由列表如下：

<code>+--------+-----------+------------------------------------+------------------------------------+----------------------------------------------------------------------+-----------------+
| Domain | Method    | URI                                | Name                               | Action                                                               | Middleware      |
+--------+-----------+------------------------------------+------------------------------------+----------------------------------------------------------------------+-----------------+
|        | GET|HEAD  | admin/categories                   | admin.categories.index             | App\Http\Controllers\Admin\CategoriesController@index                | web,admin       |
|        | POST      | admin/categories                   | admin.categories.store             | App\Http\Controllers\Admin\CategoriesController@store                | web,admin       |
|        | GET|HEAD  | admin/categories/create            | admin.categories.create            | App\Http\Controllers\Admin\CategoriesController@create               | web,admin       |
|        | GET|HEAD  | admin/categories/{categories}      | admin.categories.show              | App\Http\Controllers\Admin\CategoriesController@show                 | web,admin       |
|        | PUT|PATCH | admin/categories/{categories}      | admin.categories.update            | App\Http\Controllers\Admin\CategoriesController@update               | web,admin       |
|        | DELETE    | admin/categories/{categories}      | admin.categories.destroy           | App\Http\Controllers\Admin\CategoriesController@destroy              | web,admin       |
|        | GET|HEAD  | admin/categories/{categories}/edit | admin.categories.edit              | App\Http\Controllers\Admin\CategoriesController@edit                 | web,admin       |</code>

路由參數(shù)為 {categories}，可根據(jù)需要修改。 Laravel提供了一個(gè)修改它的選項(xiàng)：

Route::resource('categories', 'CategoriesController', [
    'parameters' => 'singular',
]);

修改後的路由：

<code>+--------+-----------+------------------------------------+------------------------------------+----------------------------------------------------------------------+-----------------+
| Domain | Method    | URI                                | Name                               | Action                                                               | Middleware      |
+--------+-----------+------------------------------------+------------------------------------+----------------------------------------------------------------------+-----------------+
|        | GET|HEAD  | admin/categories                   | admin.categories.index             | App\Http\Controllers\Admin\CategoriesController@index                | web,admin       |
|        | POST      | admin/categories                   | admin.categories.store             | App\Http\Controllers\Admin\CategoriesController@store                | web,admin       |
|        | GET|HEAD  | admin/categories/create            | admin.categories.create            | App\Http\Controllers\Admin\CategoriesController@create               | web,admin       |
|        | GET|HEAD  | admin/categories/{category}        | admin.categories.show              | App\Http\Controllers\Admin\CategoriesController@show                 | web,admin       |
|        | PUT|PATCH | admin/categories/{category}        | admin.categories.update            | App\Http\Controllers\Admin\CategoriesController@update               | web,admin       |
|        | DELETE    | admin/categories/{category}        | admin.categories.destroy           | App\Http\Controllers\Admin\CategoriesController@destroy              | web,admin       |
|        | GET|HEAD  | admin/categories/{category}/edit   | admin.categories.edit              | App\Http\Controllers\Admin\CategoriesController@edit                 | web,admin       |</code>

注意： Laravel 5.3 默認(rèn)使用單數(shù)形式。

public function edit(Category $category)
{
    return view('admin.categories.edit', [
        'category'      => $category
    ]);
}

現(xiàn)在，Laravel將自動(dòng)使用ID參數(shù)解析類別，如果模型不存在則拋出異常。

注意： 除非參數(shù)有默認(rèn)值，否則它使用 findOrFail Eloquent 方法來(lái)解析參數(shù)。

異常處理

App\Exceptions\Handler@render 方法負(fù)責(zé)將異常轉(zhuǎn)換為HTTP響應(yīng)。我們將使用它來(lái)處理 ModelNotFoundException 並重定向到404頁(yè)面。

該方法具有 request 和 exception 參數(shù)，可用於確定要執(zhí)行的操作。

Route::group(['namespace' => 'Admin', 'prefix' => 'admin', 'middleware' => 'admin'], function () {
    Route::resource('categories', 'CategoriesController');
});

我們測(cè)試拋出的異常是否為 ModelNotFoundException 的實(shí)例。我們還可以測(cè)試模型名稱以顯示正確的錯(cuò)誤消息。為了避免為所有模型添加多個(gè) if 測(cè)試，我們可以創(chuàng)建一個(gè)索引消息數(shù)組，並使用模型類名來(lái)提取正確的消息。

參數(shù)解析

Laravel 使用名稱和類型提示來(lái)解析路由參數(shù)。如果參數(shù)類型是模型，則它嘗試使用 ID 在數(shù)據(jù)庫(kù)中查找記錄，如果找不到記錄則失敗。

自定義路由鍵

為避免將內(nèi)部ID暴露給最終用戶，通常使用UUID。但由於Laravel使用表主鍵來(lái)解析綁定參數(shù)，因此始終會(huì)拋出錯(cuò)誤！

為此，Laravel允許我們重寫(xiě)父模型類的getRouteKeyName方法。該方法應(yīng)返回屬性名稱，在本例中為UUID。

public function edit($id)
{
    $category = Category::find($id);
    if (!$category) {
        return redirect()->route('admin.categories.index')->withErrors([trans('errors.category_not_found')]);
    }

    // ...
}

現(xiàn)在，如果我們嘗試使用UUID編輯特定類別，它應(yīng)該按預(yù)期工作，例如：http://ipnx.cn/link/604541b9b9f266538ed001ea49fcc956。

Laravel路由模型綁定的常見(jiàn)問(wèn)題解答 (這部分內(nèi)容已在原文中詳細(xì)解答，此處不再贅述)

希望以上內(nèi)容對(duì)您有所幫助！

以上是Laravel快速提示：模型路線綁定的詳細(xì)內(nèi)容。更多資訊請(qǐng)關(guān)注PHP中文網(wǎng)其他相關(guān)文章！