Laravel 5.1 多言語化

イントロダクション

Laravelのローカリゼーション機能はアプリケーションで多言語をサポートできるように、様々な言語の文字列を便利に取得できる方法を提供します。

言語の文字列はresources/langディレクトリー下のファイルに保存します。このディレクトリーの中にアプリケーションでサポートする言語のディレクトリーを設置します。

/resources
    /lang
        /en
            messages.php
        /es
            messages.php

全ての言語ファイルはシンプルにキーと文字列の配列をリターンします。例を見てください。

<?php

return [
    'welcome' => 'Welcome to our application'
];

ロケールの設定

アプリケーションのデフォルト言語はconfig/app.php設定ファイルで指定します。もちろんこの値はアプリケーションに合うように変更できます。さらにAppファサードのsetLocaleメソッドを使い、実行時にアクティブな言語を変更することもできます。

Route::get('welcome/{locale}', function ($locale) {
    App::setLocale($locale);

    //
});

指定された言語行がアクティブな言語で存在しない場合に使用される、「フォールバック言語」を設定することもできます。デフォルト言語と同様に、フォールバック言語もconfig/app.php設定ファイルで指定されます。

'fallback_locale' => 'en',

基本的な使用法

言語ファイルから行を取得するにはtransヘルパ関数を使用します。transメソッドはファイルと言語行を第１引数として受け取ります。たとえばresources/lang/messagesphp言語ファイルのwelcome言語行を取得してみましょう。

echo trans('messages.welcome');

もちろん、Bladeテンプレートエンジンを使っていれば、言語行をechoするために{{ }}記法が使えます。

{{ trans('messages.welcome') }}

指定した言語行が存在していない場合、trans関数はただ言語行のキーを返します。ですから前記の例で言語行が存在していなければ、trans関数はmessages.welcomeをリターンします。

言語行のパラメーターの置き換え

お望みなら言語行でプレースホルダーを定義することもできます。全プレースホルダーは:のプレフィックスが付きます。たとえばnameプレースホルダー付きの歓迎メッセージの例をご覧ください。

'welcome' => 'Welcome, :name',

取得する言語行のプレースホルダーを置き換えるには、trans関数の第２引数に対象の配列を指定してください。

echo trans('messages.welcome', ['name' => 'Dayle']);

複数形化

複数形化は複雑な問題であり、異なった言語において多種複雑な複数形化のルールが存在しています。あなたの言語ファイルでこれを簡単に管理できます。「パイプ」記号の縦線を使うことで、単数形の文字列と複数形の文字列を分けることができます。

'apples' => 'There is one apple|There are many apples',

それから「数」を指定し、trans_choice関数で行を取得します。以下の例では数が１より大きので、複数形の言語行が返されます。

echo trans_choice('messages.apples', 10);

Laravelの翻訳にはSymfony Translationコンポーネントを使用しているため、もっと便利な複数形化のルールも簡単に作成できます。

'apples' => '{0} There are none|[1,19] There are some|[20,Inf] There are many',

ベンダーの言語ファイルのオーバーライド

いくつかのパッケージではそれ自身の言語ファイルが提供されています。出力される文言を調整するためパッケージのコアをハックする代わりに、resources/lang/vendor/{パッケージ}/{ロケールコード}ディレクトリーにファイルを設置することで、オーバーライドできます。

たとえばskyrim/hearthfireパッケージが持っているmessages.phpの英語の言語行をオーバーライドする必要があるなら、resources/lang/vendor/hearthfire/en/messages.phpに言語ファイルを設置します。このファイルには置き換えたい言語行の定義だけを設置することができます。オーバーライドしなかった言語行は、パッケージの言語ファイル中の定義のままロードされます。