多言語サイト向けに翻訳ファイルを使って翻訳を行う

cakephp

CakePHPには、翻訳をビヘイビアを使用する方法と翻訳ファイルを使用する方法の2つがあるそうです。(他にもあるのかな?)
今回は、翻訳ファイルを使用して言語の切り替えを行い、その言語設定をCookieに保存して次回訪問時もその言語で開くようにしてみようと思います。

翻訳ファイルの原本を作成する

PO/MOファイルというものを使用するようです。
まず、POTファイルつくります。コマンドラインから..../app/Consoleにcd(移動)します。(以下、....はアプリケーションのディレクトリに置き換えて下さい。)

/cake/to/path/Console> cake i18n
Welcome to CakePHP v2.6.1 Console
---------------------------------------------------------------
App : app
Path: /path/to/app/
---------------------------------------------------------------
I18n Shell
---------------------------------------------------------------
[E]xtract POT file from sources
[I]nitialize i18n database table
[H]elp
[Q]uit
What would you like to do? (E/I/H/Q)
> E

POTファイルを作成するため、"E"

Current paths: None
What is the path you would like to extract?
[Q]uit [D]one
[/path/to/app/] > D

抽出元パス(翻訳対象のソースがあるパス)を指定します。指定したディレクトリ配下のソースファイルを全てナメてくれて翻訳部分を抽出してくれるのでアプリ作成後でも対応できます。__('翻訳対象')と記述した部分です。

Current paths: ..../app/Locale/jpn/LC_MESSAGES
What is the path you would like to extract?
[Q]uit [D]one
[D] > D

抽出元がこれでよければ"D"

Would you like to extract the messages from the CakePHP core? (y/n)
[n] > y

"y"にするとcoreファイルからの翻訳が、POT内に書き込まれます。必要なければ"n"のまま。
→CakePHPのライブラリーから出力されるものも翻訳を行いたい場合は、"y"

What is the path you would like to output?
[Q]uit
[/path/to/app/Locale] > /path/to/app/Locale/jpn/LC_MESSAGES

POTファイルの出力先のディレクトリを指定します。
最終的にmoファイルが..../app/Locale/jpn/LC_MESSAGESにあればいいのでどこでもいいですが、わかりやすく同じ場所に出力しておきます。

Would you like to merge all domains strings into the default.pot file? (y/n)
[n] >n

default.potに全ての翻訳データをマージするかを決めます。
ここで、抽出が始まって指定したディレクトリにファイルが出力されます。

翻訳を設定する

POファイルを作成

まず、作成された.potファイルから.poファイルを作成します。ここでも使用したPoeditを使用します。
「ファイル」→「POTファイルを元に新しいカタログを作成します」からdefault.potを指定するとdefault.poが作成されます。このとき、「カタログの設定」というダイアログがでてくるので、「複数形」を以下のように変更を行って下さい。
こうしないと、「invalid nplurals value」と文法エラーで怒られます。

#変更前
nplurals=INTEGER; plural=EXPRESSION;
#変更後
nplurals=2; plural=(n > 1);

POファイル(テキスト)で翻訳を行う

テキストエディタでPOファイルを開き翻訳を行います。msgid:翻訳元 / msgstr:翻訳後

# コメント(ソースファイルのパスなど)
msgid "Hello World"
msgstr "こんにちは、世界さん"

このように記述すると日本語環境では

<?php echo __("Hello World"); ?>

こんにちは、世界さん

と出力されます。
あとは、翻訳したいものを羅列していけばよいです。msgid はファイル内で一意にしなければなりません。

MOファイル(バイナリ)へコンパイル

実際にCakePHPアプリケーションが使用する翻訳データはコンパイルされたMOファイルです。Poeditで.poファイルを開き、「保存」を押すと、編集した.poファイルの内容を元に.moファイルが作成されて完了です。

日本語の場合は"jpn"となり、app/Locale/jpn/LC_MESSAGESに配置
言語ごとの名称は以下を参照
/lib/Cake/I18n/L10n.php

バリデーションエラーメッセージの翻訳

バリデーションエラーメッセージを翻訳する場合は、各モデルで$validationDomainにドメイン名を定義します。ドメイン名とは、moファイル名のこと。
$validate内のメッセージの設定箇所('message' => 'メッセージ')は変更の必要はありません。

public $validationDomain = 'default';

参考:Translating model validation errors

翻訳有無の選択

Cakeアプリケーションは、ブラウザからの情報を元に自動で判断し翻訳を行うか否かを決定します。以下をコントローラ内で記述すると明示的に言語を指定することができます。

// 英語のまま
Configure::write( 'Config.language', 'eng');
// 日本語へ翻訳
Configure::write( 'Config.language', 'jpn');

続く

  • このエントリーをはてなブックマークに追加

関連記事

cakephp

ネストしたリストを出力「nestedList」

DBやJSONからデータを取得して、そのデータをもとにメニュー表示などネストしたリストを出力させたい場合に「nestedList」が便利です。 ヘルパーに渡すデータは連想配列である必要があります。(

cakephp

FullCalendarを使用してカレンダーアプリケーション

カレンダーアプリケーションを作成するため、カレンダー表示できるプラグインを探索して出会ったFullcalendarを試してみました。シンプルに使用できる上に、オプションがかなり豊富です。ダウンロード

cakephp

recursive設定によるfind()性能改善

CakePHPでは、モデルにアソシエーションを設定している場合、recursive(=>joinする階層)はデフォルトで0に設定されています。「recursiveゼロ」の意味するところとは、「1跨ぎま

cakephp

数値系バリデーション

CakePHP 2になっていくつか数値用バリデーションルールが追加されています。 数値用 (コア)バリデーション decimal - 十進数であること numeric - 数値であること

cakephp

Formヘルパーのinputタグのdiv/labelなどの設定

Formヘルパーのinputではデフォルトでは以下のようにdivで囲われて、labelが付与されて出力されます。 CSSのフレームワークなどであらかじめ決まったスタイルがある場合に便利に作られていま

cakephp

Syslogログエンジン

2.4から「Syslog」ログクラスが追加され、簡単にSyslogを使用できるようになりました。 CakePHP側の設定はbootstrap.php内のCakeLogコンフィグのengineを'Sy

cakephp

バリデーション前後に処理を追加できる「beforeValidate」「afterValidate」

CakePHPでは、「beforeValidate」「afterValidate」というバリデーション処理の前後で追加の処理を実装できるコールバック関数が用意されています。 beforeVali

cakephp

hasOne アソシエーション

hasOneアソシエーションはテーブル間で1つのレコードに対して他のテーブルに紐付くレコードが1つの場合にjoinする場合に使用します。 CakePHPのドキュメントにならってUserモデルとP

cakephp

アップロードファイルのバリデーションルール

CakePHP 2.2や2.3になってファイルアップロードに対するルールがコアバリデーションに追加されているようで、まとめてみました。 コアバリデーション 関連しそうなルールは以下の4つの

cakephp

CakePHP インストール時エラーの対処

CakePHPインストール時に出くわすであろうエラーの原因と対処方法についてまとめてみました。前提として、WebサーバはApache、データベースはMySQLとしています。 Timezone未設

Comment

Message

メールアドレスが公開されることはありません。 * が付いている欄は必須項目です


*

PAGE TOP ↑