Перейти до вмісту

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

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

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

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

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

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

За замовчуванням вимкнено

Нічого не зміниться, доки blockstudio.json не вкаже цю функцію.

Динамічні шляхи

Динамічний шлях /account охоплює /account/orders, але не /accounting.

Маркер виключення

Коментар blockstudio:no-cache не дозволяє кешувати жодну відповідь.

Відвідувачі, які ввійшли в систему

З serveLoggedIn вони читають збережені сторінки; їхні власні сторінки ніколи не зберігаються.

Власне обходження кешу

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

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

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

Маршрути з низькою відвідуваністю

Маршрути поза розгорнутою картою також обслуговуються завчасно, щойно 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.

Термінал
# 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() повідомляє, скільки маршрутів було активовано, замінено, пропущено або залишено без змін, тож ці дані можна записати в журнал розгортання й порівняти ідентифікатор активного збирання.

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 до найдовшого часу життя такої копії, і старі таблиці стилів залишатимуться на диску до його завершення.

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 і надсилає лише подію монтування. Динамічні острови можуть чекати, доки стануть видимими, оновлюватися після події вікна й кешувати фрагменти для кожного користувача або глобально.

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.

blockstudio.json
{
  "dev": {
    "perf": true
  },
  "performance": {
    "measurement": {
      "enabled": true,
      "headers": true,
      "timings": true
    }
  }
}

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

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

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

blockstudio.json
{
  "performance": {
    "profile": "speed",
    "preload": {
      "links": "off"
    }
  }
}

Зображення, що зберігають місце

Зображення теми зберігаються поза медіатекою, тому WordPress нічого не знає про їхні розміри. bs_media_image() зчитує фактичні розміри зі згенерованого assets/media.json і резервує місце зі збереженням співвідношення сторін ще до завантаження файлу.

Увімкніть performance.media.lazy, і справжнє URL завантажиться після заповнювача правильного розміру, щойно зображення наблизиться до області перегляду.

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

Один каталог кешу

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

Збирання в одному потоці

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

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

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

Кеш рендерингу

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

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

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

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

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

Скомпільовані ресурси в кеші

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

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

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

Вбудовування малих таблиць стилів

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

Стилі блока CSS — останні в head

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

Пропускати невикористані ресурси

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

Команди кешу

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

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

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

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

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

Обробники помилок

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

Пакетне рендерення

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

Plus

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

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

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