Laravelのバリデーション活用まとめ！実践的な設計パターン

1. フォームリクエストによるバリデーション（Form Request）

1. フォームリクエストによるバリデーション（Form Request）

Laravelで最も推奨される「フォームリクエスト」は、バリデーションロジックをコントローラから切り離し、専用のクラスに記述する方法です。これにより、プログラムの見た目がスッキリするだけでなく、同じ入力チェックを他の画面でも使い回せる「再利用性」が格段に向上します。

まず、ターミナル（コマンド入力画面）で以下のコマンドを実行して、専用のファイルを作成します。例えば、会員登録用ならCreateUserRequestという名前にします。

php artisan make:request CreateUserRequest

作成されたファイルのrulesメソッドの中に、チェックしたい項目とルールを記述します。プログラミングが初めての方でも、「どの項目に」「どんな制限をかけるか」が直感的にわかります。

public function rules()
{
    return [
        // 名前：必須入力、文字形式、最大50文字まで
        'name' => 'required|string|max:50',
        // メール：必須入力、正しいメール形式、usersテーブルで重複不可
        'email' => 'required|email|unique:users,email',
        // パスワード：必須入力、最低6文字以上、確認用フィールドと一致
        'password' => 'required|min:6|confirmed',
    ];
}

このサンプルにあるconfirmedというルールは非常に便利です。passwordという項目に対してこれを使うと、自動的にpassword_confirmationという名前の入力欄と中身が一致しているかをチェックしてくれます。これにより、初心者が間違いやすい「パスワードの打ち間違い確認」の実装も、たった1行で完結します。

実際のコントローラ側では、このクラスを型ヒントとして指定するだけで、データが届く前に自動でバリデーションが実行されます。もし入力にエラーがあれば、Laravelが自動的に元の入力画面へ戻してくれるため、エラー処理のコードを細かく書く必要もありません。

2. Validatorファサードの活用

2. Validatorファサードの活用

コントローラ内で簡単にバリデーションを行いたい場合は、Validator::make()を使います。条件に応じたルールの変更や、カスタムメッセージの設定も簡単です。

$validator = Validator::make($request->all(), [
    'email' => 'required|email',
    'age' => 'required|integer|min:18',
], [
    'age.min' => '18歳以上でなければ登録できません。',
]);

if ($validator->fails()) {
    return redirect()->back()
                     ->withErrors($validator)
                     ->withInput();
}

この方法は、フォームの種類が少ない場合や条件付きバリデーションを組み込みたいときに便利です。

3. カスタムバリデーションルール

3. カスタムバリデーションルール

Laravelでは、独自のルールを作成して複雑な条件をチェックできます。Ruleクラスやクロージャを使って自由に条件を設定できます。

use Illuminate\Validation\Rule;

$rules = [
    'username' => [
        'required',
        'string',
        Rule::unique('users')->ignore($user->id),
    ],
];

これにより、更新時にも既存ユーザー名との重複を防ぐことができます。

4. 条件付きバリデーションパターン

4. 条件付きバリデーションパターン

特定の条件でルールを適用したい場合は、sometimesやクロージャを活用します。

$rules = [
    'nickname' => 'sometimes|required|string|max:30',
];

$validator = Validator::make($data, $rules);

値が存在する場合のみチェックすることで、柔軟なバリデーション設計が可能です。

5. エラーメッセージ管理の工夫

5. エラーメッセージ管理の工夫

エラーメッセージは、ユーザーに分かりやすく伝えることが重要です。カスタムメッセージを設定したり、翻訳ファイルを利用して多言語対応も可能です。

$messages = [
    'email.required' => 'メールアドレスは必須です。',
    'email.email' => '正しいメールアドレスを入力してください。',
];

$validator = Validator::make($data, $rules, $messages);

これにより、ユーザーが入力を修正しやすくなり、フォームの利便性が向上します。

6. 実践的な設計パターンのまとめ

6. 実践的な設計パターンのまとめ

• フォームリクエストでバリデーションルールをまとめ、再利用性を高める。
• Validatorファサードを使い、条件付きバリデーションや簡単なルールチェックを行う。
• カスタムルールやクロージャで複雑な条件に対応する。
• エラーメッセージをカスタマイズし、ユーザーにわかりやすく伝える。
• 条件付きルールを活用して、入力状況に応じた柔軟なチェックを行う。

これらのパターンを組み合わせることで、保守性が高くユーザーフレンドリーなフォームバリデーションを設計することができます。