Controllers

Resolve e renderiza a view com as variáveis de $data. false ou string vazia desliga o layout; null usa $this->defaultLayout (por padrão, string vazia/sem layout; a subclasse pode sobrescrever a propriedade e a aplicação pode definir DEFAULT_LAYOUT). Tokens CSRF compatíveis são injetados no HTML. Use para resposta HTML de uma action.

$this->view('users.show', ['user' => $user], 'main');

A view precisa existir sob resources/views; valores interpolados continuam exigindo escaping contextual.

Atalho para renderizar sem layout. Retorno void; a saída vai diretamente ao corpo HTTP.

$this->viewOnly('emails.preview', ['message' => $message]);

redirect() envia um destino local seguro ou permitido e termina a requisição; back() usa o Referer validado e cai no destino padrão se ele for ausente/inseguro. Caminhos relativos sem barra inicial, como dashboard, não são aceitos como rota e podem cair em APP_URL; use /dashboard quando a intenção for esse caminho.

$this->redirect('/dashboard');
$this->back();

Use depois de uma operação Web; não é um mecanismo de resposta JSON.

Grava a mensagem na sessão pela chave $type e redireciona. Os argumentos são destino, chave (por exemplo, success/error) e texto.

$this->redirectWith('/users', 'success', 'Usuário criado.');

A view seguinte deve consumir o flash; não grave segredos ou tokens na mensagem.

Define tipo JSON, serializa o payload e encerra. A codificação inválida resulta em erro 500.

$this->json(['id' => $id], 201);

Emite success=true, message e os campos de $data. Como usa array_merge, chaves coincidentes em $data podem substituir os valores padrão; evite colisões.

$this->jsonSuccess('Criado', ['user' => $user], 201);

Emite success=false, mensagem e campos extras com o status HTTP fornecido.

$this->jsonError('Entrada inválida', 422, ['errors' => $errors]);

Não troque a ordem: o segundo argumento é o status, o terceiro é o array extra.

Armazena uma mensagem de sessão para leitura posterior. O getter de flash remove a chave quando lida; mensagens nunca consumidas não devem ser tratadas como expiração automática.

$this->flash('success', 'Alterações salvas.');

Consultam a identidade de sessão atual: autenticação, usuário carregado e identificadores/role. userId() usa zero quando não há usuário; userRole() usa o fallback da implementação. São getters, não guards: proteja rotas com middleware/guards e verifique auth() antes de confiar nos dados.

if (!$this->auth()) {
    $this->redirect('/auth/login');
}
$userId = $this->userId();

Continua quando o método/tipo solicitado corresponde ao da requisição; aceita os tipos implementados ajax, json, get, post, put, patch e delete. Caso contrário, responde em JSON com a mensagem/status informados. Um tipo desconhecido lança InvalidArgumentException e pode virar 500 no dispatch.

$this->checkMethod('post', 'Envie um formulário POST.', 405);

Valida os dados e devolve o próprio array de entrada se válido; não filtra para apenas campos validados. Em falha, grava erros e todo o input como old input e redireciona. Não passe senhas, tokens ou arquivos se não quiser persistir esses valores na sessão; prefira FormRequest com allowlist de campos a repassar.

$data = $this->validate($this->request->all(), [
    'email' => 'required|email',
], '/users/create');

Recebe uma instância FormRequest pronta e retorna validated() no sucesso. Na falha, grava o primeiro erro e redireciona; null repassa todo input, um array limita os campos e [] não repassa nenhum. Para API, use o caminho JSON do ApiController/FormRequest em vez do redirect Web.

$form = new \App\Http\Requests\Auth\LoginRequest();
$data = $this->validateRequest($form, '/auth/login', ['email']);