Voyons de plus pr\u00e8s comment g\u00e9rer les routes dans Laravel.
Backend Routing et Cross-Site Scripting dans Laravel<\/h2>\n
Sur un serveur, il existe des routes publiques et priv\u00e9es. Les routes publiques peuvent \u00eatre une source d’inqui\u00e9tude en raison de la possibilit\u00e9 de cross-site scripting (XSS), un type d’attaque par injection<\/a> qui peut vous rendre, vous et vos utilisateurs, vuln\u00e9rables aux acteurs malveillants<\/a>.<\/p>\n Le probl\u00e8me est qu’un utilisateur peut \u00eatre redirig\u00e9 d’une route qui ne n\u00e9cessite pas de jeton de session vers une route qui en n\u00e9cessite un – et il aura toujours acc\u00e8s sans le jeton.<\/p>\n\n La fa\u00e7on la plus simple de r\u00e9soudre ce probl\u00e8me est d’appliquer un nouvel en-t\u00eate HTTP, en ajoutant \u00ab referrer \u00bb \u00e0 l’itin\u00e9raire pour att\u00e9nuer ce sc\u00e9nario :<\/p>\n Dans Laravel<\/a>, les routes permettent aux utilisateurs d’acheminer la req\u00eate appropri\u00e9e vers le contr\u00f4leur souhait\u00e9. La route Laravel la plus basique accepte un Uniform Asset Identifier (votre chemin de route) et une fermeture qui peut \u00eatre \u00e0 la fois une fonction ou une classe.<\/p>\n Dans Laravel, les routes sont cr\u00e9\u00e9es dans les fichiers web.php<\/strong> et api.php<\/strong>. Laravel est livr\u00e9 avec deux routes par d\u00e9faut : une pour le WEB et une pour l’API.<\/p>\n Ces routes r\u00e9sident dans le dossier routes\/<\/strong>, mais elles sont charg\u00e9es dans le fichier Providers\/RouteServiceProvider.php<\/strong>.<\/p>\n Au lieu de proc\u00e9der ainsi, nous pouvons charger les routes directement dans RouteServiceProvider.php<\/strong>, en sautant compl\u00e8tement le dossier routes\/<\/strong>.<\/p>\n Lorsque nous d\u00e9finissons une route, nous souhaitons g\u00e9n\u00e9ralement rediriger l’utilisateur qui y acc\u00e8de, et les raisons en sont tr\u00e8s vari\u00e9es. Cela peut \u00eatre parce qu’il s’agit d’une route obsol\u00e8te et que nous avons chang\u00e9 le backend ou le serveur, ou parce que nous voulons installer l’authentification \u00e0 deux facteurs (2FA)<\/a>, etc.<\/p>\n Laravel dispose d’un moyen facile de le faire. Gr\u00e2ce \u00e0 la simplicit\u00e9 du framework, nous pouvons utiliser la m\u00e9thode de redirection sur la fa\u00e7ade Route, qui accepte la route d’entr\u00e9e et la route vers laquelle \u00eatre redirig\u00e9.<\/p>\n En option, nous pouvons donner le code d’\u00e9tat pour la redirection comme troisi\u00e8me param\u00e8tre. La m\u00e9thode A l’int\u00e9rieur des routes de redirection, il nous est interdit d’utiliser les mots-cl\u00e9s \u00ab destination \u00bb et \u00ab status \u00bb comme param\u00e8tres car ils sont r\u00e9serv\u00e9s par Laravel.<\/p>\n Les vues sont les fichiers .blade.php<\/strong> que nous utilisons pour rendre le frontend de notre application Laravel. Elles utilisent le moteur de templating blade, et c’est la mani\u00e8re par d\u00e9faut de construire une application full-stack en utilisant uniquement Laravel.<\/p>\n Si nous voulons que notre route renvoie une vue, nous pouvons simplement utiliser la m\u00e9thode view sur la fa\u00e7ade Route. Elle accepte un param\u00e8tre de route, un nom de vue et un tableau facultatif de valeurs \u00e0 transmettre \u00e0 la vue.<\/p>\n Supposons que notre vue veuille dire \u00ab Hello, Au fur et \u00e0 mesure que la taille de votre application augmente, le nombre de requ\u00eates qui doivent \u00eatre achemin\u00e9es augmente \u00e9galement. Et avec un grand volume d’informations peut venir une grande confusion.<\/p>\n C’est l\u00e0 que le site Il affichera une liste de toutes les routes sans les middlewares. Pour cela, nous devons utiliser le drapeau Dans une situation o\u00f9 vous utilisez une conception pilot\u00e9e par le domaine o\u00f9 vos routes ont des noms sp\u00e9cifiques dans leurs chemins, vous pouvez utiliser les capacit\u00e9s de filtrage de cette commande comme suit :<\/p>\n Ceci montrera seulement les routes qui commencent par api\/account<\/strong>.<\/p>\n D’autre part, nous pouvons demander \u00e0 Laravel d’exclure ou d’inclure des routes d\u00e9finies par des tiers en utilisant les options Parfois, vous pouvez avoir besoin de capturer des segments de l’URI avec la route, comme un ID utilisateur ou un jeton. Nous pouvons le faire en d\u00e9finissant un param\u00e8tre de route, qui est toujours encadr\u00e9 par des accolades ( Si nos routes ont des d\u00e9pendances dans leurs callbacks, le conteneur de services Laravel les injectera automatiquement :<\/p>\n Les param\u00e8tres n\u00e9cessaires de Laravel sont des param\u00e8tres dans les routes que nous ne sommes pas autoris\u00e9s \u00e0 ignorer lorsque nous effectuons un appel. Sinon, une erreur sera d\u00e9clench\u00e9e :<\/p>\n Maintenant, dans le GetGdprDataController.php<\/strong>, nous aurons un acc\u00e8s direct au param\u00e8tre $userId<\/strong>.<\/p>\n Une route peut prendre un nombre quelconque de param\u00e8tres. Ils sont inject\u00e9s dans les callbacks\/contr\u00f4leurs de la route en fonction de l’ordre dans lequel ils sont list\u00e9s :<\/p>\n Dans une situation o\u00f9 nous voulons faire quelque chose sur une route lorsque seul un param\u00e8tre est pr\u00e9sent et rien d’autre, le tout sans affecter l’application enti\u00e8re, nous pouvons ajouter un param\u00e8tre optionnel. Ces param\u00e8tres facultatifs sont signal\u00e9s par l’adresse Laravel<\/a> nous fournit un moyen de filtrer ce \u00e0 quoi doivent ressembler nos param\u00e8tres facultatifs ou n\u00e9cessaires.<\/p>\n Disons que nous voulons une cha\u00eene de caract\u00e8res d’un ID utilisateur. Nous pouvons le valider ainsi au niveau de la route en utilisant la m\u00e9thode La m\u00e9thode Nous pouvons aller plus loin et appliquer la validation \u00e0 toutes les routes de notre application en utilisant la m\u00e9thode Cela validera chaque param\u00e8tre de Comme nous pouvons le voir, Laravel utilise le caract\u00e8re Le seul inconv\u00e9nient est qu’il ne sera pris en charge que dans le dernier segment du chemin.<\/p>\n Comme son nom l’indique, nous pouvons nommer les routes, ce qui permet de g\u00e9n\u00e9rer des URL<\/a> ou des redirections pour des routes sp\u00e9cifiques.<\/p>\n Une fa\u00e7on simple de cr\u00e9er une route nomm\u00e9e est fournie par la m\u00e9thode Les groupes de routes vous permettent de partager des attributs de route comme les intergiciels sur un grand nombre de routes sans avoir \u00e0 les red\u00e9finir sur chaque route.<\/p>\n L’attribution d’un intergiciel \u00e0 toutes les routes que nous avons nous permet de les combiner dans un groupe, d’abord en utilisant la m\u00e9thode Lorsqu’un groupe utilise le m\u00eame contr\u00f4leur, nous pouvons utiliser la m\u00e9thode Un nom de sous-domaine<\/a> est un \u00e9l\u00e9ment d’information suppl\u00e9mentaire ajout\u00e9 au d\u00e9but du nom de domaine d’un site web. Cela permet aux sites web de s\u00e9parer et d’organiser leur contenu pour des fonctions sp\u00e9cifiques, comme les boutiques en ligne, les blogs, les pr\u00e9sentations, etc. du reste du site web.<\/p>\n Nos routes peuvent \u00eatre utilis\u00e9es pour g\u00e9rer le routage des sous-domaines. Nous pouvons attraper le domaine et une partie du sous-domaine pour les utiliser dans notre contr\u00f4leur et notre route. Avec l’aide de la m\u00e9thode Lorsque nous avons un groupe de routes, au lieu de les modifier une par une, nous pouvons utiliser les utilitaires suppl\u00e9mentaires que Laravel fournit, tels que La m\u00e9thode Cela nous permet de cr\u00e9er de nouvelles choses comme des routes d’administration sans avoir \u00e0 modifier chaque nom ou pr\u00e9fixe pour les identifier :<\/p>\n Maintenant, les URI de ces routes seront Lors du d\u00e9ploiement de l’application sur les serveurs de production, un bon d\u00e9veloppeur Laravel<\/a> tirera parti du cache des routes de Laravel.<\/p>\n La mise en cache des routes diminue le temps n\u00e9cessaire \u00e0 l’enregistrement de toutes les routes de l’application.<\/p>\n En ex\u00e9cutant D\u00e9sormais, toute autre requ\u00eate chargera ce fichier de cache<\/a> s’il existe. Par cons\u00e9quent, notre application ne doit plus analyser et convertir les entr\u00e9es du fichier de route en objets En n’utilisant pas la fonction de mise en cache des routes fournie par Laravel, votre application risque de fonctionner plus lentement qu’elle ne le pourrait, ce qui pourrait \u00e0 son tour diminuer les ventes, la r\u00e9tention des utilisateurs et la confiance dans votre marque<\/a>.<\/p>\n En fonction de l’\u00e9chelle de votre projet et du nombre de routes, l’ex\u00e9cution d’une simple commande de mise en cache des routes peut acc\u00e9l\u00e9rer votre application<\/a> de 130 % \u00e0 500 % – un gain consid\u00e9rable pour un effort quasi-nul.<\/p>\n Le routage est l’\u00e9pine dorsale du d\u00e9veloppement backend. Le framework Laravel excelle dans ce domaine en fournissant une mani\u00e8re verbeuse de d\u00e9finir et de g\u00e9rer les routes.<\/p>\n'main' => [\n 'path' => '\/main',\n 'referrer' => 'required,refresh-empty',\n 'target' => ControllerDashboardController::class . '::mainAction'\n]<\/code><\/pre>\nRoutage de base de Laravel<\/h2>\n
![\"\u00c9tat](\"https:\/\/kinsta.com\/wp-content\/uploads\/2022\/10\/laravel-route-provider-default.png\")
<\/a>![\"Chargement](\"https:\/\/kinsta.com\/wp-content\/uploads\/2022\/10\/loading-laravel-routes-directly.png\")
<\/a>Redirections<\/h3>\n
permanentRedirect<\/code> fera la m\u00eame chose que la m\u00e9thode redirect<\/code>, sauf qu’elle renverra toujours un code d’\u00e9tat 301<\/a> :<\/p>\n\/\/ Simple redirect\nRoute::redirect(\"\/class\", \"\/myClass\");\n\n\/\/ Redirect with custom status\nRoute::redirect(\"\/home\", \"\/office\", 305);\n\n\/\/ Route redirect with 301 status code\nRoute::permanentRedirect(\"\/home\", \"office\");<\/code><\/pre>\n\/\/ Illegal to use\nRoute::redirect(\"\/home\", \"\/office\/{status}\");<\/code><\/pre>\nVues<\/h3>\n
\/\/ When the user accesses my-domain.com\/homepage\n\/\/ the homepage.blade.php file will be rendered\nRoute::view(\"\/homepage\", \"homepage\");<\/code><\/pre>\n{name}<\/code>\u00bb en passant un tableau optionnel avec ce param\u00e8tre. Nous pouvons le faire avec le code suivant (si le param\u00e8tre manquant est requis dans la vue, la requ\u00eate \u00e9chouera et lancera une erreur) :<\/p>\nRoute::view('\/homepage', 'homepage', ['name' => \"Kinsta\"]);<\/code><\/pre>\nListe de routes<\/h3>\n
artisan route:list command<\/code> peut nous aider. Il fournit une vue d’ensemble de toutes les routes qui sont d\u00e9finies dans l’application, leurs middlewares et leurs contr\u00f4leurs.<\/p>\nphp artisan route:list<\/code><\/pre>\n-v<\/code>:<\/p>\nphp artisan route:list -v<\/code><\/code><\/pre>\nphp artisan route:list \u2013path=api\/account<\/code><\/pre>\n\u2013except-vendor<\/code> ou \u2013only-vendor<\/code>.<\/p>\nParam\u00e8tres des routes<\/h2>\n
{}<\/code>) et ne doit comporter que des caract\u00e8res alphab\u00e9tiques.<\/p>\nuse IlluminateHttpRequest;\nuse Controllers\/DashboardController;\nRoute::post('\/dashboard\/{id}, function (Request $request, string $id) {\n return 'User:' . $id;\n}\nRoute::get('\/dashboard\/{id}, DashboardController.php);<\/code><\/pre>\nParam\u00e8tres n\u00e9cessaires<\/h3>\n
Route::post(\"\/gdpr\/{userId}\", GetGdprDataController.php\");<\/code><\/pre>\npublic function __invoke(int $userId) {\n \/\/ Use the userId that we received\u2026\n}<\/code><\/pre>\n \/\/ api.php\nRoute::post('\/gdpr\/{userId}\/{userName}\/{userAge}', GetGdprDataController.php);\n\/\/ GetGdprDataController.php\npublic function __invoke(int $userId, string $userName, int $userAge) {\n \/\/ Use the parameters\u2026\n}<\/code><\/pre>\nParam\u00e8tres facultatifs<\/h3>\n
?<\/code> qui leur est accol\u00e9e :<\/p>\n Route::get('\/user\/{age?}', function (int $age = null) {\n if (!$age) Log::info(\"User doesn't have age set\");\n else Log::info(\"User's age is \" . $age);\n}\nRoute::get('\/user\/{name?}', function (int $name = \"John Doe\") {\n Log::info(\"User's name is \" . $name);\n}<\/code><\/pre>\nRoute Wildcard<\/h3>\n
where<\/code>.<\/p>\nwhere<\/code> accepte le nom du param\u00e8tre et la r\u00e8gle regex qui sera appliqu\u00e9e \u00e0 la validation. Par d\u00e9faut, elle prend le premier param\u00e8tre, mais si nous en avons plusieurs, nous pouvons passer un tableau avec le nom du param\u00e8tre comme cl\u00e9 et la r\u00e8gle comme valeur, et Laravel les analysera tous pour nous :<\/p>\nRoute::get('\/user\/{age}', function (int $age) {\n \/\/\n}->where('age', '[0-9]+');\nRoute::get('\/user\/{age}', function (int $age) {\n \/\/\n}->where('[0-9]+');\nRoute::get('\/user\/{age}\/{name}', function (int $age, string $name) {\n \/\/\n}->where(['age' => '[0-9]+', 'name' => '[a-z][A-z]+');<\/code><\/pre>\npattern<\/code> sur la fa\u00e7ade Route<\/code>:<\/p>\n Route::pattern('id', '[0-9]+');<\/code><\/pre>\nid<\/code> avec cette expression regex. Et une fois que nous l’avons d\u00e9finie, elle sera automatiquement appliqu\u00e9e \u00e0 toutes les routes utilisant ce nom de param\u00e8tre.<\/p>\n\/<\/code> comme s\u00e9parateur dans le chemin. Si nous voulons l’utiliser dans le chemin, nous devons l’autoriser explicitement \u00e0 faire partie de notre espace r\u00e9serv\u00e9 en utilisant une regex where<\/code>.<\/p>\n Route::get('\/find\/{query}', function ($query) {\n \/\/\n})->where('query', , '.*');<\/code><\/pre>\nRoutes nomm\u00e9es<\/h2>\n
Comment cr\u00e9er des routes nomm\u00e9es<\/h3>\n
name<\/code> encha\u00een\u00e9e sur la fa\u00e7ade Route<\/code>. Le nom de chaque route doit \u00eatre unique :<\/p>\n Route::get('\/', function () {\n})->name(\"homepage\");<\/code><\/pre>\nGroupes de routes<\/h2>\n
Middleware<\/h3>\n
group<\/code>. Une chose \u00e0 consid\u00e9rer est que les intergiciels sont ex\u00e9cut\u00e9s dans l’ordre dans lequel ils sont appliqu\u00e9s au groupe :<\/p>\n Route:middleware(['AuthMiddleware', 'SessionMiddleware'])->group(function () {\n Route::get('\/', function() {} );\n Route::post('\/upload-picture', function () {} );\n});<\/code><\/pre>\nContr\u00f4leurs<\/h3>\n
controller<\/code> pour d\u00e9finir le contr\u00f4leur commun \u00e0 toutes les routes de ce groupe. Nous devons maintenant sp\u00e9cifier la m\u00e9thode que l’itin\u00e9raire appellera.<\/p>\n Route::controller(UserController::class)->group(function () {\n Route::get('\/orders\/{userId}', 'getOrders');\n Route::post('\/order\/{id}', 'postOrder');\n});<\/code><\/pre>\nRoutage de sous-domaines<\/h3>\n
domain<\/code> sur la fa\u00e7ade Route<\/code>, nous pouvons regrouper nos routes sous un seul domaine :<\/p>\n Route::domain('{store}.enterprise.com')->group(function() {\n Route::get('order\/{id}', function (Account $account, string $id) {\n \/\/ Your Code\n }\n});<\/code><\/pre>\nPr\u00e9fixes et pr\u00e9fixes de nom<\/h3>\n
prefix<\/code> et name<\/code> sur la fa\u00e7ade Route<\/code>.<\/p>\nprefix<\/code> peut \u00eatre utilis\u00e9e pour pr\u00e9fixer chaque route du groupe avec un URI donn\u00e9, et la m\u00e9thode name<\/code> peut \u00eatre utilis\u00e9e pour pr\u00e9fixer chaque nom de route avec une cha\u00eene donn\u00e9e.<\/p>\n Route::name('admin.\")->group(function() {\n Route::prefix(\"admin\")->group(function() {\n Route::get('\/get')->name('get');\n Route::put('\/put')->name(put');\n Route::post('\/post')->name('post');\n });\n});<\/code><\/pre>\nadmin\/get<\/code>, admin\/put<\/code>, admin\/post<\/code>, et les noms admin.get<\/code>, admin.put<\/code>, et admin.post<\/code>.<\/p>\nMise en cache des routes<\/h2>\n
Qu’est-ce que la mise en cache des routes ?<\/h3>\n
php artisan route:cache<\/code> une instance de Illuminate\/Routing\/RouteCollection<\/code> est g\u00e9n\u00e9r\u00e9e, et apr\u00e8s avoir \u00e9t\u00e9 encod\u00e9e, la sortie s\u00e9rialis\u00e9e est \u00e9crite dans bootstrap\/cache.routes.php<\/code>.<\/p>\nIlluminate\/Routing\/Route<\/code> dans Illuminate\/Routing\/RouteCollection<\/code>.<\/p>\nPourquoi il est important d’utiliser la mise en cache des routes<\/h3>\n
R\u00e9sum\u00e9<\/h2>\n