Rotas no Laravel

Tempo de leitura: 4 minutos

Rotas no Laravel: As Rotas são o mapa de uma aplicação Laravel. Elas definem os endpoints da sua aplicação, capturam as requisições HTTP (GET, POST, etc.) e as direcionam para a lógica apropriada, seja um Controller, um Closure ou uma View.

Neste artigo, vamos explorar como definir e organizar as rotas no Laravel 12, utilizando as ferramentas de agrupamento e nomeação para máxima eficiência.

1. 📄 Arquivos Padrão e Tipos Básicos de Rotas

O Laravel 12, por convenção, separa as rotas em diferentes arquivos baseados no seu propósito e estado:

Arquivo de Rota	Propósito	Estado da Requisição
`routes/web.php`	Interface do usuário e lógica com sessão (stateful).	Inclui middleware como `web` (sessões, cookies, CSRF).
`routes/api.php`	API stateless (sem estado) para consumo externo (JSON).	Geralmente usa middleware como `api` e autenticação via token (ex: Sanctum).
`routes/console.php`	Define comandos do Artisan baseados em closures.	Não lida com requisições HTTP.

A. Rota que Retorna View

Ideal para páginas estáticas ou de marketing. Esta rota direciona imediatamente para um arquivo Blade sem passar por um Controller completo.

PHP

// routes/web.php
use Illuminate\Support\Facades\Route;

Route::view('/sobre', 'pages.about')->name('about');
// Mapeia a URL /sobre para a view resources/views/pages/about.blade.php

B. Rotas de Redirecionamento

Para mover o tráfego de uma URL antiga para uma nova de forma permanente (código 301) ou temporária (código 302).

PHP

// routes/web.php
// Redirecionamento permanente 301 (bom para SEO)
Route::redirect('/antigo-link', '/novo-link', 301);

2. 🎣 Parâmetros de Rota e Injeção

Rotas dinâmicas capturam partes da URL (segmentos) para serem usadas como variáveis na lógica da aplicação.

A. Parâmetros Obrigatórios

PHP

// routes/web.php
Route::get('/produtos/{id}', function (string $id) {
    // $id será o valor numérico ou slug capturado na URL (ex: /produtos/15)
    return "Detalhes do Produto ID: " . $id;
});

B. Parâmetros Opcionais

Definidos com ? na rota e um valor padrão na função ou método do Controller.

PHP

// routes/web.php
Route::get('/blog/{categoria?}', function (string $categoria = 'geral') {
    return "Posts na categoria: " . $categoria;
});

3. 🏷️ Nomeação e Geração de URLs

Nomear rotas é uma prática essencial pois torna o código desacoplado da estrutura da URL.

A. Nomeando uma Rota

PHP

// routes/web.php
Route::get('/usuario/{slug}', [UserController::class, 'show'])->name('user.profile');

B. Gerando a URL

O método auxiliar route() gera a URL completa com base no nome e injeta os parâmetros necessários.

PHP

// Em uma view Blade:
// Gera a URL: http://app.test/usuario/alice-silva
<a href="{{ route('user.profile', ['slug' => 'alice-silva']) }}">Ver Perfil</a>

4. 📦 Agrupamento de Rotas: Clareza e Eficiência

O agrupamento permite aplicar atributos comuns (como Middleware, Namespaces, ou Prefixos) a múltiplas rotas de uma só vez, aumentando a manutenibilidade.

A. Agrupamento por Controlador (Laravel 12)

Esta é a forma mais limpa de agrupar rotas que pertencem ao mesmo Controller, eliminando a repetição da sintaxe [Controller::class, 'method'].

PHP

// routes/web.php
use App\Http\Controllers\SiteController;

Route::controller(SiteController::class)->group(function() {
    Route::get('/', 'index')->name('home');
    Route::get('/contato', 'contato')->name('contato');
    Route::get('/quem-somos', 'quemSomos')->name('about');
});
// Todas as rotas acima chamam métodos dentro de SiteController.

B. Agrupamento por Middleware (Autenticação)

Para proteger uma seção da aplicação, aplique o Middleware auth a um grupo:

PHP

// routes/web.php
Route::middleware('auth')->group(function() {
    Route::get('/dashboard', [AppController::class, 'dashboard'])->name('dashboard');
    Route::get('/settings', [AppController::class, 'settings'])->name('settings');
});
// Se o usuário não estiver logado, o middleware 'auth' o redirecionará para a tela de login.

5. 🚀 Otimização em Produção

Em ambientes de produção, o Laravel pode compilar todas as rotas em um único arquivo de cache, melhorando drasticamente a performance de carregamento.

Cachear Rotas: Gere o arquivo de cache (ideal para o processo de deploy):
Bash
php artisan route:cache
Limpar Cache: Se você fizer alterações em seus arquivos de rotas, deve limpar o cache localmente antes de ver as mudanças:
Bash
php artisan route:clear

✅ Conclusão Rotas no Laravel

Rotas no Laravel: Rotas no Laravel 12 são mais do que apenas URLs; elas são a definição estrutural da sua aplicação. Dominar o uso de rotas nomeadas, parâmetros e, principalmente, o agrupamento por Controller e Middleware, garante que seu código seja limpo, fácil de manter e que sua aplicação seja performática e segura. Utilize o comando php artisan route:list para verificar todas as rotas ativas em seu projeto.

Mas antes de dominar o Laravel, se for o seu caso, toda jornada tem um início. Vamos entender quais são os conhecimentos básicos necessários para aproveitar ao máximo este poderoso framework. Para iniciar seus estudos no Laravel, você precisará dominar as seguintes tecnologias: