Como configurar o redirecionamento de usuários não autenticados no Laravel

Uma abordagem moderna e simplificada para controlar o fluxo de autenticação

Como configurar o redirecionamento de usuários não autenticados no Laravel
Gunnar Correa
Gunnar Correa
19/09/2026 3 minutos

O Laravel 12 trouxe mudanças significativas na forma como configuramos o redirecionamento de usuários não autenticados (guests). Diferentemente das versões anteriores, onde essa configuração era feita através de middlewares ou service providers, agora temos uma abordagem mais centralizada e intuitiva.

Continue com a gente para entender o quão fácil e tratar esse redirecionamento!

A nova metodologia

A partir do Laravel 11, e mantida no Laravel 12, a configuração do redirecionamento de guests foi simplificada e centralizada no arquivo bootstrap/app.php. Esta mudança representa uma evolução natural do framework, buscando maior clareza e organização na configuração da aplicação.

Implementação prática

Para alterar o caminho de redirecionamento de usuários não autenticados, você deve acessar o arquivo bootstrap/app.php e utilizar o método redirectGuestsTo dentro do callback withMiddleware:

php
return Application::configure(basePath: dirname(__DIR__))

    ->withMiddleware(function (Middleware $middleware) {
        $middleware->redirectGuestsTo('/auth/login');
    })
    ->withExceptions(function (Exceptions $exceptions) {

    })->create();

Funcionamento do sistema

Quando um usuário não autenticado tenta acessar uma área protegida pelo middleware auth, o Laravel automaticamente o redirecionará para a URL especificada no método redirectGuestsTo. Esta funcionalidade é essencial para manter a segurança da aplicação e proporcionar uma experiência de usuário fluida.

É importante notar que, devido ao ciclo de vida do Laravel, nem todos os helpers e Facades estão disponíveis neste momento da configuração. Por exemplo, não é possível utilizar o helper route() para referenciar uma rota nomeada, pois estes recursos ainda não foram carregados pelo framework.

Esta limitação significa que você deve especificar URLs absolutas ou caminhos relativos, em vez de utilizar nomes de rotas. Embora isso possa parecer uma desvantagem inicial, na prática garante maior performance e previsibilidade no processo de inicialização da aplicação.

Vantagens da nova abordagem

A centralização desta configuração no bootstrap/app.php oferece várias vantagens:

  • Clareza de configuração: Todas as configurações críticas da aplicação ficam em um local centralizado, facilitando a manutenção e o entendimento do código.
  • Performance otimizada: A configuração é definida durante a inicialização da aplicação, evitando processamento desnecessário em cada requisição.
  • Compatibilidade futura: Esta abordagem está alinhada com a direção arquitetural do Laravel, garantindo compatibilidade com futuras versões.

Considerações de segurança

Ao configurar o redirecionamento de guests, certifique-se de que a URL de destino seja segura e não exponha informações sensíveis. Evite redirecionamentos para URLs externas sem validação adequada, pois isso pode criar vulnerabilidades de segurança.

A nova metodologia para configurar redirecionamento de guests no Laravel 12 representa uma evolução natural do framework, priorizando simplicidade e performance. Embora existam algumas limitações quanto ao uso de helpers durante a configuração, os benefícios em termos de organização e clareza do código compensam amplamente essas restrições.

Esta abordagem centralizada não apenas melhora a experiência do desenvolvedor, mas também contribui para um código mais limpo e maintível, características que sempre foram pilares fundamentais do ecossistema Laravel.

Nossos cursos

Nossos cursos

Leia também

Gunnar Correa
Gunnar Correa

Deixe um comentário

Para deixar um comentário, é necessário estar autenticado. Crie uma conta gratuita na SatellaSoft.

Entrar ou Registrar-se