# Статика, когда это возможно

Предварительная генерация страниц и настройки для рабочей среды задаются в blockstudio.json.

## Предварительно генерируйте страницы для анонимных посетителей

Статическая предварительная генерация по умолчанию выключена. Включите `performance.staticPrerender`, и Blockstudio будет сохранять полный документ HTML, который получает анонимный посетитель, а затем отправлять его копию следующему анонимному посетителю.

Запросы, которые должны обрабатываться динамически, не затрагиваются: запросы не типа GET, строки запроса, панель администратора, REST, Ajax, cron, ленты, поиск, предпросмотр, страницы с nonce, все пути в `dynamicPaths` и авторизованные посетители, если не включен `serveLoggedIn`.

[Статическая предварительная генерация](https://blockstudio.dev/ru/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/ru/docs/blocks/hooks/php/#blockstudio-static_prerender-request_bypass)

Фильтр static_prerender/request_bypass исключает из числа кэшируемых страниц любые указанные вами запросы, например запросы с cookie корзины.

## Очередь прогрева

Надежная очередь повторно рендерит устаревшие страницы с заданным вами интервалом.

## [Длинный хвост маршрутов](https://blockstudio.dev/ru/docs/production/static-prerendering/#early-serving-and-atomic-deployment)

Маршруты за пределами развёрнутой карты тоже обслуживаются заранее после того, как WordPress отрисовал и сохранил их.

## Проверка таблиц стилей

Если у сохранённой страницы отсутствует связанная таблица стилей Tailwind, страница отрисовывается заново и никогда не отдаётся без стилей.

## Отдается до запуска WordPress

Если включен `earlyServe`, Blockstudio устанавливает drop-in `advanced-cache.php`, который передает сохраненную страницу до загрузки WordPress, плагинов или темы. Он никогда не перезаписывает drop-in, карту маршрутов или строку `WP_CACHE`, которую не создавал.

Этот сайт использует его. 8 октября страницы 2026 blockstudio.dev ответили с `x-blockstudio-static-prerender: HIT-EARLY` — заголовком, который отправляет drop-in.

[Ранняя отдача](https://blockstudio.dev/ru/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` предназначен для инструментов развёртывания. Он записывает, какие файлы читала каждая страница, поэтому при сборке повторно отображаются только маршруты, чьи файлы изменились, а затем новый набор активируется как единый артефакт. Если проверка ссылочного файла не пройдена, предыдущий артефакт остаётся активным.

При установке артефакта сравниваются байты, а изменённые документы заменяются атомарно. `last_promotion()` сообщает, сколько маршрутов было активировано, заменено, пропущено или сохранено, чтобы развёртывание могло записать это в журнал и сравнить с ID активной сборки.

[Режимы подписи и графа](https://blockstudio.dev/ru/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` на исходном сервере, кэшируйте только ответы с таким сроком и обходите пограничный узел для cookie `wordpress_logged_in_`, `wp-postpass_` и `comment_author_email_`, а также для ваших `dynamicPaths`, `wp-admin` и `wp-json`.

Страницы, кэшированные на пограничном узле, продолжают ссылаться на таблицу стилей с хешем содержимого, с которой они были отрисованы. Установите для `cache.namespaceGrace` максимальный срок хранения такой копии, и устаревшие таблицы стилей останутся на диске до его истечения.

[Настройка CDN](https://blockstudio.dev/ru/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;
}
```

## Один активный блок на кэшированной странице

Установите для `blockstudio.island` значение `dynamic`, и вместо блока кэшированная страница будет содержать заполнитель. Браузер соберёт все динамические островки на странице и запросит их фрагменты одним пакетом; каждый запрос будет подписан именем блока и атрибутами из списка разрешённых.

`hydrate` сохраняет весь HTML на странице и отправляет только событие монтирования. Динамические островки могут ждать появления в области видимости, обновляться при срабатывании события окна и кэшировать фрагменты для отдельного пользователя или глобально.

[Островки блоков](https://blockstudio.dev/ru/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/ru/docs/production/performance/#profiler)

blockstudio.json

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

## Один переключатель для настроек по умолчанию в рабочей среде

Если для `performance.profile` задано значение `speed`, из head удаляются данные генератора, эмодзи, ленты и обнаружения, отключается обнаружение oEmbed, отключаются XML-RPC и pingbacks, удаляются стандартные фронтенд-ресурсы ядра, ограничивается частота Heartbeat вне редакторов и выполняется предварительная загрузка ссылок того же источника при наведении или фокусе.

По умолчанию задано `compat`, и это ничего не меняет. Каждое дочернее значение переопределяет профиль, поэтому можно сохранить одно поведение, отказавшись от остальных.

[Профили производительности](https://blockstudio.dev/ru/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/ru/docs/production/media/)

index.php

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

## [Один каталог кэша](https://blockstudio.dev/ru/docs/production/caching/)

Все созданные файлы хранятся в cache.path и индексируются по идентификатору среды выполнения.

## [Сборки в один поток](https://blockstudio.dev/ru/docs/production/caching/#concurrency-and-retention)

Один запрос создаёт кэш для отсутствующего ключа. Остальные ждут, используют последнюю рабочую нагрузку или получают 503 с заголовком Retry-After.

## Нагрузки с учётом OPcache

Небольшие данные кэша — это обычные массивы PHP, которые OPcache может повторно использовать из общей памяти. Более крупные данные остаются сжатыми.

## [Кэширование отрисовки](https://blockstudio.dev/ru/docs/production/performance/#render-cache)

Самозакрывающийся тег блока с теми же атрибутами отрисовывается один раз за запрос. Повторные вызовы используют данные из памяти.

## Объединённое обновление вариантов выбора

При массовой записи содержимого, например во время импорта, кэшированные варианты выбора для заполненных полей обновляются один раз.

## Кэши для нескольких арендаторов

Используйте фильтры cache/site_key для изоляции собственных арендаторов, а cache/context — для вариантов среды выполнения одного и того же сайта.

## [Скомпилированные ресурсы в кэше](https://blockstudio.dev/ru/docs/general/settings/#assets)

Если для assets.output задано значение cache, скомпилированные ресурсы удаляются из дерева блоков, чтобы развёртывание выполнялось из неизменяемой рабочей копии.

## Сборки с разделением на сегменты

Static_Prerender_Batch_Renderer разбивает сборку на стабильные сегменты N/TOTAL, а вызывающая сторона может вычислить такое же разбиение.

## [Встраивание небольших таблиц стилей](https://blockstudio.dev/ru/docs/blocks/assets/registering/#inline-small-stylesheets)

assets.inlineLimit встраивает самые маленькие таблицы стилей блоков в пределах бюджета байтов, сохраняя тот же порядок каскада.

## [Разместить CSS блока в конце head](https://blockstudio.dev/ru/docs/blocks/assets/registering/#load-order)

CSS блока добавляется непосредственно перед закрывающим тегом head, после таблиц стилей темы и плагинов.

## [Не загружать неиспользуемые ресурсы](https://blockstudio.dev/ru/docs/blocks/assets/registering/#disable-enqueuing)

Шаблон, который ничего не возвращает, не ставит ресурсы в очередь. Значение false для assets.enqueue передаёт все ресурсы под ваш контроль.

## [Команды кэша](https://blockstudio.dev/ru/docs/dev/cli/)

Команды wp bs cache status, cleanup и clear позволяют просматривать, очищать и сбрасывать кэш среды выполнения. Команда wp bs prerender purge удаляет сохранённые страницы.

## Чистое удаление

wp bs teardown удаляет только состояние, принадлежащее этой установке.

## Хуки результатов

Отчёты cache/outcome и static_prerender/outcome показывают количество обращений, сборок, промахов и сбоев для ваших метрик.

## [Обработчики ошибок](https://blockstudio.dev/ru/docs/blocks/hooks/php/#error-handling)

error/logged и error/exception передают ошибки Blockstudio внешнему журналу или системе отслеживания.

## [Пакетный рендеринг](https://blockstudio.dev/ru/docs/production/performance/#in-process-batch-rendering)

Batch_Render::reset() очищает состояние запроса между документами в одном процессе. render/dependencies перечисляет файлы каждого блока.

Plus

## Официальный набор расширений

Премиум-шаблоны сайтов, системные инструкции для ИИ и закрытое сообщество Discord. Разовая покупка, обновления навсегда.

- 500+ шаблонов сайтов
- Системные инструкции для ИИ
- Пожизненные обновления
- Закрытое сообщество Discord

[Получить Plus](https://blockstudio.dev/ru/plus/)
