Form Requestクラスとは何ですか?

Question

Accepted Answer

**Form Request** クラスは、特定のリクエストの**検証（および認可）ロジックをカプセル化する**カスタムリクエストクラスです。検証ルールをコントローラーから専用で再利用可能なクラスに移動します — コントローラーをシンで検証を整理された状態に保ちます。

## Form Requestの作成と使用

```php
<?php
// php artisan make:request StoreUserRequest
class StoreUserRequest extends FormRequest {
    public function authorize(): bool {
        return $this->user()->can('create', User::class);   // AUTHORIZATION check
    }

public function rules(): array {
        return [                                              // VALIDATION rules
            'name' => 'required|string|max:100',
            'email' => 'required|email|unique:users',
            'password' => 'required|min:8|confirmed',
        ];
    }

public function messages(): array {
        return ['email.unique' => 'That email is already taken.'];   // custom messages
    }
}
```

```php
// type-hint the Form Request in the controller — validation runs AUTOMATICALLY
public function store(StoreUserRequest $request) {
    // if we reach here, validation AND authorization already PASSED
    User::create($request->validated());   // get the validated data
}
```

コントローラーメソッドで Form Request をタイプヒントすると、Laravel は **メソッドが実行される前に自動的に認可と検証を実行します** — どちらかが失敗すると、リクエストは拒否され（認可は403、検証は422/リダイレクト）、メソッドは実行されません。つまり、メソッド内では、データが有効で、アクションが認可されていることを確認できます。

## 利点

```text
✓ Thin controllers — validation/authorization logic lives in the Form Request, not the controller
✓ Reusable — use the same request class across multiple endpoints
✓ Organized — rules, messages, and authorization for a request are in one place
✓ Combines validation AND authorization — both checked automatically before the controller
✓ Access prepared/validated data cleanly via $request->validated()
```

## なぜ重要なのか

Form Request クラスは、検証と認可をクリーンに整理するための重要な Laravel ベストプラクティスです — 自明でない検証にはお勧めのアプローチであるため、理解することは保守可能な Laravel アプリケーションを書くために価値があります。

それらの主な利点は、**コントローラーをシンに保つ**ことです。検証ルールと認可ロジックを専用クラスに移動することで（Laravel がコントローラーメソッドの前に自動的に実行）、コントローラーはコア ロジックに焦点を当てたままで、実行時にデータが既に検証され、アクションが認可されていることを確認できます。

この分離により、コードはより**整理された**（すべてのルール、カスタムメッセージ、リクエストの認可が 1 つの凝集された場所にある）、**再利用可能な**（同じ Form Request を複数のエンドポイント全体で使用できる）、よりクリーンになります。

1 つのクラスでの**検証と認可**の自動組み合わせ — コントローラー実行前に両方がチェックされ、無効または無権限のリクエストを自動的に拒否 — はエレガントで、ボイラープレートを削減します。

Form Request がどのように自動的に実行されるかを理解し、コントローラーから検証/認可を抽出することの利点は、成熟した Laravel プラクティスを反映しており、検証と認可は遍在する懸念事項であり、Form Request は重要でない場合を除き、それらを処理するための Laravel のクリーンで慣用的な方法であるため、よく構造化されたアプリケーションを構築するために重要です — プロフェッショナルで保守可能な Laravel コードの特徴です。