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

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

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

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

【基本】エラーメッセージを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のバリデーションメッセージには、動的な値に置き換わる「プレースホルダ」が用意されています。

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

これらのプレースホルダは、メッセージ文字列に含めるだけで自動的に実際の値に置き換えられます。

例： 'name.max' => ':attributeは:max文字を超えないでください。' → 「お名前は255文字を超えないでください。」

まとめ

今回は、Laravelのバリデーションエラーメッセージを日本語化し、カスタマイズするための様々な方法を解説しました。

なお、PHPやLaravelを体系的に学んだり、スキルを高めたりするためには、プログラミングスクールを利用するのも有効です。

細かな疑問がすぐに解決するだけでなく、現役エンジニアが「質の高いポートフォリオ」を作成するための手助けをしてくれたり、エンジニア就職・転職のコツを教えてくれたりするなど、様々なメリットがありますので、独学に疲れた方は検討してみてはいかがでしょうか。

PHPを学べるプログラミングスクールおすすめ10選【2025年最新版】

Webサービス開発の現場で長年愛用され、今なお多くのシステムで採用されているプログラミング言語「PHP」。 初心者でも比較的学びやすく、豊富な求人数や案件数から将来性も期待できるため、プログラミング学習の第一歩としてPHPを選ぶ方が非常に多...

progneer.net

Follow me!