Daremos uma olhada de perto em como gerenciar as rotas no Laravel.<\/p>\n
Routing e Cross-Site Scripting no Laravel<\/h2>\n
Em um servidor, existem tanto rotas p\u00fablicas quanto privadas. Rotas p\u00fablicas podem ser um motivo de preocupa\u00e7\u00e3o devido \u00e0 possibilidade de cross-site scripts (XSS), um tipo de ataque de inje\u00e7\u00e3o<\/a> que pode deixar voc\u00ea e seus usu\u00e1rios vulner\u00e1veis a agentes mal-intencionados<\/a>.<\/p>\n O problema \u00e9 que um usu\u00e1rio pode ser redirecionado de uma rota que n\u00e3o requer um token de sess\u00e3o para uma que o fa\u00e7a – e ele ainda ter\u00e1 acesso sem o token.<\/p>\n\n A maneira mais simples de resolver este problema \u00e9 aplicar um novo cabe\u00e7alho HTTP, adicionando “referrer” \u00e0 rota para mitigar este cen\u00e1rio:<\/p>\n No Laravel<\/a>, as rotas permitem que os usu\u00e1rios encaminhem a solicita\u00e7\u00e3o apropriada ao controlador desejado. A Rota Laravel mais b\u00e1sica aceita um Identificador Uniforme de Ativos (seu caminho de rota) e um fechamento que pode ser tanto uma fun\u00e7\u00e3o quanto uma classe.<\/p>\n As rotas s\u00e3o criadas dentro dos arquivos web.php<\/strong> e api.php<\/strong>. Laravel vem com duas rotas por padr\u00e3o: uma para a WEB e outra para a API.<\/p>\n Estas rotas residem nas rotas\/ <\/strong>pasta, mas elas s\u00e3o carregadas no arquivo Providers\/RouteServiceProvider.php<\/strong>.<\/p>\n Ao inv\u00e9s de fazer isso, podemos carregar as rotas diretamente no RouteServiceProvider.php<\/strong>, pulando completamente as rotas\/<\/strong> pasta.<\/p>\n Quando definimos uma rota, geralmente queremos redirecionar o usu\u00e1rio que tenha acesso, e as raz\u00f5es para isso variam muito. Pode ser porque \u00e9 uma rota depreciada e mudamos o backend ou o servidor, ou pode ser porque queremos instalar autentica\u00e7\u00e3o de dois fatores (2FA)<\/a>, e assim por diante.<\/p>\n Laravel tem uma maneira f\u00e1cil de fazer isso. Gra\u00e7as \u00e0 simplicidade da framework, podemos usar o m\u00e9todo de redirecionamento no frontend da Rota, que aceita a rota de entrada e a rota para ser redirecionada.<\/p>\n Opcionalmente, podemos dar o c\u00f3digo de status para o redirecionamento como o terceiro par\u00e2metro. O m\u00e9todo Dentro das rotas de redirecionamento, estamos proibidos de usar as palavras-chave “destination” e “status” como par\u00e2metros, pois elas s\u00e3o reservadas pelo Laravel.<\/p>\n As visualiza\u00e7\u00f5es s\u00e3o os arquivos .blade.php<\/strong> que usamos para renderizar o frontend da nossa aplicativo Laravel. Ele usa o mecanismo de templates de l\u00e2mina, e \u00e9 a maneira padr\u00e3o para construir um aplicativo de stack completo usando apenas Laravel.<\/p>\n Se quisermos que nossa rota retorne uma visualiza\u00e7\u00e3o, podemos simplesmente usar o m\u00e9todo de visualiza\u00e7\u00e3o na frontend da Rota. Ele aceita um par\u00e2metro de rota, um nome de visualiza\u00e7\u00e3o e um conjunto opcional de valores a serem passados para a visualiza\u00e7\u00e3o.<\/p>\n Vamos assumir que nossa visualiza\u00e7\u00e3o quer dizer “Ol\u00e1, \u00c0 medida que seu aplicativo crescer, tamb\u00e9m crescer\u00e1 o n\u00famero de solicita\u00e7\u00f5es que precisam ser encaminhadas. E com um grande volume de informa\u00e7\u00f5es pode haver uma grande confus\u00e3o.<\/p>\n Aqui \u00e9 onde o Ele exibir\u00e1 uma lista de todas as rotas sem os middlewares. Para isso, temos que usar a flag Em uma situa\u00e7\u00e3o em que voc\u00ea pode estar usando um projeto orientado por dom\u00ednio onde suas rotas t\u00eam nomes espec\u00edficos em seus caminhos, voc\u00ea pode usar as capacidades de filtragem deste comando dessa forma:<\/p>\n Isto mostrar\u00e1 apenas as rotas que come\u00e7am com api\/account<\/strong>.<\/p>\n Por outro lado, podemos instruir Laravel de excluir ou incluir rotas definidas por terceiros, usando as op\u00e7\u00f5es Algumas vezes voc\u00ea pode precisar capturar segmentos do URI com a rota, como um ID de usu\u00e1rio ou um token. Podemos fazer isso definindo um par\u00e2metro de rota, que est\u00e1 sempre enclausurado em chaves em colchete ( Se nossas rotas tiverem alguma depend\u00eancia em callbacks, o cont\u00eainer de servi\u00e7o do Laravel ir\u00e1 inclu\u00ed-los automaticamente:<\/p>\n Os par\u00e2metros obrigat\u00f3rios do Laravel s\u00e3o par\u00e2metros de rota que n\u00e3o podemos omitir ao fazer uma chamada. Caso contr\u00e1rio, um erro ser\u00e1 retornado:<\/p>\n Agora dentro do GetGdprDataController.php<\/strong> teremos acesso direto ao par\u00e2metro $userId<\/strong>.<\/p>\n Uma rota pode tomar qualquer n\u00famero de par\u00e2metros. Eles s\u00e3o injetados nos callbacks\/controllers da rota com base na ordem em que s\u00e3o listados:<\/p>\n Em uma situa\u00e7\u00e3o em que queremos fazer algo em uma rota quando apenas um par\u00e2metro est\u00e1 presente e nada mais, tudo sem afetar todo o aplicativo, podemos adicionar um par\u00e2metro opcional. Estes par\u00e2metros opcionais s\u00e3o indicados pelo Laravel<\/a> permite que voc\u00ea filtre como os par\u00e2metros opcionais ou obrigat\u00f3rios s\u00e3o exibidos.<\/p>\n Digamos que queremos uma sequ\u00eancia de identifica\u00e7\u00e3o do usu\u00e1rio. Podemos valid\u00e1-lo assim no n\u00edvel da rota usando o m\u00e9todo O m\u00e9todo Podemos levar isso um passo adiante e aplicar a valida\u00e7\u00e3o em todas as rotas em nosso aplicativo, usando o m\u00e9todo Isso ir\u00e1 valer cada par\u00e2metro Como podemos ver, Laravel est\u00e1 usando o personagem A \u00fanica desvantagem \u00e9 que ele ser\u00e1 suportado apenas no \u00faltimo segmento de rota.<\/p>\n Como o nome sugere, podemos nomear rotas, o que torna conveniente gerar URLs<\/a> ou redirecionar para rotas espec\u00edficas.<\/p>\n Uma maneira simples de criar uma rota nomeada \u00e9 fornecida pelo m\u00e9todo Grupos de rotas permitem que voc\u00ea compartilhe atributos de rotas como middlewares por in\u00fameras rotas sem a necessidade de redefini-la em cada rota.<\/p>\n A atribui\u00e7\u00e3o de um middleware a todas as rotas que temos nos permite combin\u00e1-las em um grupo, primeiro usando o m\u00e9todo Quando um grupo utiliza o mesmo controlador, podemos usar o m\u00e9todo Um nome de subdom\u00ednio<\/a> \u00e9 uma parte de informa\u00e7\u00e3o adicional adicionado ao in\u00edcio do nome de dom\u00ednio de um site. Isso permite que os sites separem e organizem seu conte\u00fado para fun\u00e7\u00f5es espec\u00edficas, tais como lojas on-line, blogs, apresenta\u00e7\u00f5es, etc., do resto do site.<\/p>\n Nossas rotas podem ser usadas para lidar com o roteamento de subdom\u00ednios. Podemos pegar o dom\u00ednio e uma parte do subdom\u00ednio para uso em nosso controlador e rota. Com a ajuda do m\u00e9todo Sempre que temos um grupo de rotas, ao inv\u00e9s de modific\u00e1-las uma a uma, podemos recorrer \u00e0s utilidades extras que Laravel fornece, tais como O m\u00e9todo Isso nos permite criar coisas novas como rotas administrativas sem ser necess\u00e1rio modificar cada nome ou prefixo para identific\u00e1-las:<\/p>\n Agora as URIs para estas rotas ser\u00e3o Ao implantar o aplicativo nos servidores de produ\u00e7\u00e3o, um bom desenvolvedor Laravel<\/a> aproveitar\u00e1 o cache de rotas no Laravel.<\/p>\n O cache de rotas diminui a quantidade de tempo que leva para registrar todas as rotas do aplicativo.<\/p>\n Rodando Agora qualquer outra solicita\u00e7\u00e3o ir\u00e1 carregar este arquivo de cache<\/a>, se ele existir. Portanto, nosso aplicativo n\u00e3o tem mais que analisar e converter entradas do arquivo de rota em objetos Ao n\u00e3o usar o recurso de cache de rotas que Laravel fornece, seu aplicativo corre o risco de funcionar mais lentamente do que poderia ser, o que, por sua vez, poderia diminuir as vendas, a reten\u00e7\u00e3o de usu\u00e1rios e a confian\u00e7a em sua marca<\/a>.<\/p>\n Dependendo da escala do seu projeto e de quantas rotas existem, executar um simples comando de cache de rotas pode acelerar seu aplicativo<\/a>\u00a0em qualquer lugar de 130% a 500% – um ganho maci\u00e7o por quase nenhum esfor\u00e7o.<\/p>\n O roteamento \u00e9 a espinha dorsal do desenvolvimento de backend. A framework do Laravel se sobressai nisso ao fornecer uma maneira direta de definir e gerenciar rotas.<\/p>\n'main' => [\n 'path' => '\/main',\n 'referrer' => 'required,refresh-empty',\n 'target' => ControllerDashboardController::class . '::mainAction'\n]<\/code><\/pre>\nRotas b\u00e1sicas no Laravel<\/h2>\n
![\"Estado](\"https:\/\/kinsta.com\/wp-content\/uploads\/2022\/10\/laravel-route-provider-default.png\")
<\/a>![\"Carregando](\"https:\/\/kinsta.com\/wp-content\/uploads\/2022\/10\/loading-laravel-routes-directly.png\")
<\/a>Redirecionamentos<\/h3>\n
permanentRedirect<\/code> far\u00e1 o mesmo que o m\u00e9todo redirect<\/code>, exceto que ele sempre retornar\u00e1 um c\u00f3digo de status 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>\nVisualiza\u00e7\u00f5es<\/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>“, passando um array opcional com esse par\u00e2metro. Podemos fazer exatamente isso com o seguinte c\u00f3digo (se o par\u00e2metro ausente for requerido na visualiza\u00e7\u00e3o, o pedido falhar\u00e1 e lan\u00e7ar\u00e1 um erro):<\/p>\nRoute::view('\/homepage', 'homepage', ['name' => \"Kinsta\"]);<\/code><\/pre>\nLista de rotas<\/h3>\n
artisan route:list command<\/code> pode nos ajudar. Ele fornece uma vis\u00e3o geral de todas as rotas definidas no aplicativo, seus middlewares e controllers.<\/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>\nPar\u00e2metros de rotas<\/h2>\n
{}<\/code>) e deve consistir apenas de caracteres alfab\u00e9ticos.<\/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>\nPar\u00e2metros requeridos<\/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>\nPar\u00e2metros opcionais<\/h3>\n
?<\/code> anexado a eles:<\/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>\nRotas wildcard<\/h3>\n
where<\/code>.<\/p>\nwhere<\/code> aceita o nome do par\u00e2metro e a regra regex que ser\u00e1 aplicada na valida\u00e7\u00e3o. Por padr\u00e3o, ele aceita o primeiro par\u00e2metro, mas se tivermos muitos, podemos passar um array com o nome do par\u00e2metro como a chave e a regra como o valor, e Laravel ir\u00e1 analis\u00e1-los todos para n\u00f3s:<\/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> no frontend Route<\/code>:<\/p>\n Route::pattern('id', '[0-9]+');<\/code><\/pre>\nid<\/code> com esta express\u00e3o regex. E uma vez definida, ela ser\u00e1 automaticamente aplicada a todas as rotas usando esse nome de par\u00e2metro.<\/p>\n\/<\/code> como um separador no caminho. Se quisermos us\u00e1-lo no caminho, temos que permitir explicitamente que ele fa\u00e7a parte do nosso espa\u00e7o reservado usando um regex where<\/code>.<\/p>\n Route::get('\/find\/{query}', function ($query) {\n \/\/\n})->where('query', , '.*');<\/code><\/pre>\nRotas nomeadas<\/h2>\n
Como criar rotas nomeadas<\/h3>\n
name<\/code> acorrentado no frontend Route<\/code>. O nome de cada rota deve ser \u00fanico:<\/p>\n Route::get('\/', function () {\n})->name(\"homepage\");<\/code><\/pre>\nGrupos de rotas<\/h2>\n
Middleware<\/h3>\n
group<\/code>. Uma coisa a ser considerada \u00e9 que os middlewares s\u00e3o executados na ordem em que s\u00e3o aplicados ao grupo:<\/p>\n Route:middleware(['AuthMiddleware', 'SessionMiddleware'])->group(function () {\n Route::get('\/', function() {} );\n Route::post('\/upload-picture', function () {} );\n});<\/code><\/pre>\nController<\/h3>\n
controller<\/code> para definir o controlador comum para todas as rotas dentro desse grupo. Agora temos que especificar o m\u00e9todo que a rota chamar\u00e1.<\/p>\n Route::controller(UserController::class)->group(function () {\n Route::get('\/orders\/{userId}', 'getOrders');\n Route::post('\/order\/{id}', 'postOrder');\n});<\/code><\/pre>\nRotas do subdom\u00ednio<\/h3>\n
domain<\/code> no frontend Route<\/code>, podemos agrupar nossas rotas sob um \u00fanico dom\u00ednio:<\/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>\nPrefixos e prefixos de nome<\/h3>\n
prefix<\/code> e name<\/code> no frontend Route<\/code>.<\/p>\nprefix<\/code> pode ser usado para prefixar cada rota no grupo com um determinado URI, e o m\u00e9todo name<\/code> pode ser usado para prefixar cada nome de rota com uma determinada string.<\/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>, e os nomes admin.get<\/code>, admin.put<\/code>, e admin.post<\/code>.<\/p>\nCache de rotas<\/h2>\n
O que \u00e9 cache de rotas?<\/h3>\n
php artisan route:cache<\/code> \u00e9 gerada uma inst\u00e2ncia de Illuminate\/Routing\/RouteCollection<\/code>, e ap\u00f3s ser codificada, a sa\u00edda serializada \u00e9 escrita para bootstrap\/cache.routes.php<\/code>.<\/p>\nIlluminate\/Routing\/Route<\/code> em Illuminate\/Routing\/RouteCollection<\/code>.<\/p>\nPor que \u00e9 importante usar o cache de rotas<\/h3>\n
Resumo<\/h2>\n