Como configurar rotas que funcionam apenas em ambiente de desenvolvimento no Laravel?

No Laravel 4, era possível definir rotas que só funcionavam em ambiente local. Essas rotas poderiam ser colocadas no arquivo local.php.

Eu costumava usar muitos essas rotas para poder logar com um usuário de um nível qualquer, ou exibir uma informação de depuração da aplicação. Mas notei que, no Laravel 5, não existe um arquivo com uma configuração separada apenas para rotas locais.

Mesmo assim, é possível configurar um arquivo de rota personalizado para o ambiente local.

Implementação

Para implementar as rotas condicionadas ao ambiente no Laravel 5, podemos fazer pequenos ajustes no arquivo app/Providers/RouteServiceProvider.php.

Primeiramente, você deve criar o arquivo desejado dentro da pasta routes. Por exemplo, vamos criar o arquivo routes/web.local.php. Nesse arquivo, colocaremos as rotas que só vão funcionar quando a aplicação estiver configurado para ambiente local.

Para verificar o ambiente configurado, basta usar o comando php artisan env.

Em seguida, crie um método dentro da classe RouteServiceProvider para incluir a rota que criamos no passo anterior.

Exemplo:

protected function mapLocalWebRoutes()
{
    if (! app()->isLocal()) return;
Route::middleware('web')
      ->namespace($this->namespace)
      ->group(base_path('routes/web.local.php'));

}

No meu caso, estou usando a versão 5.4 do Laravel para configurar isso. Nessa versão, o RouteServiceProvider tem um método chamado map, que tem a seguinte estrutura:

public function map()
{
    $this->mapApiRoutes();
$this->mapWebRoutes();

}

Você pode incluir a chamada de mapLocalWebRoutes dentro do método map.

Assim:

public function map()
{
    $this->mapApiRoutes();
$this->mapWebRoutes();

// inclusão de rotas locais
$this->mapLocalWebRoutes();

}

Após fazer isso, está pronta a sua configuração. Você já pode incluir as rotas que desejar, para realizar testes e verificação de dados que não podem estar disponíveis em produção.

O truque acima foi usar a chamada de app()->isLocal(). Esse método retorna true quando o valor de php artisan env é equivalente a local.

Caso sua aplicação em desenvolvimento não esteja retornando esse valor, verifique se seu arquivo .env possui o valor APP_ENV definido como local.