Laravelで多言語対応フォームを作成する方法

1. 言語ファイルの準備

1. 言語ファイルの準備

Laravelではresources/langディレクトリに言語ごとのフォルダを作成します。例えば日本語と英語の場合、jaとenを作ります。

resources/lang/ja/form.php
resources/lang/en/form.php

それぞれのファイルにフォームで使う文字列を配列形式で定義します。

// resources/lang/ja/form.php
return [
    'name' => 'お名前',
    'email' => 'メールアドレス',
    'message' => 'お問い合わせ内容',
    'submit' => '送信',
];

// resources/lang/en/form.php
return [
    'name' => 'Name',
    'email' => 'Email',
    'message' => 'Message',
    'submit' => 'Submit',
];

2. フォームBladeでの表示

2. フォームBladeでの表示

Bladeテンプレートでは__()ヘルパー関数を使って言語ファイルの文字列を表示します。

<form action="{{ route('contact.send') }}" method="POST">
    @csrf
    <input type="text" name="name" placeholder="{{ __('form.name') }}">
    <input type="email" name="email" placeholder="{{ __('form.email') }}">
    <textarea name="message" placeholder="{{ __('form.message') }}"></textarea>
    <button type="submit">{{ __('form.submit') }}</button>
</form>

これにより、アプリケーションの言語設定に応じてフォームのラベルが自動で切り替わります。

3. 言語切替のルーティング

3. 言語切替のルーティング

ユーザーが言語を切り替えられるようにルートとコントローラを設定します。

Route::get('lang/{locale}', function ($locale) {
    if (in_array($locale, ['ja','en'])) {
        session(['locale' => $locale]);
    }
    return redirect()->back();
});

このルートでユーザーの希望言語をセッションに保存します。

4. ミドルウェアで言語設定

4. ミドルウェアで言語設定

言語をセッションから読み込み、アプリ全体で反映させるためのミドルウェアを作成します。

public function handle($request, Closure $next)
{
    if (session()->has('locale')) {
        app()->setLocale(session('locale'));
    }
    return $next($request);
}

Kernel.phpにミドルウェアを登録することで全ページで言語が反映されます。

5. バリデーションメッセージの多言語化

5. バリデーションメッセージの多言語化

フォームのバリデーションメッセージも多言語対応できます。resources/lang/ja/validation.phpやen/validation.phpを編集します。

// 例：requiredのメッセージ
'required' => ':attribute は必須です。',

Bladeで@error('name')を使うと、言語ごとのエラーメッセージを表示できます。

6. ベストプラクティス

6. ベストプラクティス

• フォームラベルやプレースホルダーは必ず言語ファイルに分離する
• バリデーションメッセージも多言語化して一貫性を保つ
• 言語切替用のセッションとミドルウェアで全ページ対応を行う
• 新しい言語を追加する場合は、既存の配列構造をコピーして翻訳するだけで簡単に拡張可能