Translation2 はさまざまなストレージドライバを提供しています。 このページでは、それらの違いを説明します。
Translation2 は、これらのデータベース抽象化レイヤーの いずれでも使用することができます。使用するには、適切な接続オプションを渡します。 これら 3 つのコンテナの挙動はどれもまったく同じです (Translation2 に関しても、当然同じです)。
<?php
// 接続オプション
$dbinfo = array(
'hostspec' => 'host',
'database' => 'dbname',
'phptype' => 'mysql',
'username' => 'user',
'password' => 'pwd'
);
// お好みのドライバを選択します
$driver = 'MDB2'; // 必要に応じて 'DB' あるいは 'MDB' に変更します
require_once 'Translation2.php';
$tr =& Translation2::factory($driver, $dbinfo, $params);
?>
デフォルトの定義と異なるテーブルを使用している場合は、
$params
でそれを指定しなければなりません。
array.
DB_DataObject
を使用する場合は、dataobjectsimple
コンテナを使用するのが最も自然な選択です。こらは、DAO と密接に結びついています。
このストレージドライバは、
PEAR::DB
抽象化レイヤーがサポートしているすべてのデータベースを使用することができます。
このコンテナを使用する場合は、独自のテーブル定義を指定することはできません。 まだその機能はサポートされていないからです。つまり、 必ず以下の構造のテーブルを作成しなければなりません。
テーブルを作成するための MySQL のクエリは次のようになります。
そして、createtables スクリプトを実行します。
これは gettext 系の関数のラッパーです。 File_Gettext のおかげで、 コマンドラインのコンパイラを使用せずに ドメイン全体を読み込んだりドメインに書き出したりできます。
gettext コンテナには PEAR::File_Gettext および PEAR::I18Nv2 の 0.9.1 以降が必要です。これらがインストールされていることを確認しましょう。
作成時のパラメータは db 系とは少し異なります。 できるだけ簡潔にするため、ドメイン定義と使用できる言語の一覧は INI ファイルから読み込むものとします。
langs.ini は次のようになります。
domains.ini は次のようになります。
Translation2 で gettext コンテナを使用する例です。
<?php
require_once 'Translation2.php';
$params = array(
'prefetch' => false,
'langs_avail_file' => 'path/to/langs.ini',
'domains_path_file' => 'path/to/domains.ini',
'default_domain' => 'messages',
//'file_type' => 'po',
);
// gettext コンテナでは prefetch を FALSE にするほうがよいです。
// これにより、リクエストのたびに File_Gettext が MO ファイルを
// 丸ごと読み込む必要がなくなります。
$tr =& Translation2::factory('gettext', $params);
$tr->setLang('en');
// 翻訳文字列がない場合は、gettext コンテナは文字列の ID を
// 返すことに注意しましょう! これは、gettext 本来の挙動に習ったものです。
echo $tr->get('mystring');
print_r($tr->getPage('3rddomain'));
?>
XML コンテナは PEAR::XML_Serializer 0.13.0 以降を必要とします。 インストールされていることを確認しておきましょう。
<?php
$driver = 'XML';
$options = array(
'filename' => 'i18n.xml',
'save_on_shutdown' => true, // FALSE にすると、即時に保存します
);
require_once 'Translation2.php';
$tr =& Translation2::factory($driver, $options);
?>