# Статично, коли це можливо

Попередньо відрендерені сторінки й типові параметри виробничого середовища задаються в blockstudio.json.

## Попередньо рендерте анонімні сторінки

Статичний попередній рендеринг типово вимкнено. Увімкніть `performance.staticPrerender`, і Blockstudio зберігатиме повний документ HTML, який отримує анонімний відвідувач, а потім надаватиме його копію наступному анонімному відвідувачу.

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

[Статичний попередній рендеринг](https://blockstudio.dev/uk/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/uk/docs/blocks/hooks/php/#blockstudio-static_prerender-request_bypass)

Фільтр static_prerender/request_bypass не дозволяє зберігати сторінки для будь-яких указаних вами запитів, наприклад запиту з файлом cookie кошика.

## Черга попереднього рендерингу

Надійна черга повторно рендерить застарілі сторінки з установленим вами інтервалом.

## [Маршрути з низькою відвідуваністю](https://blockstudio.dev/uk/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/uk/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()` повідомляє, скільки маршрутів було активовано, замінено, пропущено або залишено без змін, тож ці дані можна записати в журнал розгортання й порівняти ідентифікатор активного збирання.

[Режими підписів і графа](https://blockstudio.dev/uk/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/uk/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/uk/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/uk/docs/production/performance/#profiler)

blockstudio.json

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

## Один перемикач для типових параметрів виробничого середовища

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

Типове значення — `compat`, яке нічого не змінює. Кожне дочірнє значення перевизначає профіль, тож ви можете зберегти одну поведінку, застосувавши решту налаштувань профілю.

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

index.php

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

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

Кожен згенерований файл зберігається в cache.path з ключем на основі ідентифікатора середовища виконання.

## [Збирання в одному потоці](https://blockstudio.dev/uk/docs/production/caching/#concurrency-and-retention)

Один запит створює ключ для холодного кешу. Інші чекають, повторно використовують останні коректні дані або отримують 503 із заголовком Retry-After.

## Корисні для OPcache дані

Невеликі дані кешу — це звичайні масиви PHP, які OPcache може повторно використовувати зі спільної пам’яті. Більші дані залишаються стиснутими.

## [Кеш рендерингу](https://blockstudio.dev/uk/docs/production/performance/#render-cache)

Блок із тегом, що закривається самостійно, і тими самими атрибутами відрендерюється один раз на запит. Повторні виклики використовують дані з пам’яті.

## Об’єднане оновлення варіантів

Пакетні зміни вмісту, наприклад імпорт, запускають одне оновлення кешованих заповнених варіантів полів.

## Кеші для кількох клієнтів

Використовуйте фільтр cache/site_key, щоб визначити межу власного клієнта, а cache/context — для варіантів середовища виконання того самого сайту.

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

Якщо для assets.output задано значення cache, скомпільовані ресурси вилучаються з дерева блоків, тож розгортання виконується з незмінної копії.

## Розподілені збирання

Static_Prerender_Batch_Renderer розбиває збирання на стабільні частини N/TOTAL, і той, хто викликає його, може обчислити такий самий розподіл.

## [Вбудовування малих таблиць стилів](https://blockstudio.dev/uk/docs/blocks/assets/registering/#inline-small-stylesheets)

assets.inlineLimit вбудовує найменші таблиці стилів блоків у межах бюджету байтів, дотримуючись того самого порядку каскаду.

## [Стилі блока CSS — останні в head](https://blockstudio.dev/uk/docs/blocks/assets/registering/#load-order)

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

## [Пропускати невикористані ресурси](https://blockstudio.dev/uk/docs/blocks/assets/registering/#disable-enqueuing)

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

## [Команди кешу](https://blockstudio.dev/uk/docs/dev/cli/)

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

## Чисте видалення

wp bs teardown видаляє лише стан, створений цією інсталяцією.

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

Звіти cache/outcome і static_prerender/outcome фіксують звернення, збірки, промахи та помилки для ваших метрик.

## [Обробники помилок](https://blockstudio.dev/uk/docs/blocks/hooks/php/#error-handling)

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

## [Пакетне рендерення](https://blockstudio.dev/uk/docs/production/performance/#in-process-batch-rendering)

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

Plus

## Офіційний набір розширень

Преміумшаблони сайтів, системні інструкції для ШІ та приватна спільнота Discord. Одноразова покупка, довічні оновлення.

- Понад 500 шаблонів сайтів
- Системні інструкції для ШІ
- Оновлення назавжди
- Приватна спільнота Discord

[Отримати Plus](https://blockstudio.dev/uk/plus/)
