# 可能な場合は静的に

プリレンダリングされたページと本番環境の既定値をblockstudio.jsonで設定できます。

## 匿名ページをプリレンダリング

静的プリレンダリングは既定で無効です。`performance.staticPrerender` を有効にすると、Blockstudioは匿名の訪問者に返される完全なHTMLドキュメントを保存し、次の匿名訪問者にはそのコピーを返します。

リアルタイム処理が必要なリクエストはキャッシュに触れません。非GETリクエスト、クエリ文字列、管理画面、REST、Ajax、cron、フィード、検索、プレビュー、nonce付きページ、`dynamicPaths` 以下のすべてのパス、さらに `serveLoggedIn` が有効でない場合のログインユーザーが対象です。

[静的プリレンダリング](https://blockstudio.dev/ja/docs/production/static-prerendering/)

blockstudio.json

```
{
  "performance": {
    "staticPrerender": {
      "enabled": true,
      "ttl": 3600,
      "earlyServe": true,
      "dynamicPaths": ["/account", "/checkout"]
    }
  }
}
```

## デフォルトではオフ

blockstudio.jsonで機能を指定するまで、何も変わりません。

## 動的パス

/accountの動的パスは/account/ordersには適用されますが、/accountingには適用されません。

## オプトアウトマーカー

blockstudio:no-cacheコメントがあると、どのレスポンスもキャッシュされません。

## ログイン中の訪問者

serveLoggedInを使うと保存済みページを読み込めます。訪問者自身のページが保存されることはありません。

## [カスタムバイパス](https://blockstudio.dev/ja/docs/blocks/hooks/php/#blockstudio-static_prerender-request_bypass)

static_prerender/request_bypassフィルターを使うと、カートCookie付きのリクエストなど、指定したリクエストを保存済みページの対象外にできます。

## ウォームアップキュー

永続キューが、設定した間隔で古いページを再レンダリングします。

## [ロングテールルート](https://blockstudio.dev/ja/docs/production/static-prerendering/#early-serving-and-atomic-deployment)

デプロイ済みマップにないルートも、WordPressがレンダリングして保存すると、早期に配信されます。

## スタイルシートの確認

リンク先のTailwindスタイルシートが見つからない保存済みページは、スタイルなしで配信されず、再レンダリングされます。

## WordPressの起動前に配信

`earlyServe` を有効にすると、Blockstudioは `advanced-cache.php` ドロップインをインストールし、WordPress、プラグイン、テーマの読み込み前に保存済みページをストリーム配信します。既存のドロップイン、ルートマップ、または自ら書き込んでいない `WP_CACHE` 行を上書きすることはありません。

このサイトでは稼働中です。2026年10月8日、blockstudio.devページは `x-blockstudio-static-prerender: HIT-EARLY` で応答しました。これはドロップインが送信するヘッダーです。

[早期配信](https://blockstudio.dev/ja/docs/production/static-prerendering/#early-serving-and-atomic-deployment)

ターミナル

```
# Identity, files, queue, and hit/miss counters
wp bs prerender status

# Re-render stale entries now
wp bs prerender warm

# Dead or orphaned early-serve map entries
wp bs prerender map status
wp bs prerender map prune --dry-run

# Remove the drop-in and map this install owns
wp bs teardown
```

## 変更のたびに最新状態へ

既定の `signature` モードでは、匿名アクセス時にキャッシュを生成し、サイト全体の変更後に更新します。投稿を保存または削除すると、その投稿とフロントページのキャッシュが消去されます。ウォームアップが有効な場合は、再レンダリングのキューに追加されます。

`graph` モードはデプロイツール向けです。各ページが読み込んだファイルを記録するため、ビルドでは変更されたファイルを使うルートだけを再レンダリングし、新しい一式を1つのアーティファクトとして有効化できます。参照先のファイルの検証に失敗した場合は、前のアーティファクトが引き続き稼働します。

アーティファクトのインストールではバイト列を比較し、変更されたドキュメントをアトミックに入れ替えます。`last_promotion()` は昇格、置換、スキップ、維持されたルートの数を報告するため、デプロイ時にログへ記録し、アクティブなビルドIDと比較できます。

[シグネチャモードとグラフモード](https://blockstudio.dev/ja/docs/production/static-prerendering/#signature-and-graph-modes)

deploy.php

```
use Blockstudio\Static_Prerender_Runtime;

$plan = Static_Prerender_Runtime::build_plan($sourceUrls);

foreach ($plan['affectedUrls'] as $url) {
  $result = render_with_dependencies($url);

  Static_Prerender_Runtime::persist_built_response(
    $url,
    $result['html'],
    $result['files'],
    $result['virtualHashes']
  );
}

Static_Prerender_Runtime::garbage_collect(array_keys($plan['live']));
```

## CDNの背後で

プリレンダーのヘッダーには、共有しても安全なレスポンスがすでに示されています。`HIT` と `HIT-EARLY` をオリジンでの `Cache-Control` 有効期間に対応付け、その情報があるものだけをキャッシュします。`wordpress_logged_in_`、`wp-postpass_`、`comment_author_email_` のCookie、`dynamicPaths`、`wp-admin`、`wp-json` についてはエッジをバイパスします。

エッジにキャッシュされたページは、レンダリング時に使われたコンテンツハッシュ付きスタイルシートへのリンクを保持します。`cache.namespaceGrace` をそのコピーの最長保持期間まで延ばすと、古いスタイルシートは有効期間が切れるまでディスク上に残ります。

[CDNのセットアップ](https://blockstudio.dev/ja/guides/static-prerendering/#putting-a-cdn-in-front)

nginx.conf

```
map $upstream_http_x_blockstudio_static_prerender $edge_cache_control {
  "~^HIT"  "public, s-maxage=604800";
  default  "";
}

location ~ \.php$ {
  include fastcgi_params;
  fastcgi_pass unix:/run/php/php-fpm.sock;
  add_header Cache-Control $edge_cache_control;
}
```

## キャッシュ済みページ上のライブブロック1つ

`blockstudio.island` を `dynamic` に設定すると、キャッシュ済みページにはブロックの代わりにプレースホルダーが配置されます。ブラウザーはページ上のすべての動的アイランドを収集し、ブロック名と許可リストに登録された属性でそれぞれ署名されたフラグメントを、1回のバッチリクエストで取得します。

`hydrate` はページ内にHTML全体を保持し、マウントイベントだけを送信します。動的アイランドは表示されるまで待機したり、ウィンドウイベントの発生時に更新したり、ユーザー別またはグローバルにフラグメントをキャッシュしたりできます。

[ブロックアイランド](https://blockstudio.dev/ja/docs/blocks/islands/)

block.json

```
{
  "name": "acme/cart-count",
  "title": "Cart count",
  "blockstudio": {
    "island": {
      "mode": "dynamic",
      "attributes": ["productId"],
      "loading": "visible",
      "event": "cart:updated",
      "cache": {
        "ttl": 60,
        "per": "user"
      }
    }
  }
}
```

## レンダリング時間の内訳を確認

`?blockstudio-perf` をフロントエンドの任意のURLに追加すると、ブロックごとのレンダリング時間、呼び出し回数、変換、テンプレート、コンポーネントの各フェーズをパネルに表示します。同じ計測結果は `Server-Timing` ヘッダーとして送信されるため、CDNがHTMLをキャッシュする場合でも機能します。

`edit_posts` を持つログインユーザーだけが出力を確認でき、それ以外のすべてのリクエストでは `init` でプロファイラーが無効になります。`performance.measurement` はプロファイルと設定ハッシュのヘッダー、および `Performance_Measurement::snapshot()` APIを追加します。

[プロファイラー](https://blockstudio.dev/ja/docs/production/performance/#profiler)

blockstudio.json

```
{
  "dev": {
    "perf": true
  },
  "performance": {
    "measurement": {
      "enabled": true,
      "headers": true,
      "timings": true
    }
  }
}
```

## 本番環境の既定値を1つの切り替えで設定

`performance.profile` を `speed` に設定すると、head内のgenerator、絵文字、フィード、検出用出力を削除し、oEmbed検出を除去し、XML-RPCとpingbackを無効にし、コアの一般的なフロントエンドアセットを削除します。また、エディター外ではHeartbeatを抑制し、ホバーまたはフォーカス時に同一オリジンのリンクを先読みします。

既定値は `compat` で、何も変更しません。各子値はプロファイルの設定を上書きするため、残りの設定を適用しながら、特定の動作だけを維持できます。

[パフォーマンスプロファイル](https://blockstudio.dev/ja/docs/production/performance/#performance-profiles)

blockstudio.json

```
{
  "performance": {
    "profile": "speed",
    "preload": {
      "links": "off"
    }
  }
}
```

## 画像の表示領域を確保

テーマ画像はメディアライブラリの外部にあるため、WordPressは画像のサイズを把握できません。`bs_media_image()` は生成された `assets/media.json` から実際の寸法を読み取り、ファイルの読み込み前にアスペクト比に応じた表示領域を確保します。

`performance.media.lazy` を有効にすると、実際のURLは、画像がビューポートに近づくまで、適切なサイズのプレースホルダーの背後で待機します。

[メディア](https://blockstudio.dev/ja/docs/production/media/)

index.php

```
<?php
echo bs_media_image([
  'src' => 'assets/images/hero.webp',
  'alt' => 'Hero',
  'eager' => true,
]);
```

## [キャッシュディレクトリは1つ](https://blockstudio.dev/ja/docs/production/caching/)

生成されたすべてのファイルはcache.pathの下に保存され、実行時の識別子をキーとして使います。

## [ビルドの単一実行](https://blockstudio.dev/ja/docs/production/caching/#concurrency-and-retention)

1件のリクエストがキャッシュにないキーをビルドします。他のリクエストは待機するか、最後に正常だったペイロードを再利用するか、Retry-After付きの503を受け取ります。

## OPcache対応ペイロード

小さなキャッシュペイロードは、OPcacheが共有メモリから再利用できるプレーンなPHP配列です。大きなものは圧縮されたまま保持されます。

## [レンダーキャッシュ](https://blockstudio.dev/ja/docs/production/performance/#render-cache)

同じ属性を持つ自己終了型ブロックタグは、リクエストごとに1回だけレンダリングされます。繰り返し分はメモリから取得されます。

## 選択肢の更新を集約

インポートなどでコンテンツの書き込みが集中しても、キャッシュ済みの入力済みフィールド選択肢の更新は1回にまとめられます。

## マルチテナントキャッシュ

独自のテナント境界にはcache/site_keyを、同じサイトの実行時バリエーションにはcache/contextをフィルタリングします。

## [キャッシュ内のコンパイル済みアセット](https://blockstudio.dev/ja/docs/general/settings/#assets)

assets.outputをcacheに設定すると、コンパイル済みアセットがブロックツリーの外に置かれるため、変更不可能なチェックアウトからデプロイできます。

## シャード分割ビルド

Static_Prerender_Batch_Rendererはビルドを安定したN/TOTALシャードに分割し、呼び出し側も同じパーティションを計算できます。

## [小さなスタイルシートをインライン化](https://blockstudio.dev/ja/docs/blocks/assets/registering/#inline-small-stylesheets)

assets.inlineLimitはバイト数の上限内で、最小サイズのブロックスタイルシートを同じカスケード順でインライン出力します。

## [ブロックCSSをheadの最後に](https://blockstudio.dev/ja/docs/blocks/assets/registering/#load-order)

ブロックCSSは、テーマとプラグインのスタイルシートの後に、閉じるheadタグの直前に追加されます。

## [未使用のアセットをスキップ](https://blockstudio.dev/ja/docs/blocks/assets/registering/#disable-enqueuing)

テンプレートが何も返さない場合、アセットはエンキューされません。assets.enqueueをfalseにすると、すべてのアセットを自分で管理できます。

## [キャッシュコマンド](https://blockstudio.dev/ja/docs/dev/cli/)

wp bs cache status、cleanup、clearは実行時キャッシュを調査、排出、消去します。wp bs prerender purgeは保存済みページを削除します。

## クリーンなアンインストール

wp bs teardownは、このインストールが所有する状態のみを削除します。

## 結果フック

cache/outcome と static_prerender/outcome は、ヒット数、ビルド数、ミス数、失敗数をメトリクスに報告します。

## [エラーフック](https://blockstudio.dev/ja/docs/blocks/hooks/php/#error-handling)

error/logged と error/exception は、Blockstudioエラーを外部ロガーまたはトラッカーに転送します。

## [バッチレンダリング](https://blockstudio.dev/ja/docs/production/performance/#in-process-batch-rendering)

Batch_Render::reset()は、1つのプロセス内でドキュメントごとにリクエスト状態をクリアします。render/dependencies は各ブロックのファイルを一覧表示します。

Plus

## 公式拡張キット

プレミアムサイトテンプレート、AIシステム指示、会員限定Discordコミュニティ。買い切りで、アップデートは生涯無料です。

- 500+のサイトテンプレート
- AIシステム向け指示
- 無期限アップデート
- 非公開Discordコミュニティ

[Plusを入手](https://blockstudio.dev/ja/plus/)
