symfony-cache

Symfony Cache (Symfony)

使用する場面

• リポジトリの結果、計算済みの値、サードパーティーからのレスポンスなど、コストの高い読み取りをキャッシュする場合。
• プールとそのアダプター（ファイルシステム、Redis、APCu、チェーン）の選択や設定を行う場合。
• すべてをクリアするのではなく、タグを使って無効化する場合。
• 負荷が高いときにホットキーの有効期限が切れ、すべてのリクエストで一斉に再計算が発生する場合。
• HTTP キャッシュヘッダーやキャッシュウォーマーを追加する場合、またはデプロイ時にプールをクリアする場合。

デフォルトのワークフロー

1. 何がどのくらいの頻度で再計算されるか、また古くなってもよいかを特定します。
2. アクセスパターンとデプロイ構成に合わせて、プールとアダプターを選択します。
3. 有効期限を明示して CacheInterface::get() を使用します。
4. すべてのエントリーに、その元となるデータのタグを付け、書き込み時にはタグで無効化します。
5. 再計算にコストがかかるキーでは、早期有効期限切れを有効にします。

ガードレール

• すべてのエントリーに有効期限を設定します。有効期限のないエントリーはプールから削除されません。
• ユーザー入力をハッシュ化せずにキャッシュキーに含めたり、シークレットをキャッシュキーに含めたりしないでください。
• プール全体をクリアするのではなく、タグで無効化します。全体のクリアはコールドスタートにつながります。
• キャッシュされた値は、定義上、古くなっています。正確性が必須のものはキャッシュしないでください。
• タグによる無効化にはタグ対応アダプターが必要なので、プールの設定時に選択してください。

段階的な情報開示

• 実行方針とリスク管理にはこのファイルを使用します。
• 実装の詳細が必要な場合は、リファレンスを参照します。

出力要件

• プールとアダプターの設定、および各エントリーに選択した有効期限。
• タグマップ：どの書き込みでどのタグが無効化されるか。
• 再計算にコストがかかる場合のスタンピード保護。
• 書き込みによって適切な対象が無効化されることの証拠。

リファレンス

• reference.md