[多言語] - ２４時間CakePHP

CakePHP1.2.8以前、1.3.5以前に重大なセキュリティホールが見つかりました。
ただちにコアを最新版にアップデートすることをお勧めします。

本題

カレントの言語を指定するには、次のようにすると思います。

<?php
// app/locale/ja_jp ディレクトリ以下の情報を用いる
Configure::write('Config.language', 'ja_jp');
?>

以下、この例でいう'ja_jp'を識別子と呼びます。

さて、識別子が、l10nのカタログ（のキー）に存在するとき、l10nはそれに対応する「locale」「localeFallback」といった値を、languagePath（ロケール情報をもつディレクトリへのパス郡）に追加します。

よって、例えば、識別子に「ja」を指定した場合、以下のようになります。

<?php
//　識別子「ja」はカタログにあり、「locale」、「localeFallback」の値は「jpn」
Configure::write('Config.language', 'ja');
//　よって、app/locale/jpn/ 以下の情報を参照する
//　$l10n->languagePath = array('jpn', 'jpn');
?>

カタログって何？

言語に対する様々な情報を保持しています。
リクエストヘッダのHTTP_ACCEPT_LANGUAGEをキーになっています。（振り分けが容易）

<?php
// 日本語の例
'ja' => array(
	'language' => 'Japanese', // 言語のフルネーム
	'locale' => 'jpn', // setlocale()などに適応される地域名
	'localeFallback' => 'jpn', // 下記を参照
	'charset' => 'utf-8', // この言語を使用する際に推奨される文字エンコーディング（自信なし）
	'direction' => 'ltr' // 文字の方向。ltr(left to right)とrtl(right to left)のどちらか
)
?>

localeFallbackですが、fallbackとは予備のもの、といった意味合いを持ちます。

例えば英語の場合、様々な地域・国で使われ、方言も多種多様にわたりますが、

locale => en_ca // カナダ英語
localeFallback => eng // カナダ英語も英語！

という風に、英語ならどこの地域・国でも「eng」を予備として利用できる、といった風になります。

つまりapp/locale/engに記述をおけば、多種多様な英語圏の国・地域に適応できるといったことが可能になります。

余談

最初、本題のことが理解できておらず、小一時間デバッグして、ようやくたどり着き、どうせなら噛み砕いてみようと思ってこのエントリを書きました。半分備忘録です。

なかなか大多数の地域に渡って多言語化することはないと思いますが、世界中で利用されているCakePHPならではの機能であるなぁと思います。

Permalink | コメント(0) | トラックバック(2) | 22:19

2010/03/04

TimeHelperを使って多言語対応の日付・時刻を表示する

CakePHP1.3, Helper, 日付・時刻, 多言語

CakePHP1.3からは、TimeHelperでi18nFormat()というメソッドが使えます。

http://book.cakephp.org/ja/view/1566/View-と-Helper

概要

このメソッドは、strftime()の書式を与えると、アプリケーションのロケール情報に基づいて日付・時刻を返します。

setlocale()してからstrftime($this->Time->fromString($time))するのと何が違うの？

この機構の素晴らしいところは、アプリケーションレベルでローカライゼーションの制御ができるということです。

と言ってもよくわからないと思うので、実際に使えるところまでのチュートリアルを示します。

LC_TIMEファイルの設置

まず、このメソッドを使うにあたって、LC_TIMEファイルを設置しなければなりません。

これはubuntuやdebianの、/usr/share/i18n/locales以下にあるファイル群からコピーできます。

設置場所はapp/locale/言語/LC_TIMEです。（言語 == Configure::read('Config.language')）

<?php
// in config/core.php
Configure::write('Config.language' ,'ja');
?>

とします。

$ cp /usr/share/i18n/locales/ja_JP /var/www/myapp/app/locale/ja/LC_TIME

GUIで操作する場合、フォルダではなく、ファイルをコピーしてきてリネームしてください。

使ってみる

CakePHP1.3からはTimeHelper::format($date,$format)が18nFormat()のエイリアスになっています。

この例ではi18nFormat()として使っていますが、実用的にはformat()で十分でしょう。

デフォルトのフォーマット

<?php
// in View
echo $this->Time->i18nFormat(time());
?>

さて、何が表示されましたか？

”2010年03月04日”

のような表示ならば成功です。

”2010U5E7403U670804U65E5”みたいなよくわからん文字になる
1. Gitの最新版にアップデートしてください。修正しました。
”2010年03月%d日”となって文字化けする
1. 修正パッチを送りましたがまだ適用されてません。後にパッチを載せておきますので、使ってみてください。

フォーマットを指定する

<?php
   // ”2010年03月04日”
echo $this->Time->i18nFormat(time(),'%x %X');
echo $this->Time->i18nFormat(time(),'%c');
   // ”午前07時50分59秒”
echo $this->Time->i18nFormat(time(),'%r');
   // ”木”
echo $this->Time->i18nFormat(time(),'%a');
   // ”木曜日”
echo $this->Time->i18nFormat(time(),'%A');
   // ”3月”
echo $this->Time->i18nFormat(time(),'%b');
echo $this->Time->i18nFormat(time(),'%B');
?>