Laravelのバリデーションエラーメッセージを日本語化・カスタマイズする方法

Laravelでフォームを作成すると、バリデーション機能が非常に便利です。
しかし、デフォルトのままだと、エラーが発生した際に「The name field is required.」のように、英語のメッセージが表示されてしまいます。

ユーザーにとって親切なアプリケーションを作るためには、これらのメッセージを日本語のわかりやすい表現にカスタマイズすることが不可欠です。

「でも、エラーメッセージの日本語化はどうやるの？」
「”name”の部分を”お名前”に変えたい」
「特定のフォームだけでメッセージを変えるには？」

この記事では、上記のような疑問を解決していきますので、是非参考にしてください。

【著者プロフィール＆本記事の信頼性】

著者は元エンジニア
大手プログラミングスクールのWebディレクター兼ライターを経験
自らも地元密着型のプログラミングスクールを運営

⇒プロフィール詳細はコチラ

当ブログ著者

忖度は一切なし！
本気で未経験からエンジニア転職を目指すなら、
日本最大級の比較サイト「マイベスト」で【4年連続人気NO.1】となった
RUNTEQ（ランテック）一択！

【RUNTEQの特徴】
✅受講生からの評判が驚くほど良い
✅学習はハードだが未経験とは思えないほど高いスキルが身に付く
✅挫折させない万全なサポート体制が用意されている
✅採用面接で担当者に刺さるレベルの高い「ポートフォリオ」を作成できる
✅給付金を使えば実質約13万円という格安料金で受講できる

＼もちろん勧誘行為は一切なし！　相談だけでもOK！／

少しでも気になる方は、無料カウンセリングで話を聞いてみるのがおすすめ！
≪RUNTEQ公式サイト≫

【基本】エラーメッセージをBladeビューに表示する方法
1. サンプルコード：@errorを使った表示
バリデーションメッセージをカスタマイズする3つの主要な方法
プレースホルダを理解して使いこなす
まとめ

【基本】エラーメッセージをBladeビューに表示する方法

メッセージをカスタマイズする前に、まずはエラーメッセージをビューに表示させる方法を確認しておきましょう。

Laravelでは、バリデーションに失敗すると、自動的にエラーメッセージが$errorsという変数に格納され、ビューに渡されます。

フォームの上部などに全てのエラーをまとめて表示することもできますが、ユーザー体験を考えると、各入力項目の直下に個別のエラーメッセージを表示するのが一般的です。これには@errorディレクティブを使うのが最も簡単です。

サンプルコード：@errorを使った表示

<form method="POST" action="/profile">
    @csrf

    <div>
        <label for="name">お名前</label>
        <input id="name" type="text" name="name" value="{{ old('name') }}">
        
        {{-- 'name'フィールドにエラーがあればメッセージを表示 --}}
        @error('name')
            <div class="alert alert-danger">{{ $message }}</div>
        @enderror
    </div>

    <div>
        <label for="email">メールアドレス</label>
        <input id="email" type="email" name="email" value="{{ old('email') }}">
        
        @error('email')
            <div class="alert alert-danger">{{ $message }}</div>
        @enderror
    </div>

    <button type="submit">更新</button>
</form>

@errorディレクティブは、引数に指定したフィールド（この場合はname）にエラーメッセージが存在する場合のみ、その内部のHTMLを描画します。$messageという変数には、該当するエラーメッセージが自動的に格納されています。

バリデーションメッセージをカスタマイズする3つの主要な方法

Laravelでバリデーションメッセージをカスタマイズするには、主に3つの方法があります。

それぞれに特徴があるため、状況に応じて最適なものを選択しましょう。

方法1：Form Requestでメッセージをカスタマイズする（推奨）

Controllerが太るのを防ぎ、バリデーションロジックを専用のクラスに分離できるForm Requestは、実務において最も推奨される方法です。

まず、artisanコマンドでForm Requestクラスを作成します。

php artisan make:request UserUpdateRequest

app/Http/Requests/UserUpdateRequest.phpというファイルが生成されます。

次に、このファイルを編集して、バリデーションルール、カスタムメッセージ、そして属性名（項目名）の日本語化を設定します。

サンプルコード：UserUpdateRequest.php

<?php

namespace App\Http\Requests;

use Illuminate\Foundation\Http\FormRequest;

class UserUpdateRequest extends FormRequest
{
    /**
     * このリクエストの認可設定。
     *
     * @return bool
     */
    public function authorize(): bool
    {
        // ここでは単純にtrueを返すが、実際にはユーザーの権限チェックなどを行う
        return true;
    }

    /**
     * バリデーションルールを定義する。
     *
     * @return array<string, \Illuminate\Contracts\Validation\ValidationRule|array<mixed>|string>
     */
    public function rules(): array
    {
        return [
            'name' => 'required|max:255',
            'email' => 'required|email|unique:users,email',
        ];
    }

    /**
     * バリデーションエラーのカスタムメッセージを定義する。
     *
     * @return array
     */
    public function messages(): array
    {
        return [
            'name.required' => 'お名前は必ず入力してください。',
            'name.max' => 'お名前は255文字以内で入力してください。',
            'email.required' => 'メールアドレスは必ず入力してください。',
            'email.email' => '有効なメールアドレス形式で入力してください。',
            'email.unique' => 'このメールアドレスは既に使用されています。',
        ];
    }

    /**
     * バリデーションエラーのカスタム属性名を定義する。
     *
     * @return array
     */
    public function attributes(): array
    {
        return [
            'name' => 'お名前',
            'email' => 'メールアドレス',
        ];
    }
}

rules()メソッド: ここにバリデーションルールを記述します。
messages()メソッド: 項目名.ルール名をキーとして、表示したいメッセージを定義します。これがメッセージのカスタマイズの核心部分です。
attributes()メソッド: 項目名をキーとして、メッセージ内で:attributeプレースホルダに表示される名前を定義します。これにより、「nameは必須です」が「お名前は必須です」のように変わります。

最後に、Controller側でこのForm Requestをインジェクション（注入）するだけで、バリデーションが自動的に実行されます。

// Controllerの該当メソッド
use App\Http\Requests\UserUpdateRequest;

public function update(UserUpdateRequest $request)
{
    // バリデーションは既に通過している
    // ここに更新処理などを記述
}

方法2：言語ファイルでメッセージをカスタマイズする

アプリケーション全体で使われるデフォルトのメッセージや属性名を変更したい場合は、言語ファイルを編集するのが効率的です。

Laravelの言語ファイルはresources/langディレクトリにあります。
日本語のファイルがない場合は、jaディレクトリを作成し、その中にvalidation.phpを配置します。（php artisan lang:publishコマンドで全言語ファイルを公開することもできます）

このファイルは巨大な連想配列になっており、主にmessages, custom, attributesの3つのキーを編集します。

messages配列：デフォルトメッセージの日本語化

配列のキーはバリデーションルール名に対応しています。
ここの値を日本語にすることで、アプリケーション全体のデフォルトメッセージが変更されます。

// resources/lang/ja/validation.php

return [
    // ...
    'required' => ':attributeは必須です。',
    'max' => [
        'string' => ':attributeは:max文字以内で入力してください。',
    ],
    'email' => ':attributeは有効なメールアドレス形式ではありません。',
    // ...
];

attributes配列：属性名の日本語化

attributes()メソッドと同様に、ここで属性名を定義すると、アプリケーション全体でnameがお名前に置き換わります。

// resources/lang/ja/validation.php

return [
    // ...
    'attributes' => [
        'name' => 'お名前',
        'email' => 'メールアドレス',
        'password' => 'パスワード',
    ],
    // ...
];

方法3：Controllerで直接メッセージをカスタマイズする

簡単なフォームや、一度しか使わないようなバリデーションの場合、Controller内で直接メッセージを定義することもできます。

Validatorファサードか、$request->validate()メソッドを使います。

validate()メソッドを使う場合

validate()メソッドの第2引数にカスタムメッセージの配列を渡します。

use Illuminate\Http\Request;

public function store(Request $request)
{
    $validated = $request->validate(
        // 第1引数：バリデーションルール
        [
            'name' => 'required|max:10',
        ],
        // 第2引数：カスタムメッセージ
        [
            'name.required' => 'ユーザー名は必須です。',
            'name.max' => 'ユーザー名は10文字以内でお願いします。',
        ]
    );

    // ...
}

プレースホルダを理解して使いこなす

Laravelのバリデーションメッセージには、動的な値に置き換わる「プレースホルダ」が用意されています。

これらを活用することで、より柔軟なメッセージを作成できます。

プレースホルダ	説明	例
`:attribute`	検証中のフィールド名。`attributes()`や言語ファイルでカスタマイズ可能。	`お名前`
`:min`	`min`ルールで指定された最小値。	`10`
`:max`	`max`ルールで指定された最大値。	`255`
`:size`	`size`ルールで指定されたサイズ。	`5`
`:values`	`in`ルールなどで指定された値のリスト。	`A, B, C`