地域化とは、あるアプリケーション (あるいはホームページ) が、さまざまな言語を話すユーザによって使用することができるということです。 しかし、ご存知のとおり、地域化とは単に文字列を翻訳するだけのことではありません。 以下のような内容が含まれます。

コンピュータのユーザは皆、(気づいていないかもしれませんが) ロケールを使用しています。 地域化をサポートしていないアプリケーションの場合は、 通常は暗黙的に特定のロケール (そのアプリケーションの作者のロケール) を使用しています。 クラスや関数が地域化されていることを、ここでは ロケールに対応しているということにします。 そのユーザがどの地域にいるのかを、どうやってコードで知るのでしょうか?

ロケール文字列あるいはロケールを表すオブジェクトを使用して、 Zend_Locale およびそのサブクラスはユーザが希望する言語および地域を知ります。 この情報にもとづいて、正しい書式化や正規化、規約を適用します。

ロケール識別子に含まれる情報は、ユーザの言語と 地理上の地域 (たとえば自宅あるいは勤務先の属する州など) です。 Zend Framework が使用するロケール識別文字列は、 国際的に定義されている言語と地域の略称で、 language_REGION という形式です。 言語および地域は、どちらも二文字の ASCII 文字列となります。

アメリカのユーザの言語は 英語、そして地域は アメリカ です。そこで、ロケール識別子は "en_US" となります。 ドイツのユーザの言語は ドイツ、そして地域は ドイツ です。そこで、ロケール識別子は "de_DE" となります。 ロケールおよび地域の組み合わせの定義済みの一覧 を参考に、Zend Framework で使用するロケールを選択しましょう。

<?php
require_once 'Zend_Locale';
$locale = new Zend_Locale('de_DE'); // ドイツ語 _ ドイツ
?>

アメリカに住むドイツ人は、言語は ドイツ語 で地域は アメリカ としたいかも知れません。しかし、このような非標準の組み合わせは、 "ロケール" としては直接サポートしていません。 そのかわりに、もし無効な組み合わせが使用されると、 自動的に地域コードが切り捨てられます。 たとえば "de_IS" は "de" に切り捨てられ、"xh_RU" は "xh" に切り捨てられます。これらの組み合わせは無効だからです。 さらに、言語コードがサポートされていない場合 (例 "zz_US") や存在しない場合は、デフォルトの "root" ロケールを使用します。 "root" ロケールではデフォルトとして、 国際的に認知されている日付、時刻、数値、通過等を定義しています。 この切捨て処理は、要求された情報の内容に依存します。 言語と地域の組み合わせの中には、 特定の型のデータ (たとえば日付) では有効だけれども 別の型 (たとえば通貨) では無効だというものがあるからです。

過去の歴史には注意しましょう。ZF コンポーネントは、 これまでさまざまな場所で変更されてきた過去のタイムゾーンについては対応しません。 たとえば この一覧表 をご覧ください。特定の地域が夏時間を採用するかどうかや、 どのタイムゾーンに属するかなどは、時の政府によって何度も変更されています。 したがって、日付の計算をおこなう際には、 ZF コンポーネントはこれらの変更には対応しません。 その代わりに、現時点の夏時間対応、現時点のタイムゾーンに対応した正しい時刻を使用します。

たいていの場合は、new Zend_Locale() とすると自動的に正しいロケールを選択します。 これはユーザのウェブブラウザから送られてきた情報をもとに判断します。 しかし、new Zend_Locale(Zend_Locale::ENVIRONMENT) を使用すると、以下に示すようにホストサーバの環境設定から情報を取得するようになります。

<?php
require_once 'Zend/Locale.php';
$locale  = new Zend_Locale();
$locale1 = new Zend_Locale(Zend_Locale::BROWSER);     // デフォルトの挙動で、上と同じです
$locale2 = new Zend_Locale(Zend_Locale::ENVIRONMENT); // ホストサーバ上の設定を使用します
$locale3 = new Zend_Locale(Zend_Locale::FRAMEWORK);   // フレームワークアプリケーションのデフォルト設定を使用します
?>

Zend_Locale がロケールの自動選択に使用する検索アルゴリズムは、 三種類の情報をもとにしています。

ZF では、ロケール対応のクラスは Zend_Locale を使用しています。そして、上で説明したように自動的にロケールを選択します。 たとえば、ZF のウェブアプリケーションで Zend_Date を使用して日付を作成すると、何もロケールを指定しなくても ユーザのウェブブラウザの設定からロケール情報を取得してそれを使用します。

<?php
require_once 'Zend/Date.php';
$date = new Zend_Date('2006',Zend_Date::YEAR);
?>

このデフォルトを上書きし、ロケール対応の ZF コンポーネントでウェブサイトの訪問者の設定にかかわらず特定のロケールを指定するには、 コンストラクタの三番目の引数でロケールを明示的に指定します。

<?php
require_once 'Zend/Date.php';
require_once 'Zend/Measure/Temperature.php';

$usLocale = new Zend_Locale('en_US');
$date = new Zend_Date('2006',Zend_Date::YEAR, $usLocale);
$temp = new Zend_Measure_Temperature('100,10',Zend_Measure::TEMPERATURE, $usLocale);
?>

多くのオブジェクトですべて同一のデフォルトロケールを使用することがわかっている場合は、 それを明示的に指定すると、毎回デフォルトロケールを検索することによる オーバーヘッドを回避することができます。

<?php
require_once 'Zend/Date.php';
require_once 'Zend/Measure/Temperature.php';

$locale = new Zend_Locale();
$date = new Zend_Date('2006', Zend_Date::YEAR, $locale);
$temp = new Zend_Measure_Temperature('100,10', Zend_Measure::TEMPERATURE, $locale);
?>

オプション 'precision' の値を使用して、桁数の切り詰めあるいは拡張を行います。 '-1' を指定すると、値の小数部分の桁数を変更しないようにします。 オプション 'locale' は、数値や日付をパースする際の区切り文字や月名を判断するために使用します。 オプション 'format_type' では、CLDR/ISO 日付書式指定トークンおよび PHP の date() で使用するトークンのどちらを使用するかを選択します。 オプション 'fix_date' は、無効な形式の日付に対する自動修正処理を有効あるいは無効にします。 オプション 'number_format' は、toNumber() で使用するデフォルトの数値書式を指定します (詳細は 項18.3.2. 「数値の地域化」 を参照ください)。

'date_format' オプションでデフォルトの日付書式文字列を指定することができます。 しかし、setOptions() で 'date_format' を指定した後で getDate() や checkdateFormat() そして getTime() を使用する際には十分注意しましょう。 これらのメソッドをそのロケールのデフォルトの日付書式で使用するには array('date_format' => null, 'locale' => $locale) をメソッドのオプションで指定します。

<?php
require_once 'Zend/Locale.php';
Zend_Locale_Format::setOptions('locale' => 'en_US', 'fix_date' => true, 'format_type' => 'php');
?>

ロケールの標準の定義を使用する場合は、オプション Zend_Locale_Format::STANDARD を指定します。date_format に Zend_Locale_Format::STANDARD を設定すると、 実際に設定されているロケールの標準定義を使用します。 これを number_format に設定すると、このロケールの標準数値書式を使用します。 また、locale に設定すると、この環境あるいはブラウザの標準のロケールを使用します。

<?php
require_once 'Zend/Locale.php';
Zend_Locale_Format::setOptions('locale' => 'en_US', 'date_format' => 'dd.MMMM.YYYY');
// グローバル設定の日付書式をオーバーライドします
$date = Zend_Locale_Format::getDate('2007-04-20, array('date_format' => Zend_Locale_Format::STANDARD);

// 標準ロケールのグローバル設定
Zend_Locale_Format::setOptions('locale' => Zend_Locale_Format::STANDARD, 'date_format' => 'dd.MMMM.YYYY');

?>