Статика, когда это возможно
Предварительная генерация страниц и настройки для рабочей среды задаются в blockstudio.json.
Предварительно генерируйте страницы для анонимных посетителей
Статическая предварительная генерация по умолчанию выключена. Включите performance.staticPrerender, и Blockstudio будет сохранять полный документ HTML, который получает анонимный посетитель, а затем отправлять его копию следующему анонимному посетителю.
Запросы, которые должны обрабатываться динамически, не затрагиваются: запросы не типа GET, строки запроса, панель администратора, REST, Ajax, cron, ленты, поиск, предпросмотр, страницы с nonce, все пути в dynamicPaths и авторизованные посетители, если не включен serveLoggedIn.
{
"performance": {
"staticPrerender": {
"enabled": true,
"ttl": 3600,
"earlyServe": true,
"dynamicPaths": ["/account", "/checkout"]
}
}
}<!-- blockstudio:no-cache -->
<p class="stock">
<?php echo esc_html( $a['label'] ); ?>
</p>По умолчанию выключено
Ничего не меняется, пока 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 teardowncurl -sI https://blockstudio.dev/ | grep -i x-blockstudio
# x-blockstudio-static-prerender: HIT-EARLYОбновляется после каждого изменения
Режим signature по умолчанию заполняет кэш при первом запросе от анонимного пользователя и обновляет его после изменений на уровне сайта. Сохранение или удаление записи очищает ее страницу и главную страницу либо ставит их в очередь на повторный рендеринг, если включен предварительный прогрев.
Режим graph предназначен для инструментов развёртывания. Он записывает, какие файлы читала каждая страница, поэтому при сборке повторно отображаются только маршруты, чьи файлы изменились, а затем новый набор активируется как единый артефакт. Если проверка ссылочного файла не пройдена, предыдущий артефакт остаётся активным.
При установке артефакта сравниваются байты, а изменённые документы заменяются атомарно. last_promotion() сообщает, сколько маршрутов было активировано, заменено, пропущено или сохранено, чтобы развёртывание могло записать это в журнал и сравнить с ID активной сборки.
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']));use Blockstudio\Static_Prerender_Early_Serve;
use Blockstudio\Static_Prerender_Runtime;
$entry = Static_Prerender_Runtime::artifact_entry($targetUrls);
Static_Prerender_Early_Serve::install_artifact_entry(
$entry,
Static_Prerender_Runtime::cache_root_path()
);
$counts = Static_Prerender_Early_Serve::last_promotion();За CDN
В заголовке предварительно отрисованной страницы уже указано, какими ответами можно безопасно делиться. Настройте для HIT и HIT-EARLY срок действия Cache-Control на исходном сервере, кэшируйте только ответы с таким сроком и обходите пограничный узел для cookie wordpress_logged_in_, wp-postpass_ и comment_author_email_, а также для ваших dynamicPaths, wp-admin и wp-json.
Страницы, кэшированные на пограничном узле, продолжают ссылаться на таблицу стилей с хешем содержимого, с которой они были отрисованы. Установите для cache.namespaceGrace максимальный срок хранения такой копии, и устаревшие таблицы стилей останутся на диске до его истечения.
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;
}{
"cache": {
"namespaceGrace": 777600
},
"tailwind": {
"enabled": true,
"output": "link"
}
}Один активный блок на кэшированной странице
Установите для blockstudio.island значение dynamic, и вместо блока кэшированная страница будет содержать заполнитель. Браузер соберёт все динамические островки на странице и запросит их фрагменты одним пакетом; каждый запрос будет подписан именем блока и атрибутами из списка разрешённых.
hydrate сохраняет весь HTML на странице и отправляет только событие монтирования. Динамические островки могут ждать появления в области видимости, обновляться при срабатывании события окна и кэшировать фрагменты для отдельного пользователя или глобально.
{
"name": "acme/cart-count",
"title": "Cart count",
"blockstudio": {
"island": {
"mode": "dynamic",
"attributes": ["productId"],
"loading": "visible",
"event": "cart:updated",
"cache": {
"ttl": 60,
"per": "user"
}
}
}
}<div class="cart-count-placeholder">
Loading cart...
</div>window.dispatchEvent(new Event('cart:updated'));Узнайте, на что уходит время отрисовки
Добавьте ?blockstudio-perf к любому URL на стороне клиента, и панель покажет время отрисовки и количество вызовов для каждого блока, а также этапы преобразования, шаблона и компонента. Эти же замеры передаются в заголовках Server-Timing, которые продолжают работать, даже если CDN кэширует HTML.
Результат видят только вошедшие в систему пользователи с edit_posts; для всех остальных запросов профилировщик отключается на этапе init. performance.measurement добавляет заголовки с хешами профиля и конфигурации, а также Performance_Measurement::snapshot() API.
{
"dev": {
"perf": true
},
"performance": {
"measurement": {
"enabled": true,
"headers": true,
"timings": true
}
}
}use Blockstudio\Performance_Measurement;
$snapshot = Performance_Measurement::snapshot();Один переключатель для настроек по умолчанию в рабочей среде
Если для performance.profile задано значение speed, из head удаляются данные генератора, эмодзи, ленты и обнаружения, отключается обнаружение oEmbed, отключаются XML-RPC и pingbacks, удаляются стандартные фронтенд-ресурсы ядра, ограничивается частота Heartbeat вне редакторов и выполняется предварительная загрузка ссылок того же источника при наведении или фокусе.
По умолчанию задано compat, и это ничего не меняет. Каждое дочернее значение переопределяет профиль, поэтому можно сохранить одно поведение, отказавшись от остальных.
{
"performance": {
"profile": "speed",
"preload": {
"links": "off"
}
}
}Изображения, для которых заранее выделено место
Изображения темы находятся вне медиатеки, поэтому WordPress ничего не знает об их размерах. bs_media_image() считывает реальные размеры из созданного assets/media.json и резервирует место с правильным соотношением сторон до загрузки файла.
Включите performance.media.lazy, и настоящее URL будет ждать за заполнителем правильного размера, пока изображение не приблизится к области просмотра.
<?php
echo bs_media_image([
'src' => 'assets/images/hero.webp',
'alt' => 'Hero',
'eager' => true,
]);{
"performance": {
"media": {
"lazy": true,
"skeleton": true,
"metadata": true,
"rootMargin": "300px"
}
}
}Один каталог кэша
Все созданные файлы хранятся в 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 перечисляет файлы каждого блока.
Официальный набор расширений
Премиум-шаблоны сайтов, системные инструкции для ИИ и закрытое сообщество Discord. Разовая покупка, обновления навсегда.
- 500+ шаблонов сайтов
- Системные инструкции для ИИ
- Пожизненные обновления
- Закрытое сообщество Discord