Rotas e middlewares na IDE

O catálogo extrai método, caminho, handler e proteção. Uma rota somente é considerada ativa quando aparece no catálogo do runtime saudável.

Criar uma rota

1. Crie ou abra o controller.
2. Implemente o método e sua resposta.
3. Abra Routes/web.php.
4. Importe a classe pelo namespace público.
5. Registre método, URI, handler e middleware.
6. Salve, analise e confira o catálogo.
7. Teste a URL copiada pela IDE.

Middleware na assinatura

$router->get(
    '/api/status',
    [StatusController::class, 'show'],
    $auth,
);

Um argumento ausente ou vírgula incorreta é erro de sintaxe e deve ser destacado antes da ativação.

Middleware próprio

<?php
namespace MeuProjeto\Middlewares;

final class ExigirCabecalho
{
    public function handle($request, callable $next)
    {
        if ($request->header('X-Cliente') === null) {
            return ['status' => 'error', 'message' => 'Cabeçalho obrigatório.'];
        }
        return $next($request);
    }
}

Teste ausência, valor inválido e caminho autorizado. Para upload, valide tipo e tamanho; para webhook, assinatura e idempotência; para rotas públicas, limite e entrada.

Diagnóstico

Se uma rota não aparecer, confira sintaxe, namespace, import, arquivo carregado e logs da release. Health saudável não garante que uma URI específica foi registrada.