{"id":1992,"date":"2024-11-19T09:01:48","date_gmt":"2024-11-19T12:01:48","guid":{"rendered":"https:\/\/thiagorossi.com.br\/blog\/?p=1992"},"modified":"2025-12-05T10:22:46","modified_gmt":"2025-12-05T13:22:46","slug":"requests-no-laravel","status":"publish","type":"post","link":"https:\/\/thiagorossi.com.br\/blog\/requests-no-laravel\/","title":{"rendered":"Requests no Laravel"},"content":{"rendered":"Tempo de leitura: <\/span> 4<\/span> minutos<\/span><\/span>\n

Requests no Laravel<\/strong>: Em qualquer aplica\u00e7\u00e3o web, a forma como lidamos com os dados recebidos dos clientes (Requisi\u00e7\u00f5es HTTP<\/strong>) \u00e9 crucial para a seguran\u00e7a e a l\u00f3gica de neg\u00f3cio. No Laravel 12<\/strong>, o objeto Illuminate\\Http\\Request<\/code><\/strong> encapsula todos os dados de entrada (formul\u00e1rio, URL, headers<\/em>, arquivos) e oferece uma API elegante e segura para acess\u00e1-los.<\/p>\n\n\n\n

Neste artigo, exploraremos a inje\u00e7\u00e3o do objeto Request<\/code>, os m\u00e9todos de acesso aos dados e a import\u00e2ncia do Form Request<\/strong> para a valida\u00e7\u00e3o.<\/p>\n\n\n\n

<\/div>\n\n\n\n

1. \ud83d\udc89 Inje\u00e7\u00e3o e Acesso B\u00e1sico aos Dados<\/h2>\n\n\n\n

O Laravel utiliza o Service Container<\/strong> para injetar automaticamente a inst\u00e2ncia de Request<\/code> em qualquer m\u00e9todo de Controller<\/em> ou Closure<\/em> de rota que a declare como tipo.<\/p>\n\n\n\n

<\/div>\n\n\n\n

Inje\u00e7\u00e3o no Controller<\/h3>\n\n\n\n

Basta tipar o primeiro argumento do m\u00e9todo com a classe Request<\/code>:<\/p>\n\n\n\n

PHP<\/p>\n\n\n\n

<?php\n\/\/ Exemplo em App\\Http\\Controllers\\PostController.php\n\nuse Illuminate\\Http\\Request;\n\nclass PostController extends Controller\n{\n    \/\/ O Laravel injeta a requisi\u00e7\u00e3o HTTP atual na vari\u00e1vel $request\n    public function store(Request $request)   \n    {\n        \/\/ Acessando campos de formul\u00e1rio\n        $title = $request->input('title');\n        \n        \/\/ Acessando via nota\u00e7\u00e3o de propriedade (conven\u00e7\u00e3o limpa)\n        $content = $request->content; \n\n        \/\/ ... l\u00f3gica de salvamento\n    }\n}\n<\/code><\/pre>\n\n\n\n
<\/div>\n\n\n\n
M\u00e9todos Chave para Acessar Dados<\/h3>\n\n\n\n
M\u00e9todo<\/strong><\/td>Fun\u00e7\u00e3o<\/strong><\/td>Exemplo<\/strong><\/td><\/tr><\/thead>
$request->all()<\/code><\/strong><\/td>Retorna todos os dados da requisi\u00e7\u00e3o (GET<\/code> e POST<\/code>) como um array.<\/td>['title' => 'Novo Post', 'content' => '...']<\/code><\/td><\/tr>
$request->only(...)<\/code><\/strong><\/td>Retorna apenas os campos listados (seguro para mass assignment<\/em>).<\/td>$request->only(['title', 'content'])<\/code><\/td><\/tr>
$request->except(...)<\/code><\/strong><\/td>Retorna todos os dados, exceto os campos listados.<\/td>$request->except(['_token', 'password_confirmation'])<\/code><\/td><\/tr>
$request->has('field')<\/code><\/strong><\/td>Verifica se um campo existe na requisi\u00e7\u00e3o.<\/td>if ($request->has('title'))<\/code><\/td><\/tr>
$request->filled('field')<\/code><\/strong><\/td>Verifica se um campo existe E n\u00e3o est\u00e1 vazio (n\u00e3o \u00e9 null<\/code>, false<\/code> ou \"\"<\/code>).<\/td>if ($request->filled('email'))<\/code><\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
<\/div>\n\n\n\n
2. \ud83d\udee1\ufe0f Valida\u00e7\u00e3o de Dados: O Ponto de Seguran\u00e7a<\/h2>\n\n\n\n
A valida\u00e7\u00e3o \u00e9 a etapa mais cr\u00edtica no processamento de uma requisi\u00e7\u00e3o. O Laravel oferece dois caminhos principais para validar dados, ambos retornando automaticamente o usu\u00e1rio com erros em caso de falha.<\/p>\n\n\n\n
<\/div>\n\n\n\n
A. Valida\u00e7\u00e3o Direta no Controller<\/h3>\n\n\n\n
Voc\u00ea pode usar o m\u00e9todo validate()<\/code> diretamente no objeto Request<\/code>. Se a valida\u00e7\u00e3o falhar, o Laravel interrompe<\/strong> a execu\u00e7\u00e3o e redireciona o usu\u00e1rio de volta com os erros e o Old Input<\/strong> (dados antigos).<\/p>\n\n\n\n
PHP<\/p>\n\n\n\n
public function store(Request $request)\n{\n    \/\/ Lan\u00e7ar\u00e1 um erro se as regras n\u00e3o forem atendidas\n    $validatedData = $request->validate([\n        'title' => 'required|min:5|max:255', \/\/ Requerido, min 5, max 255\n        'content' => 'required',\n        'email' => 'email|unique:users', \/\/ Deve ser email v\u00e1lido, \u00fanico na tabela users\n    ]);\n\n    \/\/ O c\u00f3digo s\u00f3 prossegue se a valida\u00e7\u00e3o for bem-sucedida\n    \/\/ ...\n}\n<\/code><\/pre>\n\n\n\n
<\/div>\n\n\n\n
B. Form Requests (A Melhor Pr\u00e1tica)<\/h3>\n\n\n\n
Para rotas mais complexas ou para manter o Controller<\/em> limpo, o Form Request<\/strong> \u00e9 a solu\u00e7\u00e3o padr\u00e3o do Laravel. Ele \u00e9 um objeto de valida\u00e7\u00e3o dedicado.<\/p>\n\n\n\n
<\/div>\n\n\n\n
1. Criando o Form Request<\/h4>\n\n\n\n
Bash<\/p>\n\n\n\n
php artisan make:request StorePostRequest\n# Cria a classe em app\/Http\/Requests\/StorePostRequest.php\n<\/code><\/pre>\n\n\n\n
<\/div>\n\n\n\n
2. Definindo Regras<\/h4>\n\n\n\n
No arquivo gerado, voc\u00ea define as regras e o m\u00e9todo authorize()<\/code>.<\/p>\n\n\n\n
PHP<\/p>\n\n\n\n
\/\/ app\/Http\/Requests\/StorePostRequest.php\nclass StorePostRequest extends FormRequest\n{\n    \/\/ L\u00f3gica de Autoriza\u00e7\u00e3o (Permiss\u00e3o de Acesso)\n    public function authorize(): bool\n    {\n        \/\/ Retorna true para permitir a requisi\u00e7\u00e3o se o usu\u00e1rio estiver logado\n        return auth()->check(); \n    }\n\n    \/\/ L\u00f3gica de Valida\u00e7\u00e3o\n    public function rules(): array\n    {\n        return [\n            'title' => 'required|min:5|max:255',\n            'content' => 'required',\n        ];\n    }\n}\n<\/code><\/pre>\n\n\n\n
<\/div>\n\n\n\n
3. Inje\u00e7\u00e3o no Controller<\/h4>\n\n\n\n
Ao inv\u00e9s de injetar a classe Request<\/code>, injete seu Form Request<\/code> customizado no m\u00e9todo do Controller<\/em>. O Laravel executar\u00e1 a valida\u00e7\u00e3o antes<\/strong> de chamar o m\u00e9todo.<\/p>\n\n\n\n
PHP<\/p>\n\n\n\n
\/\/ O Controller n\u00e3o precisa mais chamar $request->validate()\npublic function store(StorePostRequest $request) \n{\n    \/\/ Se chegou aqui, a requisi\u00e7\u00e3o \u00e9 v\u00e1lida e autorizada.\n    \/\/ ...\n}\n<\/code><\/pre>\n\n\n\n
<\/div>\n\n\n\n
3. \ud83d\uddbc\ufe0f Tratamento de Erros de Valida\u00e7\u00e3o e Old Input<\/em><\/h2>\n\n\n\n
Quando a valida\u00e7\u00e3o falha (seja via validate()<\/code> ou Form Request<\/code>), o Laravel garante uma experi\u00eancia suave para o usu\u00e1rio:<\/p>\n\n\n\n
<\/div>\n\n\n\n
A. Exibi\u00e7\u00e3o de Erros ($errors<\/code>)<\/h3>\n\n\n\n
O Laravel injeta automaticamente a vari\u00e1vel especial $errors<\/code> (que cont\u00e9m um Bag<\/em> de erros de valida\u00e7\u00e3o) em todas as Views<\/em>.<\/p>\n\n\n\n
HTML<\/p>\n\n\n\n
@if ($errors->any())\n    <div class=\"alert alert-danger\">\n        Opa! Algo deu errado nos seus dados:\n        <ul>\n            @foreach ($errors->all() as $error)\n                <li>{{ $error }}<\/li>\n            @endforeach\n        <\/ul>\n    <\/div>\n@endif\n<\/code><\/pre>\n\n\n\n
<\/div>\n\n\n\n
B. Manuten\u00e7\u00e3o de Dados Antigos (@old<\/code>)<\/h3>\n\n\n\n
O Input<\/em> anterior do formul\u00e1rio \u00e9 salvo na sess\u00e3o e pode ser recuperado para preencher os campos automaticamente, evitando que o usu\u00e1rio tenha que digitar tudo novamente.<\/p>\n\n\n\n
HTML<\/p>\n\n\n\n
<input type=\"text\" name=\"title\" value=\"{{ old('title') }}\" id=\"title\">\n<\/code><\/pre>\n\n\n\n
<\/div>\n\n\n\n
4. \ud83d\uddc4\ufe0f Acesso a Outros Dados da Requisi\u00e7\u00e3o<\/h2>\n\n\n\n
A classe Request<\/code> tamb\u00e9m fornece m\u00e9todos para acessar dados al\u00e9m dos campos de formul\u00e1rio:<\/p>\n\n\n\n