Kaip dirbti su užklausomis ir atsakymais?

Question

Accepted Answer

Laravel apgaubia HTTP patogiomis **Request** ir **Response** objektų klasėmis. `Request` objektas suteikia saugų, švarų prieigą prie gaunamos informacijos (įvestis, failai, antraštės); Laravel atsakymo pagalbininkai palengvina peržiūrų, JSON, nukreipimų ir dar daugiau grąžinimą.

## Užklausos duomenų pasiekimas

```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
}
```

Objektas `Request` (automatiškai injektuojamas į valdiklio metodus) suteikia švarų, saugų prieigą prie visų gaunamos informacijos — daug geriau nei žalie `$_GET`/`$_POST` superglobaliai, su pagalbiniais metodais dažniems poreikiams.

## Atsakymų grąžinimas

```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
```

Laravel atsakymo pagalbininkai elegantiškai tvarko dažnus atvejus: peržiūrų atvaizdavimas, JSON grąžinimas (masyvai ir Eloquent modeliai automatiškai serializuojami į JSON), nukreipimai (su fleš pranešimais) ir atsisiuntimai. Grąžinus modelį arba masyvą iš valdiklio, automatiškai gaunamas JSON atsakymas.

## Atsakymų prilaginkimas

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

## Kodėl tai svarbu

Darba su užklausomis ir atsakymais yra pagrindinis kiekvienos Laravel aplikacijos dalis — gaunamos informacijos tvarkymas ir išvesties grąžinimas yra užklausos apdorojimo šerdis, todėl šių objektų suvokimas yra naudotina kasdienio naudojimo žinios.

**Request objektas** suteikia švarų, saugų, patogų prieigą prie visų gaunamos informacijos (įvesties, užklausos parametrų, failų, antraščių, autentifikuoto vartotojo) per naudingus metodus — didelė pergalė prieš žalius PHP superglobalius (`$_GET`/`$_POST`), tiek ergonomikos požiūriu, tiek skatinant saugų tvarkymuką.

Laravel **atsakymo pagalbininkai** pavers visų dažniausių atsakymo tipų grąžinimą elegantišku: Blade peržiūrų atvaizdavimas, JSON grąžinimas (su masyvais ir Eloquent modeliais automatiškai serializuojamais — patogiai API), nukreipimai (su fleš pranešimais vartotojo grįžtamajam ryšiui), failų atsisiuntimai ir pasirinktini atsakymai su specifiniais būsenos kodais ir antraštėmis.

Supratimas, kaip pasiekti užklausos duomenis per Request objekto metodus ir kaip grąžinti tinkamą atsakymo tipą (peržiūros žiniatinklio puslapiams, JSON API, nukreipimai po veiksmų), yra pagrindinė, neatsižvelgtina žinios bet kurio Laravel galinės dalies kūrimui, kadangi kiekvienas valdiklio metodas gauna užklausą ir grąžina atsakymą.

Laravel užklausos/atsakymo abstrakcijų patogumas ir saugumas yra dalis to, kas daro sistemą produktyvia, ir bėgimo žinios su jomis yra pagrindinis efektyvaus Laravel kūrybos pagrindas.