» オブジェクトのクローンを作成し、 ロケールオブジェクトを正確かつ効率的に複製することができます。 ロケール対応のメソッドのほとんどは、$locale->toString() が返す文字列表現のロケールを受け付けます。

<?php
require_once 'Zend/Locale.php';

$locale = new Zend_Locale('ar');

// $locale オブジェクトをシリアライズして保存します
$serializedLocale = $locale->serialize();
// もとのオブジェクトを再度作成します
$localeObject = unserialize($serializedLocale);

// ロケールの文字列表記を取得します
$stringLocale = $locale->toString();

// $local オブジェクトの複製を作成します
$copiedLocale = clone $locale;

print "copied: ", $copiedLocale->toString();
print "copied: ", $copiedLocale; // PHP は、__toString() 経由で自動的に toString() をコールします
            

Zend_Locale は、 二つのロケールを比較するための便利な関数も提供しています。 ロケール対応のクラスはすべて、これと同等の同一性チェック機能を提供しなければなりません。

<?php
require_once 'Zend/Locale.php';

$locale = new Zend_Locale();
$mylocale = new Zend_Locale('en_US');

// ロケールが同一かどうかを調べます
if ($locale->equals($mylocale)) {
    print "これらのロケールは同一です";
}
            

getDefault() メソッドは、関連するロケールの配列を返します。 これは、ユーザのウェブブラウザからの情報 (取得できる場合)、 ホストサーバの環境変数および ZF の設定をもとに取得します。 Zend_Locale のコンストラクタの最初のパラメータで、 (BROWSER、ENVIRONMENT あるいは FRAMEWORK のうちの) どの情報を優先するかを選択します。 二番目のパラメータでは、マッチしたロケールをすべて返すのか あるいは最初にマッチした/一番マッチしたものを返すのかを指定します。 ロケール対応のコンポーネントは、通常は最初のロケールのみを使用します。 優先度が指定されている場合は、それも考慮します。

<?php
require_once 'Zend/Locale.php';

$locale = new Zend_Locale();

// すべてのデフォルトロケールを返します
$found = $locale->getDefault();
print_r($found);

// ブラウザのロケールのみを返します
$found2 = $locale->getDefault(Zend_Locale::BROWSER,TRUE);
print_r($found2);
            

BROWSER、ENVIRONMENT あるいは FRAMEWORK のいずれかに対応するデフォルトロケールを取得するには、 それぞれ対応するメソッドを使用します。

• getEnvironment()

• getBrowser()

• getLocale()

新しいロケールを設定するには、関数 setLocale() を使用します。この関数は、ロケール文字列をパラメータとして受け取ります。 ロケールを省略した場合は、ロケールが 自動的に選択 されます。Zend_Locale オブジェクトは "light" なので、このメソッドは既存のインスタンスを参照しているすべてのコードに影響をおよぼします。

<?php
require_once 'Zend/Locale.php';

$locale = new Zend_Locale();

// 実際のロケール
print $locale->toString();

// 新しいロケール
$locale->setLocale('aa_DJ');
print $locale->toString();
            

getLanguage() を使用して、二文字の言語コード文字列を ロケール識別文字列から取得します。また、 getRegion() を使用して、二文字の地域コード文字列を ロケール識別文字列から取得します。

<?php
require_once 'Zend/Locale.php';

$locale = new Zend_Locale();

// ロケールが 'ja_JP' の場合は、'ja' が言語として返されます
print $locale->getLanguage();

// ロケールが 'ja_JP' の場合は、地域として 'JP' が返されます
print $locale->getRegion();
            

getTranslationList() を使用すると、地域化された情報を利用することができます。 これらの情報は、各地域に特化したデータを顧客に対して提供する際に 翻訳の必要がなくなるので便利です。 これらはすでに使用可能となっています。

情報の一覧は、常に連想配列形式で返されます。 複数の値を明示的な型に渡したい場合は、複数の値ではなく配列を渡す必要があります。

<?php
require_once 'Zend/Locale.php';

$locale = new Zend_Locale('de_AT');
$list = $locale->getTranslationList('language');

print_r ($list);
// キーと値の組み合わせの例...
// [de] -> Deutsch
// [en] -> Englisch

// これらのキーのいずれかを getTranslation() メソッドで使用します
print $locale->getTranslation('de', 'language', 'zh');
// これは、言語 'de' を中国語で表した文字列を返します
            

すべての言語についてこの情報を取得できます。しかし、 言語によってはすべての情報が提供されているわけではないものもあります。 これらの型のいくつかについては、その型に特化した関数を用意して簡単に使用できるようにしています。 詳細はこの一覧を参照ください。

単一の翻訳データがほしい場合は、getTranslation() を使用します。 この関数は常に文字列を返しますが、getTranslationList() メソッドよりも多くの型を使用することができます。 また、値についても一点を除いて同じです。 取得したい値について、詳細を指定する必要があります。

注意: ほとんどすべての場合について値を指定する必要があるので、 このパラメータを最初に指定するようになっています。 この点は getTranslationList() メソッドと異なります。

詳細な情報は、次の表を参照ください。

注意: Zend Framework 1.5 では、いくつかの古い型の名前が変わりました。 新しい型が追加されたこと、スペルが間違ったいたこと、 そして使いやすさを考慮したことなどが理由です。 変更内容は以下の表でご確認ください。

以下の例は、さまざまな言語でのものの名前を取得する方法を示すものです。

<?php
require_once 'Zend/Locale.php';

$locale = new Zend_Locale('en_US');
// すべての国名をドイツ語で表示します
print_r($locale->getTranslationList('country', 'de'));
            

次の例は、ある言語の名前を別の言語でどのようにいうのかを、 二文字の ISO 国コードを知らない場合に調べるものです。

<?php
require 'Zend/Locale.php';
$locale = new Zend_Locale('en_US');
$code2name = $locale->getLanguageTranslationList();
$name2code = array_flip($code2name);
$frenchCode = $name2code['French'];
echo $locale->getLanguageTranslation($frenchCode, 'de_AT');
// 出力は、「フランス語」を表すドイツ語の名前になります
            

何ができるのかをもう少し詳しく知るには、次の例の出力を確認してみましょう。

<?php
// すべての翻訳の一覧を取得します
$lists = $locale->getTranslationList();

// 使用できるすべての翻訳を表示します (大量に出力されます。すべて英語で表示されます)
foreach ($lists as $list) {
    echo "List $list = ";
    print_r($locale->getTranslationList($list));
}
            

Zend_Locale で使用できるすべての言語の一覧を、それぞれの言語での表記で取得するには、 以下の例をウェブページで使用してみましょう。 同様に getCountryTranslationList() および getCountryTranslation() を使用すると、 あなたのネイティブ言語での地域名と別の言語での地域名の対応表を作成できます。 try .. catch ブロックで、 存在しないロケールを使用した場合の例外を処理するようにしましょう。 すべての言語がすべてのロケールに対応しているわけではありません。 この例では、例外を無視することで、 スクリプトが途中で終わってしまうことを防いでいます。

<?php
require_once 'Zend/Locale.php';

$sourceLanguage = null; // あなたのネイティブ言語のコードを設定します
$locale = new Zend_Locale($sourceLanguage);
$list = $locale->getLanguageTranslationList();

foreach($list as $language => $content) {
    try {
        $output = $locale->getLanguageTranslation($language, $language);
        if (is_string($output)) {
            print "\n<br>[".$language."] ".$output;
        }
    } catch (Exception $e) {
        continue;
    }
}
            

プログラム上で、ユーザに "はい" あるいは "いいえ" で答えてもらうことがよくあります。 getQuestion() を使用すると、 ユーザに問い合わせるときに使用する単語あるいは正規表現文字列を含む配列を、 特定の $locale (デフォルトは、そのオブジェクトのロケール) にあわせて返します。 返される配列の中身は次のようになります。

• yes および no: yes および no に対応する一般的な文字列表現です。 これは、yesarray および noarray の最初の要素でもあり、もっとも一般的な内容です。

  yesarray および noarray: yes および no に対応する内容をすべて含む配列です。 言語によっては単に「はい」「いいえ」以外の返答を持つものもあります。 一般に、これは完全な文字列とその省略形になります。

  yesexpr および noexpr: 正規表現で、ユーザの回答から yes か no かを判定できるようにします。

これらのすべての情報は当然地域化されており、 設定されているロケールによって変化します。 以下の例で、どのような情報が取得できるのかを確認してみましょう。

<?php
require_once 'Zend/Locale.php';

$locale = new Zend_Locale();
// 設問の文字列
print_r($locale->getQuestion('de'));

- - - 出力 - - -

Array
(
    [yes] => ja
    [no] => nein
    [yesarray] => Array
        (
            [0] => ja
            [1] => j
        )

    [noarray] => Array
        (
            [0] => nein
            [1] => n
        )

    [yesexpr] => ^([jJ][aA]?)|([jJ]?)
    [noexpr] => ^([nN]([eE][iI][nN])?)|([nN]?)
)
            

注意: 1.0.3 までは、yesabbr もロケールデータから取得可能でした。 1.5 以降、この情報は単体では存在しません。しかし、同じ情報を yesarray から取得できます。

すべての既知のロケールの一覧を取得したいこともあるでしょう。 たとえば、ロケール選択用の select 要素を作成する場合などに必要となるはずです。 このようなときには、静的メソッド getLocaleList() を使用します。 このメソッドは、すべての既知のロケールの一覧を返します。

<?php
require_once 'Zend/Locale.php';

$localelist = Zend_Locale::getLocaleList();

            

注意: 返された配列のキーがロケール名となっていることに注意しましょう。 キーに対応する値は、常に true です。