先生と生徒の会話形式で理解しよう

生徒

「Laravelでフォームに入力した内容が間違っているとき、どうやってエラーを表示するんですか？」

先生

「Laravelにはバリデーションという仕組みがあって、入力内容が正しいかどうかを自動でチェックしてくれます。さらに、エラーがあった場合にユーザーに分かりやすく伝えるための方法も用意されています。」

生徒

「具体的にはどんなコツがありますか？」

先生

「それでは、初心者でもすぐに使えるエラーハンドリングのコツを順番に見ていきましょう！」

1. バリデーションエラーとは？

バリデーションエラーとは、フォームに入力された内容がルールに合わなかったときに発生するエラーのことです。例えば、メールアドレスの形式が間違っていたり、必須項目が空だった場合にLaravelが自動でチェックします。

Laravelではrequest()->validate()やフォームリクエストを使って、簡単にバリデーションルールを定義できます。バリデーションに失敗すると、自動で前のページにリダイレクトされ、エラー情報がセッションに保存されます。

2. エラーメッセージの基本表示

バリデーションエラーを画面に表示する基本的な方法は、Bladeテンプレートで$errors変数を利用することです。


@if ($errors->any())
    <div class="alert alert-danger">
        <ul>
            @foreach ($errors->all() as $error)
                <li>{{ $error }}</li>
            @endforeach
        </ul>
    </div>
@endif

これで、フォームの入力がルールに違反した場合、ユーザーに分かりやすくエラーメッセージを一覧で表示できます。分かりやすく伝えることが重要です。

3. 個別フィールドのエラー表示

特定の入力項目だけにエラーを表示したい場合は、$errors->has('field_name')を使います。


<input type="text" name="email" value="{{ old('email') }}">
@if ($errors->has('email'))
    <div class="text-danger">{{ $errors->first('email') }}</div>
@endif

この方法で、入力欄ごとにエラーを表示でき、ユーザーはどこを修正すれば良いかすぐに分かります。

4. old()で入力内容を保持する

バリデーションエラーでリダイレクトされたときに、入力した内容が消えてしまうとユーザーにとって不便です。old()関数を使うと、前回入力した値をフォームに自動で表示できます。


<input type="text" name="name" value="{{ old('name') }}">

これにより、ユーザーは入力をやり直す手間を省けます。

5. カスタムエラーメッセージの設定

Laravelでは、標準のメッセージでは分かりにくい場合、独自のエラーメッセージを設定できます。フォームリクエストのmessages()メソッドで定義します。


public function messages()
{
    return [
        'email.required' => 'メールアドレスは必須です。',
        'email.email' => '正しいメールアドレスを入力してください。',
        'password.min' => 'パスワードは6文字以上必要です。',
    ];
}

カスタムメッセージを使うことで、ユーザーに優しいエラーメッセージを表示できます。