プロジェクトの国際化

注意：このページで記述している機能を使うには、Ethna 2.5.0 以降が必要です。
(/tmp ディレクトリに sampleプロジェクトを作成 文字コードはデフォルトのUTF-8)
ethna add-project -b /tmp sample
/**
 *  デフォルト状態での使用言語を取得する
 *  外部に出力されるEthnaのエラーメッセージ等のエンコーディングを
 *  切り替えたい場合は、このメソッドをオーバーライドする。
 *
 *  @access protected
 */
function _getDefaultLanguage()
{
    // ロケール名(e.x ja_JP, en_US 等),
    // システムエンコーディング名,
    // クライアントエンコーディング(= テンプレートのエンコーディング) の配列
    return array('ja_JP', 'UTF-8', 'UTF-8');
}
ethna add-action i18ntest
class Sample_Form_I18ntest extends Sample_ActionForm
{
    var $form = array(
        //   form 定義の 以下の要素も、i18nコマンドは抜き出して
        //   くれます。なぜ抜き出してくれるかというと、メンバ変数
        //   の初期化は _et() や、gettext の _() のような関数の戻
        //   り値ではできないからです。
        //
        //   'name', 'required_error',
        //   'type_error', 'min_error',
        //   'max_error', 'regexp_error'
    );
} 

class Sample_Action_I18ntest extends Sample_ActionClass
{
   function prepare()
   {
       return null;
   }

   function perform()
   {
       //  アクション内に国際化メッセージを埋め込む例
       //  _et 関数に渡す値は固定文字列でなければなりません
       //  そうでないと ethna i18n コマンドが解釈できません
       $this->af->setApp('greetings', _et("hello world"));
       $this->af->setApp('part', _et("bye"));
       return 'i18ntest';
   } 
}
ethna add-template i18ntest
ethna add-template -l ko_KR i18ntest
{* /tmp/sample/templates/[ja_JP|ko_KR]/i18ntest.tpl *}
{* PHPスクリプト内での国際化メッセージを埋め込んでもよいし *}
{* 固定の文字列に i18n 修正子を通してもよい *}

{$app.greetings}<br>
{$app.part}<br>
{'foo'|i18n}
ethna i18n -l ja_JP
ethna i18n -l ko_KR
ethna i18n -l ja_JP -g
ethna i18n -l ko_KR -g
;
;   ja_JP.ini
;
;   This file stores Ethna project(Sample) system
;   message and error message and its translation. This
;   file's encoding is always UTF-8.
;
;   This file is ini file like format. For example,
;
;   "msgid" = "Translated string."
;
;   msgid and Translated string must be always double quoted.
;   When you want to include double quote in msgid or Translated
;   string, you must escape it by backslash character.
;   Comment line is started by semicolon character.
;
;   DO NOT CHANGE msgid string!!!!
;

; /tmp/sample/app/action/I18ntest.php
"hello world" = ""
"bye" = ""

; /tmp/sample/template/ja_JP/i18ntest.tpl
"foo" = ""
#
# ja_JP.po
# This is message catalog file for Ethna Project(Sample).
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#

msgid ""
msgstr ""
"Project-Id-Version: PACKAGE VERSION\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2008-10-10 10:53+0900\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"

#: /tmp/sample/app/action/I18ntest.php:97
msgid "hello world"
msgstr ""

#: /tmp/sample/app/action/I18ntest.php:98
msgid "bye"
msgstr ""

#: /tmp/sample/template/ja_JP/i18ntest.tpl
msgid "foo"
msgstr ""
; /tmp/sample/app/action/I18ntest.php
"hello world" = "こんにちは世界"
"bye" = "さようなら"

; /tmp/sample/template/ja_JP/i18ntest.tpl
"foo" = "ふー"
cd /tmp/sample/locale/ja_JP/LC_MESSAGES/
msgfmt -o ja_JP.mo ja_JP.po
$ctl = Ethna_Controller::getInstance();
$ctl->setLocale('ko_KR');
 function _setLanguage($locale, $system_encoding = null, $client_encoding = null)
 {
      //  ロケールを ko_KR に、クライアントエンコーディングを
      //  'EUC_KR' に変更する   
      $this->locale = 'ko_KR';
      $this->system_encoding = $system_encoding;
      $this->client_encoding = 'EUC_KR';

      //  ロケールを変更した際は、必ず $i18n のsetLanguageメソッド
      //  も呼び出すこと。
      $i18n =& $this->getI18N();
      $i18n->setLanguage($locale, $system_encoding, $client_encoding);
 }
// .snip

/**
 *  /tmp/sample/app/Sample_Controller をコピーして作ったもの
 */
class Sample_ko_KR_Controller extends Ethna_Controller
{
    // ... snip

    function _getDefaultLanguage()
    {
        return array('ko_KR', 'UTF-8', 'UTF-8');
    }
}
<?php
require_once '/tmp/sample/app/Sample_ko_KR_Controller.php';

Sample_ko_KR_Controller::main('Sample_ko_KR_Controller', 'index');
?>
$config = array(
    // i18n
    'use_gettext' => true,
);

プロジェクトの国際化