{"id":1757,"date":"2024-11-15T09:37:58","date_gmt":"2024-11-15T12:37:58","guid":{"rendered":"https:\/\/thiagorossi.com.br\/blog\/?p=1757"},"modified":"2025-12-04T12:38:42","modified_gmt":"2025-12-04T15:38:42","slug":"rotas-no-laravel","status":"publish","type":"post","link":"https:\/\/thiagorossi.com.br\/blog\/rotas-no-laravel\/","title":{"rendered":"Rotas no Laravel"},"content":{"rendered":"Tempo de leitura: <\/span> 4<\/span> minutos<\/span><\/span>\n

Rotas no Laravel<\/strong>: As Rotas<\/strong> s\u00e3o o mapa de uma aplica\u00e7\u00e3o Laravel. Elas definem os endpoints<\/em> da sua aplica\u00e7\u00e3o, capturam as requisi\u00e7\u00f5es HTTP (GET, POST, etc.) e as direcionam para a l\u00f3gica apropriada, seja um Controller<\/em>, um Closure<\/em> ou uma View<\/em>.<\/p>\n\n\n\n

Neste artigo, vamos explorar como definir e organizar as rotas no Laravel 12<\/strong>, utilizando as ferramentas de agrupamento e nomea\u00e7\u00e3o para m\u00e1xima efici\u00eancia.<\/p>\n\n\n\n

<\/div>\n\n\n\n

1. \ud83d\udcc4 Arquivos Padr\u00e3o e Tipos B\u00e1sicos de Rotas<\/h2>\n\n\n\n

O Laravel 12, por conven\u00e7\u00e3o, separa as rotas em diferentes arquivos baseados no seu prop\u00f3sito e estado:<\/p>\n\n\n\n

Arquivo de Rota<\/strong><\/td>Prop\u00f3sito<\/strong><\/td>Estado da Requisi\u00e7\u00e3o<\/strong><\/td><\/tr><\/thead>
routes\/web.php<\/code><\/strong><\/td>Interface do usu\u00e1rio e l\u00f3gica com sess\u00e3o<\/em> (stateful<\/em>).<\/td>Inclui middleware<\/em> como web<\/code> (sess\u00f5es, cookies, CSRF).<\/td><\/tr>
routes\/api.php<\/code><\/strong><\/td>API stateless<\/em> (sem estado) para consumo externo (JSON).<\/td>Geralmente usa middleware<\/em> como api<\/code> e autentica\u00e7\u00e3o via token<\/em> (ex: Sanctum).<\/td><\/tr>
routes\/console.php<\/code><\/strong><\/td>Define comandos do Artisan<\/strong> baseados em closures<\/em>.<\/td>N\u00e3o lida com requisi\u00e7\u00f5es HTTP.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
<\/div>\n\n\n\n

A. Rota que Retorna View<\/h3>\n\n\n\n

Ideal para p\u00e1ginas est\u00e1ticas ou de marketing<\/em>. Esta rota direciona imediatamente para um arquivo Blade<\/em> sem passar por um Controller<\/em> completo.<\/p>\n\n\n\n

PHP<\/p>\n\n\n\n

\/\/ routes\/web.php\nuse Illuminate\\Support\\Facades\\Route;\n\nRoute::view('\/sobre', 'pages.about')->name('about');\n\/\/ Mapeia a URL \/sobre para a view resources\/views\/pages\/about.blade.php\n<\/code><\/pre>\n\n\n\n
<\/div>\n\n\n\n
B. Rotas de Redirecionamento<\/h3>\n\n\n\n
Para mover o tr\u00e1fego de uma URL antiga para uma nova de forma permanente (c\u00f3digo 301) ou tempor\u00e1ria (c\u00f3digo 302).<\/p>\n\n\n\n
PHP<\/p>\n\n\n\n
\/\/ routes\/web.php\n\/\/ Redirecionamento permanente 301 (bom para SEO)\nRoute::redirect('\/antigo-link', '\/novo-link', 301);\n<\/code><\/pre>\n\n\n\n
<\/div>\n\n\n\n
2. \ud83c\udfa3 Par\u00e2metros de Rota e Inje\u00e7\u00e3o<\/h2>\n\n\n\n
Rotas din\u00e2micas capturam partes da URL (segmentos) para serem usadas como vari\u00e1veis na l\u00f3gica da aplica\u00e7\u00e3o.<\/p>\n\n\n\n
<\/div>\n\n\n\n
A. Par\u00e2metros Obrigat\u00f3rios<\/h3>\n\n\n\n
PHP<\/p>\n\n\n\n
\/\/ routes\/web.php\nRoute::get('\/produtos\/{id}', function (string $id) {\n    \/\/ $id ser\u00e1 o valor num\u00e9rico ou slug capturado na URL (ex: \/produtos\/15)\n    return \"Detalhes do Produto ID: \" . $id;\n});\n<\/code><\/pre>\n\n\n\n
<\/div>\n\n\n\n
B. Par\u00e2metros Opcionais<\/h3>\n\n\n\n
Definidos com ?<\/code> na rota e um valor padr\u00e3o na fun\u00e7\u00e3o ou m\u00e9todo do Controller<\/em>.<\/p>\n\n\n\n
PHP<\/p>\n\n\n\n
\/\/ routes\/web.php\nRoute::get('\/blog\/{categoria?}', function (string $categoria = 'geral') {\n    return \"Posts na categoria: \" . $categoria;\n});\n<\/code><\/pre>\n\n\n\n
<\/div>\n\n\n\n
3. \ud83c\udff7\ufe0f Nomea\u00e7\u00e3o e Gera\u00e7\u00e3o de URLs<\/h2>\n\n\n\n
Nomear rotas \u00e9 uma pr\u00e1tica essencial<\/strong> pois torna o c\u00f3digo desacoplado da estrutura da URL.<\/p>\n\n\n\n
<\/div>\n\n\n\n
A. Nomeando uma Rota<\/h3>\n\n\n\n
PHP<\/p>\n\n\n\n
\/\/ routes\/web.php\nRoute::get('\/usuario\/{slug}', [UserController::class, 'show'])->name('user.profile');\n<\/code><\/pre>\n\n\n\n
<\/div>\n\n\n\n
B. Gerando a URL<\/h3>\n\n\n\n
O m\u00e9todo auxiliar route()<\/code> gera a URL completa com base no nome e injeta os par\u00e2metros necess\u00e1rios.<\/p>\n\n\n\n
PHP<\/p>\n\n\n\n
\/\/ Em uma view Blade:\n\/\/ Gera a URL: http:\/\/app.test\/usuario\/alice-silva\n<a href=\"{{ route('user.profile', ['slug' => 'alice-silva']) }}\">Ver Perfil<\/a>\n<\/code><\/pre>\n\n\n\n
<\/div>\n\n\n\n
4. \ud83d\udce6 Agrupamento de Rotas: Clareza e Efici\u00eancia<\/h2>\n\n\n\n
O agrupamento permite aplicar atributos comuns (como Middleware<\/em>, Namespaces<\/em>, ou Prefixos<\/em>) a m\u00faltiplas rotas de uma s\u00f3 vez, aumentando a manutenibilidade.<\/p>\n\n\n\n
<\/div>\n\n\n\n
A. Agrupamento por Controlador (Laravel 12)<\/h3>\n\n\n\n
Esta \u00e9 a forma mais limpa de agrupar rotas que pertencem ao mesmo Controller<\/em>, eliminando a repeti\u00e7\u00e3o da sintaxe [Controller::class, 'method']<\/code>.<\/p>\n\n\n\n
PHP<\/p>\n\n\n\n
\/\/ routes\/web.php\nuse App\\Http\\Controllers\\SiteController;\n\nRoute::controller(SiteController::class)->group(function() {\n    Route::get('\/', 'index')->name('home');\n    Route::get('\/contato', 'contato')->name('contato');\n    Route::get('\/quem-somos', 'quemSomos')->name('about');\n});\n\/\/ Todas as rotas acima chamam m\u00e9todos dentro de SiteController.\n<\/code><\/pre>\n\n\n\n
<\/div>\n\n\n\n
B. Agrupamento por Middleware (Autentica\u00e7\u00e3o)<\/h3>\n\n\n\n
Para proteger uma se\u00e7\u00e3o da aplica\u00e7\u00e3o, aplique o Middleware<\/em> auth<\/code> a um grupo:<\/p>\n\n\n\n
PHP<\/p>\n\n\n\n
\/\/ routes\/web.php\nRoute::middleware('auth')->group(function() {\n    Route::get('\/dashboard', [AppController::class, 'dashboard'])->name('dashboard');\n    Route::get('\/settings', [AppController::class, 'settings'])->name('settings');\n});\n\/\/ Se o usu\u00e1rio n\u00e3o estiver logado, o middleware 'auth' o redirecionar\u00e1 para a tela de login.\n<\/code><\/pre>\n\n\n\n
<\/div>\n\n\n\n
5. \ud83d\ude80 Otimiza\u00e7\u00e3o em Produ\u00e7\u00e3o<\/h2>\n\n\n\n
Em ambientes de produ\u00e7\u00e3o, o Laravel pode compilar todas as rotas em um \u00fanico arquivo de cache<\/em>, melhorando drasticamente a performance de carregamento.<\/p>\n\n\n\n