Laravel9を日本語化する4つのステップを紹介します。
Laravel8までと翻訳ファイルの場所が異なるので、注意してくださいね。
Laravel9完全日本語化4ステップ：エラー・ビュー・通知を日本語にする
まずはデフォルトの設定から変更していきましょう。
①デフォルトの設定を変更する
app/config のapp.phpファイルを開き、86行目あたりのlocale を en から ja に変えておきます。
ちなみに、その下の ‘fallback_locale’は、設定したlocaleが使えなかった場合に使用する言語をいれます。こちらは、デフォルトの英語のままで良いでしょう。
さらにその下の ‘faker_locake’は、テスト用のフェイク（ダミー）データを作る時の言語を指定します。ここも ‘ja’としておくと、日本語のダミーデータが作れます。
「渡辺学」みたいな、実在しそうな名前のテストデータを作れて楽しいですよ。詳しくは下記記事をどうぞ。
② 日本語翻訳を準備する
なお残念ながら、言語の設定を変えただけでは、日本語にはなりません。Laravelはデフォルトでは英語用のメッセージしかないので、日本語訳を追加してあげる必要があります。
日本語訳の置き場所は、Laravel9では、プロジェクト直下のlangファイルの中となります。
ちなみにLaravel8まではresources/langの中でした。昔の記事等を見る時には、注意してくださいね。
デフォルトでは、langフォルダの中には、英語（en)フォルダが入っています。lang/enの中には、4つのファイルが入っています。4つのファイルと使う場面は、下記のとおりです。
| auth.php | 認証用 |
|---|---|
| pagination.php | ページネーション用 |
| passwords.php | パスワード用 |
| valication.php | バリデーション用 |
このlangフォルダ内に 日本語（ja)版フォルダを作っていきましょう。
さらに、ja.jsonファイルも作成します。ja.jsonファイルには、基本のユーザーインターフェースの翻訳をいれます。
langフォルダの中を図にすると、次のようになります。赤色部分が日本語用ファイル・フォルダとなります。
翻訳は自分で行っても良いのですが、ちょっと大変ですよね＾＾；
既存の翻訳を使わせてもらいましょう。２つほど、Laravelの日本語翻訳が得られる場所を紹介します。
GitHub
GitHub上にはLaravelの日本語化に便利なライブラリがいくつかあります。
Laravel-Lang/langは日本語以外にも色々な言語が用意されています。
ただLaravel Breezeパッケージを使うなら、2022年11月2日現在、下記のライブラリが使いやすいと感じます。インストール方法も日本語で分かりやすく書かれています。
Laravel公式マニュアル
Laravelの公式マニュアルでも、下記ページに日本語化のためのコマンドが紹介されています。
ja.jsonファイルについての翻訳はないのですが、バリデーション等、４つのファイルの翻訳が入手できます。
ただマニュアルどおりコマンドを実行すると、resourcesの中にlangフォルダが出来てしまいます。
Laravel8まではこの場所で良いのですが、Laravel9以降は、langフォルダの場所はプロジェクトの直下となります。少々面倒ですが、移動させておきましょう。
③ 翻訳されていない場所を個別に翻訳する
これでエラーメッセージは日本語になりましたが、自分で追加したフィールド名は英語のまま残っていたりします。
この部分を日本語にするには、lang/ja/validation.phpファイルを編集する必要があります。
まずは、日本語化したい箇所をチェックしておきましょう。たとえば、上記のフォームの「件名」は、次のコードで書かれています。
|
1 |
<input type="text" name="title" class="form-control" id="title" > |
name属性の【title】部分がエラーメッセージに使われています。
次に、lang/ja/validation.phpを開き、’attributes’ に翻訳を追加していきます。
たとえば、titleを「件名」、bodyを「本文」としたい場合は、下記のようにします。
|
1 2 3 4 |
'attributes' => [ 'title'=>'件名', 'body'=>'本文', ], |
これで、新たに追加した部分も日本語化できます。
④ 上記4ステップでは満足できない場合
もし気に入らない翻訳があれば修正しちゃいましょう。
なおjsonファイルは、最後の閉じカッコの前に不要なカンマがあったりするとエラーになるので、気を付けてくださいね（経験談）。
おまけ 通知メールの翻訳
なお通知メール（notifications）については、別記事で解説しています。ご興味あれば、こちらもご覧ください。
コメント