コンテンツへスキップ

キャッシュ

Blockstudioには永続的なファイルベースキャッシュが含まれます。cache.enabled設定によりデフォルトで有効になり、次の場所に書き込まれます。

コード
wp-content/blockstudio/cache/

この設定済みルートには、ランタイムのビルドデータ、事前構築されたブロック登録データ、エディターアセット、Tailwind CSS、レンダリング済みドキュメント、アイランドフラグメント、静的HTML、グラフインデックス、ウォームキュー、キャッシュ診断情報がすべて格納されます。これにより、検出、解析、コンパイル、レンダリングを繰り返す作業を避けながら、生成されたランタイム状態をホスト側で管理できる単一の境界内に保てます。

デフォルトの場所は意図的にuploadsの外に設定されています。強化されたホスト環境では、PHPのキャッシュデータがブロックされる場合があるためです。場所を変更するにはcache.pathを使います。相対パスはWP_CONTENT_DIRを起点とし、絶対パスでは専用の書き込み可能なキャッシュボリュームを指定できます。

JSON
{
  "cache": {
    "enabled": true,
    "path": "cache/blockstudio"
  }
}

環境ごとに設定するには、設定フィルターまたは解決済みディレクトリのフィルターを使います。

PHP
add_filter('blockstudio/settings/cache/path', function () {
    return '/srv/wordpress-cache/blockstudio';
});

add_filter('blockstudio/cache/dir', function (string $directory): string {
    return WP_CONTENT_DIR . '/cache/blockstudio';
});

パスを変更すると、コールドキャッシュから始まります。wp-content/uploads/blockstudio/cache以下の古いファイルは読み込まれなくなり、削除できます。

IDと無効化

各スコープは、ネットワーク/ブログの識別情報と完全なランタイム識別情報の下にネストされます。監視対象のブロックファイル、フィールドファイル、アセット依存関係、設定、現在のテーマ、有効なプラグイン、論理検出インベントリ、WordPress、PHP、Blockstudioのバージョンなど、入力が変わるとキャッシュエントリーも変わります。アイテムごとの依存関係ハッシュにより、変更分のみを対象とするビルドを無関係なオブジェクトから分離できます。

論理検出ソースも、ソースID、コンテンツフィンガープリント、監視対象の入力を追加します。別のランタイム選択では、すべてのキャッシュスコープを分離するためにblockstudio/cache/context値を追加できます。 テナントの境界がWordPressのネットワーク/ブログIDと異なるホストでは、blockstudio/cache/site_keyで絞り込めます。結果はパスセグメントになる前にサニタイズされます。

ウォーム状態のフロントエンドリクエストでは、Blockstudioが検出ソースを構築する前にランタイムレジストリをハイドレートします。そのため、有効なキャッシュヒットがあれば、再帰的なソース検出、ブロック構築、フィールド解析、キャッシュキーのツリー走査の繰り返しを省略できます。

ランタイムペイロードには、解決済みのブロックアセットのパス、サイズ、タイムスタンプ、モジュールのスタイルシート一覧も保存されます。ウォームリクエストでは、レンダリングされたブロックごとにアセット出力を検索したり、モジュールディレクトリをスキャンしたりせずに、このメタデータが再利用されます。現在のリクエストではアセットURLと無効化フィルターが引き続き実行され、assets.inlineLimitのページ全体の予算とカスケード順序も維持されます。assets.enqueueまたは永続キャッシュが無効な場合、アセット出力メタデータは収集されません。古くなった直近の正常なビルドでは、ディスクからアセットの解決が行われます。

変更されていない解決済み設定では、リクエスト内で同じフィンガープリントも再利用されます。 設定を再読み込みまたは変更すると無効になり、変更可能なオブジェクトや参照値は、古くなった可能性のあるフィンガープリントを再利用せず、再ハッシュされます。

productionとstagingでは、検証済みの監視スナップショットを20秒間信頼してから、Blockstudioがファイルとディレクトリを再度統計取得します。localとdevelopmentの環境ではデフォルトがゼロのため、ソースの編集がすぐに反映されます。間隔は次のように変更します。

PHP
add_filter('blockstudio/cache/watch_debounce', function () {
    return 30;
});

デバウンスにより、自動的なソース変更検出は設定した秒数を超えて遅れることはありません。必須のコンパイル済みアセット、キャッシュ済みの空でない生アセット、モジュールのスタイルシートは、キャッシュヒットのたびに引き続き確認されます。ファイルを削除すると、ウィンドウの期限が切れるまで古いアセットメタデータを提供するのではなく、ランタイムペイロードが直ちに無効になります。本番環境に近い環境をアクティブなファイル編集にも使用する場合は、デバウンスを0に設定してください。

キャッシュペイロードはPHPファイルで保護されています。書き込みプロセスでOPcache共有メモリが有効で、保存先が除外されていない場合、小さなペイロードには通常の配列が使われます。その場合、後続のインクルードではOPcacheがコンパイル済み配列を再利用できます。返されたデータを変更しても、PHPの通常のコピーオンライト動作が使われます。

共有メモリを使うOPcacheがない場合、ペイロードは圧縮されたシリアライズデータのままです。OPcacheがいっぱいの場合、APIを利用できないか制限されている場合、またはそのブラックリストやopcache.max_file_sizeでファイルが除外されている場合も同様です。ファイルキャッシュのみのOPcacheでは、通常配列形式は選択されません。ホスト側でこれらを制御する設定については、OPcache設定PHPを参照してください。

デフォルトの通常配列形式は、シリアライズデータと生成されたPHPソースの両方を基準に、1 MiBまでに制限されています。これを超えるペイロードは圧縮されたままにし、OPcacheのないCLIプロセスがウェブワーカーによってウォームアップされたキャッシュを読み込む際の、大きな配列のコンパイルコストを避けます。 このような読み込み側では小さな通常ファイルも解析が必要で、新しく書き込まれたファイルはopcache.file_update_protection中にコンパイルが必要になることがあります。

blockstudio/cache/compressフィルターを使うと、スコープごとに形式を上書きできます。たとえば、WP-CLIがOPcache有効のウェブワーカー向けにキャッシュファイルをウォームアップする場合に使えます。falseを返すとサイズ制限も上書きされます。生成されたPHPファイルをすべての読み込み側で処理できる場合に限ってください。zlibが利用できない場合は、通常のPHPが引き続きフォールバックとして使われます。

同時実行と保持

コールドキャッシュのキーには、単一実行のロックが使われます。1つのリクエストがデータを構築し、同時に来たリクエストは同じ検出やコンパイルを繰り返さず、結果がアトミックに公開されるのを待ちます。アトミックな公開により、不完全なオブジェクトの公開を防ぎます。更新に失敗しても、最後に成功した有効なオブジェクトを引き続き利用でき、失敗は記録され、次のリクエストで復旧できます。

ランタイムスコープはデフォルトで、公開済みデータを20件保持します。連携機能が意図的により多くのキャッシュコンテキストを作成する場合は、スコープごとに上限を調整してください。

PHP
add_filter(
    'blockstudio/cache/max_files_per_scope',
    function (int $maximum, string $scope): int {
        return 'runtime' === $scope ? 50 : $maximum;
    },
    10,
    2
);

保持処理では、インストール済みの早期配信マップが参照するファイルは削除されません。また、blockstudio/cache/protected_pathsフィルターで、整理時に残す追加パスを指定できます。

未使用の名前空間は自動的に回収されるため、プラグインの有効化やPHP、WordPressの更新のたびに蓄積しません。以前のTailwindキャッシュディレクトリをglobで検索していたデプロイ用スニペットでは、代わりにBlockstudio\Runtime_Cache::purge('tailwind')を呼び出してください。

たとえばWordPressのコア更新後など、ランタイム識別情報が変わると名前空間は廃止されます。廃止後、最初のクリーンアップ処理で.retiredマーカーが書き込まれ、それからcache.namespaceGrace秒(デフォルトでは1日)が経過するとツリーが回収されます。その間に再び書き込まれたツリーでは猶予期間が最初から始まります。スコープの現在の名前空間と、有効化済みアーティファクトを早期配信マップが引き続き配信している名前空間は回収されません。後者の猶予期間は、次の有効化でマップのエントリーが別の場所に移った時点から始まります。WordPressの外でキャッシュされたページは、レンダリング時に使ったコンテンツハッシュ付きスタイルシートへのリンクを保持します。そのため、tailwind.output: "link"ページをCDNや長期間のブラウザーキャッシュ経由で配信するサイトでは、コピーが存続しうる最長時間に合わせて猶予期間を延ばしてください。

JSON
{
  "cache": {
    "namespaceGrace": 777600
  }
}

アップグレードしたインストールに7.6より前のフラットなcache/runtimeディレクトリが含まれている場合、Blockstudioはそれをアクティブなパスからアトミックに名前変更して移動します。その後、WP-Cronが1回の処理につき最大500件のファイルシステムエントリーを削除します。これにより、古いデータや.build.lockツリーがディスクを圧迫するのを防ぎつつ、大きなディレクトリを検出したリクエストが再帰的に削除する事態を避けられます。クリーンアップはcache.enabledが有効な場合にのみ実行されます。ホスト側で処理単位を小さく、または大きくする必要がある場合は、blockstudio/cache/legacy_cleanup_batch_sizeで件数を変更してください。

blockstudio.jsonで永続キャッシュを無効にします。

JSON
{
  "cache": {
    "enabled": false
  }
}

またはフィルターを使います。

PHP
add_filter('blockstudio/settings/cache/enabled', '__return_false');

パフォーマンスで説明するリクエスト単位のメモリ内レンダーキャッシュは別のものですが、永続アーティファクトには同じファイルシステム境界を使います。

古いロックの滞留を解消する

7.6.14より前のリリースでは、コンテンツが変更されるたびに.build.lockファイルが1つ残り、アクセスの多いサイトでは数十万件に達することがあります。アップグレード後は、WP-Cronが自動的に上限付きバッチで削除します。滞留をすぐに解消し、ホスト側に件数を伝えるには、CLIを実行します。

シェル
wp bs cache status
wp bs cache cleanup

statusは残っている古いロックの数と、次のバッチの実行時刻を表示します。cleanupは、待機中のものがなくなるまでバッチを実行し、その後、猶予期間を過ぎたキャッシュ名前空間を回収します。1時間以内に作成されたロックや、実行中のリクエストが保持しているロックは、次回の処理に残します。サイトへのアクセス中にロックファイルを手動で削除しないでください。保持中のロックは、同時リクエストによる並列ビルドを防ぐための選出機構です。

wp bs cache clearは現在のサイトのランタイムキャッシュ全体を消去します。--scope=runtimeを指定すると、すべての名前空間にまたがる1つのスコープを消去します。次のリクエストではコールド状態から再構築されるため、アクセスの少ない時間帯に実行してください。

Tailwindキャッシュ

Tailwindのコンパイル済みCSSキャッシュは、共有ランタイムルートのネットワーク/サイト/ランタイム名前空間とtailwindスコープを使います。デフォルトでは、最大1,000件を30日間保存します。少数のルートで追い出されることなく、サイト全体のページ単位のキーを保持できます。

Tailwindは、長時間稼働するプロセス内で同じCSS入力に対するウォーム状態のコンパイラーを再利用し、プロセス間でもコンパイラーの構築状態を保存します。コールド状態のページ候補セットは引き続き個別にコンパイルされますが、そのたびにフレームワークパーサーを再構築する必要はありません。

保持期間を変更するには、次のフィルターを使います。

PHP
add_filter('blockstudio/tailwind/cache_max_files', function () {
    return 1500;
});

add_filter('blockstudio/tailwind/cache_max_age', function () {
    return 14 * DAY_IN_SECONDS;
});

最小期間は1時間です。

キャッシュファイルにはコンテンツハッシュが付与され、キャッシュされたページはURLごとに1つのファイルへリンクするため、ファイルの削除状況と保存済みページが必要とするファイルが食い違う場合があります。配信前にプリレンダリング済みドキュメントとリンク先のスタイルシートを照合するため、ファイルが削除されていてもスタイルなしのページではなく、再レンダリングが1回行われます。cache_max_filesをページ単位のキーの種類数より大きくすれば、再レンダリングを完全に避けられます。

静的プリレンダリング

同じルートの下にある匿名HTMLキャッシュ。