Laravelでバリデーションを設定する方法（基本ルール編）

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

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

バリデーションとは、フォームに入力された値が正しい形式かどうかを自動でチェックする仕組みのことです。例えば「名前は空欄ではないか？」「メールアドレスは本当にメール形式か？」といった、ユーザーの入力ミスを事前に防ぐための大切な工程になります。

もしバリデーションが無いと、誤ったデータがそのまま保存されてしまい、後で大きな不具合につながることもあります。Laravelではこの入力チェックを簡単に設定でき、初心者でもすぐに使いこなせる点が魅力です。

例：名前が空欄
→ 「名前は必須です」というエラーを表示

例：メール形式が間違い
→ 正しいメールアドレスを入力するよう促す

2. コントローラーで簡単チェック

2. コントローラーで簡単チェック

フォームに入力された値を確実にチェックしたいとき、Laravelではコントローラー内でvalidate()メソッドを使うだけで簡単にバリデーションを実行できます。特別な処理を書かなくても、必要なルールを配列で指定するだけで自動で検証してくれるため、初心者でも扱いやすいのが魅力です。

次の例では、名前・メールアドレス・パスワードの3つを基本的なルールでチェックしています。

public function store(Request $request)
{
    $validated = $request->validate([
        'name'     => 'required|string|max:255',
        'email'    => 'required|email|unique:users',
        'password' => 'required|string|min:8|confirmed',
    ]);

    // バリデーション成功時のみ、ここから先の処理が実行される
}

これらのルールの意味はとてもシンプルで、requiredで「必ず入力が必要」、stringで「文字列であること」、max:255で「最大255文字まで」、emailで「メール形式であること」、uniqueで「既に登録されていないメールかどうか」、min:8で「8文字以上」、そしてconfirmedで「確認用パスワードと一致しているか」をチェックしています。

例：メールが未入力 → エラーを表示してページに戻る
例：パスワードが短い → 「8文字以上にしてください」と案内

3. よく使う基本ルール一覧

3. よく使う基本ルール一覧

Laravelのバリデーションでは、短いキーワードを組み合わせて入力チェックのルールを表現します。どれもよく使うものばかりなので、「意味」と「どんなときに使うか」をセットで覚えておくと、フォームチェックの設計が一気に楽になります。

• required：必ず入力が必要な項目につけます。名前やメールアドレス、パスワードなど「空欄だと困るもの」にはほぼ必ず指定します。
• string：入力値が文字列であることを保証します。数字だけでなく、ひらがな・カタカナ・英字など「文章やテキスト」を扱うフィールドで使います。
• numeric：年齢や金額、個数など「数値」として扱いたい項目に使います。数字以外（例：文字や記号）が入っていた場合はエラーにしてくれます。
• email：〇〇@△△のような正しいメールアドレス形式かどうかをチェックします。見た目がメールっぽくても形式が崩れているとエラーになります。
• max:長さ：文字数や数値の「上限」を決めるルールです。max:255なら「255文字まで」、数値に使えば「その数値以下」という制限になります。
• min:長さ：こちらは「最低〇文字（〇以上）」という下限を決めるルールです。パスワードをmin:8にして「8文字以上」にする、といった使い方をします。
• unique:テーブル名：すでに同じ値がデータベースに存在しないかどうかを確認します。ユーザー登録フォームで「同じメールアドレスを二重登録させたくない」ときなどに使います。
• confirmed：パスワードと確認用パスワードのように、「2つの入力が一致しているか」をチェックするルールです。passwordにこのルールをつけると、自動的にpassword_confirmationとの一致を確認してくれます。
• bail：そのフィールドで最初のエラーが出た時点で、それ以上のルールチェックを打ち切る設定です。「まず必須チェックだけして、空欄なら他は見ない」といった効率的な検証ができます。

$request->validate([
    'name'  => 'required|string|max:255',
    'email' => 'required|email',
]);

4. 配列や数値のチェック

4. 配列や数値のチェック

フォームでは、年齢のような「数値」や、タグ一覧のような「複数の値（配列）」を扱うことがあります。Laravelでは、こうした入力も専用のルールでしっかり判定できます。特に配列チェックは一見難しそうに見えますが、ルールを理解すれば初心者でも無理なく使いこなせます。

次の例では、年齢を数値として検証し、タグ一覧を配列として受け取りつつ、中に入っている各要素を個別にチェックしています。

$request->validate([
    'age' => 'required|numeric|min:0|max:120',
    'tags' => 'required|array',
    'tags.*' => 'string|max:30',
]);

numeric は「数字として扱えるか」を判定し、min と max で許容範囲を指定します。「年齢は数字で0〜120の間に限定したい」といった場面で役立ちます。

array は、送られてきたデータが配列であることを確認するルールです。そして tags.* のように「.*」をつけることで、配列の中身を一つずつチェックすることができます。たとえばブログのタグ入力欄が複数送信されるとき、各タグが文字列で30文字以内かどうかを簡単に確認できます。

例：tags = ["Laravel", "PHP", "初心者講座"]
→ 3つ全部が文字列で30文字以内ならOK

5. nested（ネスト）チェック

5. nested（ネスト）チェック

入れ子になったデータもドット記法でチェックできます。

$request->validate([
    'user.name' => 'required|string',
    'user.email' => 'required|email',
]);

送信されたデータが user[name] や user[email] の形式なら対応できます。

6. bailで早めに止める

6. bailで早めに止める

bailをつけると、最初にエラーが見つかった時点でそのフィールドのチェックが止まります。

$request->validate([
  'username' => 'bail|required|string|max:50',
]);

7. エラー時の画面表示方法

7. エラー時の画面表示方法

Bladeテンプレート内で@errorディレクティブを使うと、フィールドごとに簡単にエラーメッセージを表示できます。

<label>メールアドレス</label>
<input name="email" class="form-control @error('email') is-invalid @enderror">
@error('email')
  <div class="text-danger">{{ $message }}</div>
@enderror

8. よくあるトラブルと対策

8. よくあるトラブルと対策

• 英語メッセージが出る：日本語化するにはphp artisan lang:publishを実行して resources/lang/ja/validation.php を編集します。 :contentReference[oaicite:0]{index=0}
• 確認用フィールドが無い：confirmedを使うなら、password_confirmationなど同名の確認フィールドを用意しましょう。
• 配列チェックでエラー：tags.*のように「.*」で配列要素ごとにルールを指定します。

まとめ

まとめ

今回の記事では、Laravelでフォーム入力のバリデーションを設定する基本ルールについて、初心者でも理解しやすいように解説しました。バリデーションとは、ユーザーが入力したデータが正しい形式かどうかを自動でチェックする仕組みです。例えば、必須項目が空白ではないか、メールアドレスの形式は正しいか、文字数や数字の範囲が適切かなどを検証できます。これにより、間違った情報がデータベースに保存されることを防ぎ、アプリケーションの安全性と利便性を向上させます。

Laravelのコントローラー内では、validate()メソッドを使うことで簡単に基本ルールを設定できます。よく使われるルールとして、required（必須）、string（文字列）、numeric（数字）、email（メール形式）、maxやmin（文字数制限）、unique（データベース内の重複チェック）、confirmed（確認用フィールド一致）などがあります。また、bailを使用すれば、最初にエラーが発生した時点でそのフィールドのチェックを停止できるため、処理の効率化やエラーの優先順位を調整できます。

配列や入れ子構造のデータもLaravelでは簡単にチェックできます。arrayルールで配列かどうかを確認し、tags.*のようにドット記法やワイルドカードを使うことで、配列内の全要素を個別に検証できます。また、user.nameやuser.emailのようなネストされたデータもドット記法を使うことで柔軟にチェック可能です。さらに、Bladeテンプレートでは@errorディレクティブを使って、各入力フィールドに応じたエラーメッセージを簡単に表示できます。

よくあるトラブルへの対応方法も理解しておくと安心です。英語のエラーメッセージが出る場合は、日本語化の設定を行うことで日本語メッセージに変更できます。確認用フィールドがない場合は、confirmedルールに対応するフィールドを用意する必要があります。配列チェックでエラーが出る場合は、.*を使って配列要素ごとにルールを指定しましょう。

サンプルプログラム例

public function store(Request $request)
{
    $validated = $request->validate([
        'name'     => 'required|string|max:255',
        'email'    => 'required|email|unique:users',
        'password' => 'required|string|min:8|confirmed',
        'age'      => 'required|numeric|min:0|max:120',
        'tags'     => 'required|array',
        'tags.*'   => 'string|max:30',
        'user.name'  => 'required|string',
        'user.email' => 'required|email',
    ]);
}

この記事を読んだ人からの質問

この記事を読んだ人からの質問

プログラミング初心者からのよくある疑問／質問を解決します

Laravelでフォームの入力チェックを自動で設定する方法は初心者でもできますか？

はい、Laravelにはバリデーション機能があり、コントローラーのvalidateメソッドを使うだけで簡単に入力ルールを設定できます。初心者でも必要な基本ルールを組み合わせて安全なフォームを作れます。

requiredやstring、numericなどの基本ルールは何のために使うのですか？

requiredは必須入力のチェック、stringは文字列かどうか、numericは数字かどうかを確認するために使います。これにより誤ったデータを保存するのを防げます。