PHP

アプリケーションコードを実行せずに、静的なPHPロケール配列内の文字列リテラルを翻訳します。

PHPアプリケーションでは、配列を返すファイルからメッセージを読み込むことがよくあります。phpファイルハンドラーは、配列内の文字列リテラルを翻訳し、検索キー、コメント、数値、前後の構文はそのまま保持します。PHPを実行することなく、ファイルを走査します。

対応するソース形式 #

例:

php
<?php
return [
    'checkout' => [
        'title' => 'Complete your order',
        'delivery' => 'Delivery within :days days',
    ],
];

テキストのパスはcheckout.titleとcheckout.deliveryです。角括弧を使った配列のネストと、array(...)構文に対応しています。文字列キーは変更されないため、アプリケーションは引き続き同じ識別子で値を検索できます。

メッセージの値は静的な配列に格納してください。文字列の連結、関数呼び出し、変数から生成される文字列には式の評価が必要ですが、このスキャナーは評価を行いません。式の近くで見つかったリテラルは、その式の計算結果とは異なります。こうしたメッセージをファイル翻訳の対象にするには、あらかじめリソース内のリテラル値に移してください。

引用符と既存の翻訳 #

ハンドラーは、各ソース文字列を囲む一重引用符または二重引用符を保持し、その引用符に合わせて置換後の文字列をエスケープします。二重引用符で囲まれた出力では、{$name}など、ソースにすでに含まれる補間トークンを保持し、新たに追加されたドル記号で始まる文字列をエスケープします。:daysなどのアプリケーションのプレースホルダーは、呼び出し元から渡される値を使って確認してください。

差分比較には、返される配列内の各リテラルのパスを使用します。ソースメッセージに変更がなければ、承認済みの翻訳値を保持できます。英語の文言が同じでも、キーを変更すると比較に使われる識別子が変わります。CLIのキー制御では、PHPファイル内のソース値のロック、翻訳値の保持、無視対象のエントリの削除ができます。

キー単位で再構築する際、翻訳値がなく未解決の連想配列エントリが削除されることがあります。一部だけを対象に実行しても、完全なロケールファイルが生成されるとは限りません。ネストされた構造や、アプリケーションが位置に基づいて参照する値をレビューしてください。

ファイルの設定と検証 #

CLIは.phpからphpを推定します。CLI設定またはGitHubで、ソースロケールファイルとその出力先を選択してください。

翻訳先のファイルに対してphp -lを実行し、そのメッセージをアプリケーションに読み込んでください。パラメーターを含む文言は、呼び出し元から渡される値を使って表示してください。Laravelでは、リクエストのロケール選択とフォールバックは引き続きアプリケーション側で設定します。ウェブアプリのローカライズでは、翻訳済みリソースをこれらの手順に組み込む方法を説明しています。