YIIに国際化（I18N）とローカリゼーション（L10N）を実装するにはどうすればよいですか？-YII-php.cn

YIIに国際化（I18N）とローカリゼーション（L10N）の実装

YIIは、組み込みのメッセージ変換メカニズムと、さまざまな日付/数字のフォーマットライブラリとの統合を通じて、国際化（I18N）とローカリゼーション（L10N）に対する堅牢なサポートを提供します。 YiiのI18N機能のコアはYii::t()メソッドに依存しています。このメソッドは、3つの引数を取ります。カテゴリ（メッセージソースを識別する文字列）、メッセージ自体、およびメッセージに置き換えるパラメーターのオプションの配列です。メッセージは、メッセージ翻訳ファイルに保存され、通常は言語とカテゴリごとに編成されます。

たとえば、「こんにちは、世界！」というメッセージを翻訳するためにこのような配列を含むメッセージの翻訳ファイル（メッセージmessages/en/app.php messages/es/app.phpを最初に作成します。

 <code class="php">// messages/en/app.php return [ 'Hello, world!' => 'Hello, world!', ]; // messages/es/app.php return [ 'Hello, world!' => '¡Hola, mundo!', ];</code>

ログイン後にコピー

次に、あなたのコードでは、 Yii::t()のように使用します。

 <code class="php">echo Yii::t('app', 'Hello, world!');</code>

ログイン後にコピー

YIIは、アプリケーション言語（通常はユーザー設定またはブラウザの好みに基づいて）を自動的に検出し、適切な翻訳を取得します。アプリケーション構成でlanguageプロパティを使用してアプリケーション言語を構成できます。さらに、 Yii::$app->languageプロパティを使用して、アプリケーション内の現在の言語に動的にアクセスして変更できます。これにより、ユーザーエクスペリエンス内で言語の切り替えを管理するための柔軟で動的なアプローチが可能になります。翻訳が欠落している可能性のある潜在的な例外を適切に処理することを忘れないでください。フォールバックメカニズムまたはデフォルト値を提供することを検討してください。

YIIアプリケーションで翻訳を管理するためのベストプラクティス

YIIの効果的な翻訳管理には、構造化されたアプローチが必要です。

メッセージ抽出ツールを使用します。YIIは、コードから翻訳可能な文字列を抽出するツールを提供し、手動で検索せずに翻訳を簡単に管理できるようにします。これにより、翻訳プロセスが大幅に合理化されます。
メッセージカテゴリを整理する：組織と保守性を向上させるために、メッセージカテゴリ：論理カテゴリ（「アプリ」、「ユーザー」、「管理者」などをグループ化します。これにより、アプリケーションの特定の部分の翻訳を管理および更新する方が簡単になります。
翻訳管理システム（TMS）を使用：大規模なプロジェクトについては、TMSの使用を検討してください。 TMSにより、翻訳者、バージョン制御、合理化されたワークフロー間のコラボレーションが可能になります。人気のあるオプションには、Poeditor、フレーズ、またはCrowdinが含まれます。これらのツールは、多くの場合、それぞれのAPIを介してYiiと統合できます。
一貫した命名規則を採用します。メッセージキーの一貫した命名規則に従って、明確さを確保し、曖昧さを避けます。これにより、保守性が向上し、エラーが減少します。
ダイナミックコンテンツにプレースホルダーを使用します。メッセージ文字列内でプレースホルダー（ {name} ）を使用して、値の動的置換を可能にします。これにより、柔軟性が向上し、同様のメッセージの複数の翻訳が必要になります。
定期的に翻訳を更新する：アプリケーションの変更を反映するために、翻訳を最新の状態に保ちます。これは、ユーザーエクスペリエンスの一貫性と精度を維持するために重要です。
徹底的にテスト：翻訳をさまざまな言語とブラウザで厳密にテストして、それらが正しく機能し、正確に表示されるようにします。この重要なステップは、翻訳関連の問題を特定して修正するのに役立ちます。

さまざまなロケールの異なる日付と数値形式の処理

YIIは、PHP Intl拡張機能からIntlDateFormatterおよびNumberFormatterクラスを活用して、さまざまなロケールの異なる日付と数字形式を処理します。 PHP構成でINTL拡張機能が有効になっていることを確認してください。

日付のフォーマットには、 Yii::$app->formatter->asDate()またはYii::$app->formatter->asDatetime()を使用して、形式とロケールを指定します。例えば：

 <code class="php">echo Yii::$app->formatter->asDate('2024-03-08', 'long', 'fr-FR'); // French (France) long date format echo Yii::$app->formatter->asDateTime('2024-03-08 10:30:00', 'medium', 'de-DE'); // German (Germany) medium date and time format</code>

ログイン後にコピー

同様に、数値のフォーマットには、 Yii::$app->formatter->asDecimal() 、 Yii::$app->formatter->asInteger() 、 Yii::$app->formatter->asCurrency()などを使用して、番号、形式、およびロケールを提供します。

 <code class="php">echo Yii::$app->formatter->asDecimal(1234.56, ['locale' => 'en-US']); // US English decimal format echo Yii::$app->formatter->asCurrency(1234.56, ['currencyCode' => 'EUR', 'locale' => 'de-DE']); // Euro currency in German (Germany) format</code>

ログイン後にコピー

アプリケーション構成でformatterコンポーネントを構成して、デフォルトのフォーマットオプションとロケールを指定することを忘れないでください。これにより、フォーマット設定の中央管理が可能になります。上記の例で示されているように、これらのデフォルトを1コールごとにオーバーライドできます。

Yiiでi18nおよびL10nを実装する際の一般的な課題と解決策

YIIにI18NとL10Nを実装することで、いくつかの課題を提示できます。

コンテキスト翻訳：一部のメッセージでは、コンテキストに応じて異なる翻訳が必要になる場合があります。これには、慎重な計画が必要であり、潜在的により詳細なメッセージの分類またはパラメーターの使用がコンテキスト情報を提供する必要があります。
多元化と性別の合意：異なる言語には、多元化とジェンダー契約に関するルールが異なります。 YIIはYii::t()メソッドのパラメーターを介した複数化をサポートしていますが、性別契約を処理するには、より多くのカスタムロジックが必要になる場合があります。可能であれば、フレームワークの組み込みの複数化機能を利用します。
右から左（RTL）言語： RTL言語をサポートするには、レイアウトとスタイリングを慎重に検討する必要があります。 CSSとHTMLがRTL言語に適応できることを確認してください。
一貫性の維持：すべての翻訳で一貫した用語とスタイルを確保することは困難です。スタイルガイドを使用し、一貫した翻訳プロセスを採用して、この問題を軽減します。
翻訳の欠落：不足している翻訳を優雅に処理し、アプリケーションエラーを回避するためにデフォルト値またはフォールバックメカニズムを提供します。
大規模な翻訳ファイル：非常に大規模なアプリケーションの場合、多数の翻訳ファイルを管理することは面倒になります。データベースまたは翻訳管理システム（TMS）を使用して、プロセスを合理化することを検討してください。