FinchUI多言語ウェブサイト翻訳プラグイン-翻訳キャッシュが有効かどうかを確認する方法

finchui 2026-08-15 16:30:21 127 コレクション記事

FinchUI 多言語サイトプラグインは、テキストの翻訳結果をローカルファイルに保存します。同じソーステキストとターゲット言語に再び遭遇した場合、プラグインはキャッシュを直接読み取り、サードパーティの翻訳インターフェイスを要求しなくなります。

本文の翻訳キャッシュディレクトリ: zb_users/cache/fui_multilang/為替レートキャッシュディレクトリ:zb_users/cache/fui_multilang_currency/

一、キャッシュファイルが生成されたかどうかを確認する

デフォルト以外の言語が有効で、翻訳するテキストが含まれているページにアクセスした後、zb_users/cache/fui_multilang/を表示します。ディレクトリは、ターゲット言語とハッシュプレフィックスによって階層化されます。例:

fui_multilang/
└── en/
    └── ab/
        └── cd/
            └── abcdef...json

これらの各. jsonファイルは通常、正常に翻訳されたテキストに対応しており、ファイルの内容には翻訳結果が含まれています。

{
  "time": 1780000000,
  "text": "Translated text"
}

ページを初めて開くと、新しいJSONファイルが表示され、翻訳結果がキャッシュに正常に書き込まれたことを示します。

二、同じページで二度検証にアクセスする

プラグインのバックグラウンドで翻訳キャッシュをクリアします。
翻訳サービスプロバイダーのバックエンドでのリクエスト回数または文字消費を記録します。
英語のページなど、中国語テキストを含むデフォルト以外の言語のページにアクセスします。
キャッシュディレクトリにJSONファイルが追加されたことを確認し、翻訳サービスプロバイダーの使用量を再度記録します。
まったく同じページに再度アクセスします。

期待される結果: 2回目のアクセスはローカルキャッシュに直接ヒットする必要があります。ページの内容、ターゲット言語、およびキャッシュの有効期間が変更されない限り、翻訳サービスプロバイダーのリクエストまたは文字の消費量は増加し続けるべきではありません。

三、空白のハッシュディレクトリを理解する方法

現在のバージョンでは、翻訳が正常に取得された場合、または短期間の翻訳の失敗を記録する必要がある場合にのみ、2レベルのハッシュディレクトリが作成されるため、新しく作成されたハッシュディレクトリには対応するJSONファイルが含まれている必要があります。

キャッシュ読み取り、キャッシュヒットチェック、およびホームページの翻訳対象フラグメントの事前スキャンは、ファイルパスのみをカウントし、言語やハッシュディレクトリは作成しません。
翻訳インターフェイスが空でない翻訳を返すと、プラグインは本文翻訳JSONファイルを書き込みます。
翻訳インターフェイスの実際のリクエストが失敗すると、プラグインは短期の. fall.json失敗キャッシュに書き込み、一時的に重複リクエストを回避します。ファイルの有効期限が切れると、自動的に再試行されます。
古いバージョンで残された空のディレクトリは、キャッシュヒットに影響を与えず、キャッシュが成功したことを示しません。

アップグレード前にすでに存在していた空のディレクトリは、キャッシュ書き込み要求がないことを確認したときに保持またはクリーンアップできます。アップグレード後、キャッシュの失敗またはフラグメントの上限のために、通常のアクセスで空のハッシュディレクトリを追加し続けるべきではありません。インターフェイスが実際に失敗した場合、空のディレクトリを残すのではなく、短期的な失敗キャッシュファイルが書き込まれます。

四、どのような状況をさらに調査する必要があるか

空のディレクトリが急速に増加し続けているが、対応する言語ページでJSONファイルが生成されていない場合、または同じページにアクセスするたびに翻訳サービスプロバイダーの使用量が増加し続けている場合は、次のことを確認してください。

翻訳インターフェイスキー、ロケール、および署名の構成が正しいかどうか。
プラグインのバックエンドの翻訳インターフェースのテストが成功したかどうか。
サーバーが翻訳サービスプロバイダーインターフェイスにアクセスできるかどうか。
翻訳されるページのテキストが、バックグラウンドで設定された1ページの翻訳フラグメントの上限を超えているかどうか。
キャッシュディレクトリとその親ディレクトリにPHPプロセス書き込み権限があるかどうか。
キャッシュの有効期間が短すぎるか、頻繁に手動でクリーンアップされているか。

五、キャッシュの有効期間とファイル時間

キャッシュの有効期間は、バックグラウンドの「翻訳キャッシュ日数」によって制御され、デフォルト値は30日です。有効期間を過ぎたキャッシュファイルは、その後の読み取りまたはランダムなクリーンアップ時に無効になり、削除されます。次回テキストが必要になったときにのみ、翻訳インターフェイスが再度呼び出されます。

キャッシュがヒットすると、プラグインは最大6時間ごとにファイルの変更時間を更新します。したがって、同じページに短時間で連続してアクセスし、JSONファイルの変更時間が変わらないのは正常な状況です。

ヒント:空のディレクトリのみをクリアする必要がある場合は、キャッシュに書き込まれているリクエストがないことを確認した後に処理できます。