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

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

生徒

「Laravelで作ったフォームを日本語だけでなく英語や他の言語でも使えるようにしたいです。」

先生

「それならLaravelの多言語機能であるローカライゼーションを使うと便利です。」

生徒

「ローカライゼーションって何ですか？」

先生

「アプリケーション内の文字列を複数の言語に対応させる仕組みです。これで同じフォームを使ってユーザーが選んだ言語で表示できます。」

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での表示

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. 言語切替のルーティング

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


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

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

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

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


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

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

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

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


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

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

6. ベストプラクティス

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

まとめ

Laravelで多言語対応フォームを作るときの重要ポイント

Laravelで多言語対応フォームを実装する場合は、ローカライゼーション機能を理解しておくことがとても重要です。Laravelには標準で多言語機能が用意されており、フォームのラベル、プレースホルダー、ボタンの文字、エラーメッセージなどを簡単に多言語化できます。これにより、同じアプリケーションを日本語だけでなく英語や他の言語でも利用できるようになります。特にお問い合わせフォームや会員登録フォーム、入力フォームなどのユーザーインターフェースは、言語に対応しているかどうかでユーザーの使いやすさが大きく変わります。

Laravelの多言語対応フォームを実装する基本的な流れは、言語ファイルを作成し、Bladeテンプレートで翻訳関数を使用し、ユーザーの選択した言語をセッションに保存し、ミドルウェアでアプリケーション全体に適用するという構成になります。この仕組みを理解しておくことで、Laravelのフォーム開発だけでなく、Webアプリケーション全体の国際化対応にも応用できるようになります。

言語ファイルの役割

Laravelの多言語機能の中心になるのが言語ファイルです。言語ファイルはresourcesディレクトリの中のlangフォルダに配置され、言語ごとにフォルダを分けて管理します。例えば日本語の場合はjaフォルダ、英語の場合はenフォルダを作成します。このフォルダの中にフォーム用の翻訳ファイルを配置することで、フォームのラベルやメッセージを言語ごとに管理できます。


resources
    lang
        ja
            form.php
        en
            form.php

このように言語ごとにフォルダを分けて翻訳ファイルを管理しておくと、将来的に中国語や韓国語など別の言語を追加する場合でも簡単に拡張できます。多言語対応の設計では、最初から翻訳ファイルを使う構造にしておくことがとても重要です。

Bladeテンプレートで翻訳を表示する

LaravelではBladeテンプレートで翻訳文字列を表示するために、翻訳ヘルパー関数を使用します。フォームのラベルや入力欄のプレースホルダー、ボタンのテキストなどはすべて翻訳関数を使って表示することで、言語設定に応じて自動的に切り替わります。


<form action="{{ route('contact.send') }}" method="POST">
    @csrf

    <div class="mb-3">
        <label class="form-label">{{ __('form.name') }}</label>
        <input type="text" name="name" class="form-control" placeholder="{{ __('form.name') }}">
    </div>

    <div class="mb-3">
        <label class="form-label">{{ __('form.email') }}</label>
        <input type="email" name="email" class="form-control" placeholder="{{ __('form.email') }}">
    </div>

    <div class="mb-3">
        <label class="form-label">{{ __('form.message') }}</label>
        <textarea name="message" class="form-control" placeholder="{{ __('form.message') }}"></textarea>
    </div>

    <button type="submit" class="btn btn-primary">
        {{ __('form.submit') }}
    </button>

</form>

このようにLaravelのBladeテンプレートで翻訳キーを使用すると、ユーザーが選択した言語に応じてフォームの表示が自動的に切り替わります。多言語対応フォームを作るときは、フォームの文字列を直接書くのではなく、必ず翻訳ファイルから読み込むようにすることがポイントです。

言語切替の仕組み

Laravelの多言語対応では、ユーザーが選択した言語をセッションに保存する方法がよく使われます。言語をセッションに保存することで、ユーザーがページを移動しても同じ言語設定を維持できます。次のようなルートを作成すると、URLから簡単に言語を切り替えることができます。


Route::get('lang/{locale}', function ($locale) {

    if (in_array($locale, ['ja','en'])) {
        session(['locale' => $locale]);
    }

    return redirect()->back();

});

この仕組みを使うと、日本語と英語の切り替えリンクを作ることができます。


<a href="/lang/ja" class="btn btn-outline-secondary">日本語</a>
<a href="/lang/en" class="btn btn-outline-secondary">English</a>

このようなリンクをヘッダーやナビゲーションに配置しておくと、ユーザーが自由に言語を切り替えられるWebアプリケーションになります。

ミドルウェアで言語設定を反映する

セッションに保存された言語設定は、ミドルウェアを使ってアプリケーション全体に反映させます。ミドルウェアはリクエストごとに実行されるため、セッションの言語情報を読み取ってアプリケーションの言語設定を変更できます。


public function handle($request, Closure $next)
{

    if (session()->has('locale')) {
        app()->setLocale(session('locale'));
    }

    return $next($request);

}

このミドルウェアを登録しておくことで、Laravelアプリケーションのすべてのページで言語設定が統一されます。多言語対応のWebアプリケーションでは、このミドルウェアの設定がとても重要になります。

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

フォーム開発では、入力エラーのメッセージもユーザーの言語に合わせて表示することが大切です。 Laravelではvalidation.phpという翻訳ファイルを使うことで、バリデーションメッセージも簡単に多言語化できます。


'required' => ':attribute は必須項目です。',
'email' => ':attribute の形式が正しくありません。',
'max' => [
    'string' => ':attribute は :max 文字以内で入力してください。',
],

このようにバリデーションメッセージを翻訳ファイルに定義しておくことで、フォームの入力エラーも自然な言語で表示できます。ユーザー体験を高めるためにも、バリデーションメッセージの多言語化は重要なポイントです。

Laravelの多言語対応フォームを理解しておくと、グローバル対応のWebサービスや海外ユーザー向けのサイトを作るときにも役立ちます。フォームの多言語化は難しそうに見えますが、Laravelのローカライゼーション機能を使えば比較的シンプルな構成で実装できます。そのため、Laravelを使ったWebアプリケーション開発では、最初から翻訳ファイルを活用した設計を意識しておくことが大切です。

先生と生徒の振り返り会話

生徒

Laravelで多言語対応フォームを作るには、言語ファイルを作ることが重要なんですね。

先生

その通りです。フォームのラベルやメッセージを直接書くのではなく、翻訳ファイルから読み込む設計にすることで、簡単に多言語対応ができます。

生徒

Bladeテンプレートでは翻訳関数を使えば良いんですよね。

先生

はい。翻訳関数を使うことで、日本語と英語を自動で切り替えることができます。Laravelのフォーム開発ではこの書き方が基本になります。

生徒

言語切替はセッションを使って管理するんですね。

先生

その通りです。ユーザーが選択した言語をセッションに保存し、ミドルウェアでアプリケーション全体に反映させます。これがLaravelの多言語対応の基本的な仕組みです。

生徒

バリデーションメッセージも翻訳ファイルで管理できるのは便利ですね。

先生

はい。フォーム入力エラーのメッセージもユーザーの言語で表示することで、より使いやすいWebアプリケーションになります。

生徒

Laravelの多言語対応フォームの仕組みがよく理解できました。これなら海外ユーザー向けのサイトも作れそうです。

先生

その意識はとても大切です。Laravelのローカライゼーション機能を理解しておけば、フォームだけでなくWebアプリケーション全体の多言語対応にも応用できます。

公的機関での指導実績【Laravel実務設計実践セミナー】

商用Laravel 11 実務設計講座：サービスコンテナとAPIアーキテクチャの正解

#商用設計 #APIアーキテクチャ #市場価値最大化

ハローワーク職業訓練講師の実績を持つプロが監修。商用PHP開発の「現場の作法」を完全伝授。

「商用ロジック」を堅牢に設計する。Laravel 11でバックエンドエンジニアへの市場価値を最大化。

本講座では、単なる構文の暗記ではなく、「疎結合なサービス設計と依存性の注入（DI）」という本質的な技術を学びます。モダン開発のデファクトスタンダードであるLaravel 11を通じて、高単価案件で必須となるAPIアーキテクチャや保守性の高いコード設計を最短距離で身につけます。

具体的なワークショップ内容と環境

【つくるもの】
商用システムでも通用する「認証基盤を備えたRESTful API」の土台を構築します。ルーティング、Controllerでのリクエスト処理、Eloquentを用いたデータベース最適化など、現場で評価される「クリーンなバックエンド実装」をゼロから体験してください。

【開発環境】
プロの開発現場で標準のVisual Studio Code (VS Code)に加え、Laravel開発を加速させるPHPStorm対応のテクニックも紹介。Dockerコンテナ環境（Laravel Sail）を用いた環境構築から、テスト自動化（Pest/PHPUnit）の導入まで、現場基準のフローを一緒に構築します。