リクエストとレスポンスはどのように処理しますか?

Question

Accepted Answer

Laravel は HTTP を便利な **Request** および **Response** オブジェクトでラップしています。`Request` オブジェクトは受信データ (入力、ファイル、ヘッダ) への安全でクリーンなアクセスを提供し、Laravel のレスポンスヘルパーはビュー、JSON、リダイレクト、その他の返却を簡単にします。

## リクエストデータへのアクセス

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

`Request` オブジェクト (コントローラメソッドに自動注入される) は、すべての受信データへのクリーンで安全なアクセスを提供します。生の `$_GET`/`$_POST` スーパーグローバルよりはるかに優れており、一般的なニーズのためのヘルパーメソッドを備えています。

## レスポンスの返却

```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 のレスポンスヘルパーは一般的なケースを優雅に処理します。ビューのレンダリング、JSON の返却 (配列と Eloquent モデルは自動的に JSON にシリアライズされます)、リダイレクト (フラッシュメッセージ付き)、およびダウンロードです。コントローラからモデルまたは配列を返すと、自動的に JSON レスポンスが生成されます。

## レスポンスのカスタマイズ

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

## なぜ重要なのか

リクエストとレスポンスの処理は、すべての Laravel アプリケーションの基本です。受信データの処理と出力の返却はリクエスト処理のコアであるため、これらのオブジェクトを理解することは日々の必須知識です。

**Request オブジェクト**は、すべての受信データ (入力、クエリパラメータ、ファイル、ヘッダ、認証されたユーザ) への、クリーンで安全、便利なアクセスを有用なメソッドを通じて提供します。これは生の PHP スーパーグローバル (`$_GET`/`$_POST`) と比べて、人間工学的にも安全な処理を促す点でも大きな改善です。

Laravel の**レスポンスヘルパー**は、すべての一般的なレスポンスタイプの返却を優雅にします。Blade ビューのレンダリング、JSON の返却 (配列と Eloquent モデルは自動的にシリアライズされる — API に便利)、リダイレクト (ユーザへのフィードバックのためのフラッシュメッセージ付き)、ファイルダウンロード、および特定のステータスコードとヘッダを持つカスタムレスポンスです。

Request オブジェクトのメソッドを通じてリクエストデータにアクセスする方法と、適切なレスポンスタイプ (Web ページ用のビュー、API 用の JSON、アクション後のリダイレクト) を返す方法を理解することは、すべての Laravel エンドポイント構築の核となる、必須知識です。すべてのコントローラメソッドはリクエストを受け取り、レスポンスを返すからです。

Laravel のリクエスト/レスポンス抽象化の利便性と安全性は、フレームワークを生産的にしている一部であり、これらに精通していることは効果的な Laravel 開発の基礎です。