Como você trabalha com requisições e respostas?

Question

Accepted Answer

Laravel envolve HTTP em objetos **Request** e **Response** convenientes. O objeto `Request` fornece acesso seguro e limpo aos dados de entrada (input, arquivos, headers); os helpers de resposta do Laravel tornam o retorno de views, JSON, redirecionamentos e muito mais direto.

## Acessando dados de requisição

```php
public function store(Request $request) {
    $request->input('name');             // a specific input field
    $request->name;                       // shorthand access
    $request->only(['name', 'email']);    // a subset
    $request->all();                      // all input
    $request->query('sort');              // a query string param (?sort=)
    $request->has('email');               // check presence
    $request->input('page', 1);           // with a default

$request->file('avatar');             // an uploaded file
    $request->header('Authorization');
    $request->user();                     // the authenticated user
    $request->ip(); $request->method();   // request metadata
}
```

O objeto `Request` (injetado automaticamente nos métodos de controller) fornece acesso limpo e seguro a todos os dados de entrada — muito melhor do que os superglobais brutos `$_GET`/`$_POST`, com métodos auxiliares para necessidades comuns.

## Retornando respostas

```php
return view('users.index', ['users' => $users]);   // render a Blade view
return response()->json($data, 200);                // JSON (auto for arrays/models too)
return $user;                                       // a model → auto-serialized to JSON
return redirect('/home');                            // redirect
return redirect()->route('profile')->with('msg', 'Saved!');   // redirect + flash message
return back();                                       // redirect to the previous page
return response()->download($path);                  // file download
```

Os helpers de resposta do Laravel lidam com os casos comuns elegantemente: renderizando views, retornando JSON (arrays e modelos Eloquent são auto-serializados para JSON), redirecionamentos (com mensagens flash) e downloads. Retornar um modelo ou array de um controller produz automaticamente uma resposta JSON.

## Personalizando respostas

```php
return response()->json(['error' => 'Not found'], 404)
    ->header('X-Custom', 'value');                   // custom status + headers
return response('Hello', 200)->header('Content-Type', 'text/plain');
```

## Por que isso importa

Trabalhar com requisições e respostas é fundamental para toda aplicação Laravel — manipular dados de entrada e retornar output é o núcleo do processamento de requisições, então entender esses objetos é conhecimento essencial do dia a dia.

O objeto **Request** fornece acesso limpo, seguro e conveniente a todos os dados de entrada (input, parâmetros de query, arquivos, headers, o usuário autenticado) através de métodos úteis — uma melhoria significativa em relação aos superglobais brutos do PHP (`$_GET`/`$_POST`), tanto em ergonomia quanto em incentivar manipulação segura.

Os **helpers de resposta** do Laravel tornam elegante o retorno de todos os tipos de resposta comuns: renderizando views Blade, retornando JSON (com arrays e modelos Eloquent automaticamente serializados — conveniente para APIs), redirecionamentos (com mensagens flash para feedback do usuário), downloads de arquivos e respostas personalizadas com status codes e headers específicos.

Entender como acessar dados de requisição através dos métodos do objeto Request e como retornar o tipo de resposta apropriado (views para páginas web, JSON para APIs, redirecionamentos após ações) é conhecimento essencial e obrigatório para construir qualquer endpoint do Laravel, já que cada método de controller recebe uma requisição e retorna uma resposta.

A conveniência e segurança das abstrações de requisição/resposta do Laravel são parte do que torna o framework produtivo, e fluência com elas é fundamental para desenvolvimento efetivo do Laravel.