Créer des routes

1. Définir une route

Ce chapitre se concentre sur le fichier routes/web.php qui contient les routes dédiées à l’application web. Mais une application Laravel possède par défaut plusieurs fichiers dans le dossier routes :

1. Déclarer des paramètres

Il est parfois nécessaire de capturer certaines parties de l’URI d’une route pour ensuite la traiter. Par exemple, dans le cas d’un site de recettes de cuisine, il est nécessaire de capturer l’identifiant de la recette indiquée dans la barre d’adresse par le visiteur pour chercher la recette correspondante dans la base de données et la retourner :

Il paraît évident que les routes ne doivent pas être créées une par une pour chaque nouvelle recette ajoutée. Il faut donc utiliser des paramètres variables dans les routes.

Pour déclarer un paramètre variable dans l’URI d’une route, il faut utiliser des accolades autour du nom du paramètre. Au lieu d’écrire recette/1, recette/2 et recette/3 dans l’URI de la route, il faut écrire recette/{id}. Les paramètres déclarés doivent uniquement contenir des caractères alphabétiques et des tirets bas _ .

2. Utiliser les paramètres capturés

Pour traiter la variable capturée, il faut la passer en paramètre de la fonction de rappel de la route en lui donnant le même nom. Dans le code ci-dessous, une seule route est déclarée pour traiter toutes les recettes de la base de données.

Paramètre de route, fichier routes/web.php

Route::get(‘recette/{id}', function ($id) { 
    return ‘Identifiant de la recette :' . $id; 
});  

Le paramètre...

1. Les types de réponses

Dans les exemples précédents, la fonction de rappel a toujours retourné une réponse sous la forme d’une chaîne de caractères : « Bienvenue chez Bonjour Taxi ! », « Gratuit pour les particuliers », etc.

Dans le détail, quand un visiteur déclenche l’exécution de ce code, c’est-à-dire en appelant la route en question dans son navigateur, la fonction de rappel renvoie le texte au framework. Ce texte est transmis au serveur qui le transmet à son tour au navigateur du client. Le client voit alors le texte affiché dans son navigateur.

Il existe cependant d’autres types de réponses.

Le système de réponse proposé par Laravel permet de retourner du texte, du HTML (grâce à un système de vue qui sera étudié au chapitre suivant) du JSON (dans le cas d’une création d’API REST par exemple) ou même des fichiers pour permettre un téléchargement.

Ainsi, la fonction response peut être utilisée dans les fonctions de rappel, bien que Laravel fournisse parfois quelques facilités qui permettent de s’en passer.

2. Les réponses textuelles

Les réponses textuelles des exemples précédents ont été générées en retournant une chaîne de caractères à la fin de la fonction de rappel. C’est la méthode la plus simple pour effectuer...

1. Préfixes de routes

Lorsqu’une application web prend de l’ampleur, elle peut rapidement avoir plusieurs dizaines de routes, et certaines d’entre elles partagent des propriétés communes.

Par exemple, en créant une interface d’administration, la personne en charge du développement de l’application peut vouloir regrouper toutes les routes derrière un même chemin ayant pour préfixe /admin :

Il est bien entendu possible de créer toutes ces routes en les déclarant les unes à la suite des autres. Et c’est ce qu’il serait fait habituellement lors de la phase de conception :

Routes d’administration

Route::get('admin/stats', function () { /* ... */ }); 
 
Route::get('admin/users', function () { /* ... */ }); 
 
Route::get('admin/users/{id}', function ($id) { /* ... */ }); 
 
Route::get('admin/users/create', function () { /* ... */ }); 
 
Route::get('admin/logs', function () { /* ... */ });  

Les groupes de routes permettent de déclarer une liste de routes partageant un préfixe commun (en l’occurrence admin) à l’aide des méthodes prefix et group. Pour éviter de répéter admin pour chacune des routes d’administration, il est possible de les organiser de la manière ci-dessous :

Routes...