Astuce rapide de Laravel: liaison de l'itinéraire du modèle

Composant de routage Laravel: Simplifier et efficace la gestion du routage

Cet article traite de la puissante composante de routage de Laravel, qui fournit des méthodes de gestion de routage simples et efficaces, et prend en charge les URL, les paramètres, les groupes, la dénomination et la protection des événements simples des groupes de routage. Sa fonction de liaison de modèle de routage simplifie le traitement des tâches répétitives en invitant le nom du modèle plutôt que les paramètres d'ID.

Points de base:

• Le composant de routage de Laravel fournit des méthodes de gestion de routage simples et efficaces, soutenant les URL simples, paramètres, groupes, dénomination et groupes de routage de protection des événements. La fonction de liaison du modèle de routage simplifie le traitement des tâches répétitives en invitant le nom du modèle plutôt que les paramètres d'ID.
• La liaison du modèle de routage de Laravel analysera automatiquement le modèle à l'aide des paramètres d'ID et lèvera une exception si le modèle n'existe pas. La méthode App\Exceptions\Handler@render est responsable de la conversion de l'exception en une réponse HTTP et peut être utilisée pour traiter ModelNotFoundException et rediriger vers une page 404.
• Laravel permet la liaison de modèle de routage personnalisée, comme la réécriture de la méthode getRouteKeyName de la classe de modèle parent pour utiliser différents noms d'attribut, tels que UUID. Cela permet d'éviter d'exposer des ID internes à l'utilisateur final.

Exemple: Gérer la catégorie backend

Supposons qu'il existe une série de catégories dans la base de données que les administrateurs peuvent gérer en arrière-plan. Le fichier de routage est le suivant:

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

La classe

CategoriesController contient sept méthodes de ressources. Dans l'opération edit, vous devez vérifier si la catégorie à modifier existe dans la base de données, sinon un message d'erreur sera retourné et redirigé:

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

    // ...
}

Respect de la liaison du modèle de routage

Il s'agit d'une pratique courante, mais Laravel fournit une manière plus optimisée - la liaison du modèle de routage. Le type simple invite le nom du modèle, aucun paramètre ID n'est requis.

La liste des routes disponibles est la suivante:

<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>

Les paramètres de routage sont {categories}, qui peuvent être modifiés selon les besoins. Laravel offre une option pour le modifier:

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

Route modifiée:

<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>

Remarque: Laravel 5.3 utilise la forme singulière par défaut.

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

Laravel analysera désormais automatiquement la catégorie avec le paramètre ID, lançant une exception si le modèle n'existe pas.

Remarque: Sauf si le paramètre a une valeur par défaut, il utilise la méthode éloquente findOrFail pour analyser les paramètres.

Gestion des exceptions

La méthode

App\Exceptions\Handler@render est responsable de la conversion d'exceptions en réponses HTTP. Nous l'utiliserons pour gérer ModelNotFoundException et rediriger vers la page 404.

Cette méthode a les paramètres request et exception, qui peuvent être utilisés pour déterminer l'action à effectuer.

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

Nous testons si l'exception lancée est une instance de ModelNotFoundException. Nous pouvons également tester le nom du modèle pour afficher le message d'erreur correct. Pour éviter d'ajouter plusieurs tests if à tous les modèles, nous pouvons créer un tableau de messages indexés et utiliser le nom de classe de modèle pour extraire les messages corrects.

Analyse des paramètres

Laravel utilise le nom et le type des conseils pour résoudre les paramètres de routage. Si le type de paramètre est un modèle, il essaie de rechercher des enregistrements dans la base de données à l'aide de l'ID et échoue si l'enregistrement ne peut être trouvé.

Clé de routage personnalisé

Pour éviter d'exposer les ID internes aux utilisateurs finaux, les UUID sont généralement utilisés. Mais puisque Laravel utilise des clés primaires de table pour analyser les paramètres liés, une erreur est toujours lancée!

Pour ce faire, Laravel nous permet de réécrire la méthode getRouteKeyName de la classe de modèle parent. Cette méthode doit renvoyer le nom de la propriété, dans ce cas, UUID.

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

    // ...
}

Maintenant, si nous essayons de modifier une catégorie spécifique avec UUID, cela devrait fonctionner comme prévu, par exemple: https://www.php.cn/link/604541b9b9f266538ed001ea49fcc956 .

FAQ sur Laravel Routing Model Binding (Cette partie du contenu a été répondue en détail dans le texte d'origine et ne sera pas décrite ici)

J'espère que le contenu ci-dessus vous sera utile!

Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!