Статично, когато е възможно
Предварително генерирани страници и продукционни настройки по подразбиране, зададени в 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 изключва от съхранените страници всяка заявка, която посочите, например заявка с бисквитка за количка.
Опашка за предварително затопляне
Надеждна опашка генерира отново остарелите страници през зададения от вас интервал.
Маршрути с малък трафик
Маршрутите извън картата на внедрената версия също се обслужват предварително, след като 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() отчита колко маршрута са повишени, заменени, пропуснати или запазени, за да може внедряването да запише това в журнал и да го сравни с идентификатора на активната компилация.
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 на първоначалния сървър, кеширайте само отговорите с такъв срок и заобикаляйте периферния кеш при наличие на бисквитките 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 от заглавната част се премахват изходните данни за генератора, емоджитата, информационните канали и откриването; премахва се откриването на oEmbed; деактивират се XML-RPC и pingback заявките; премахват се общите ресурси на ядрото за предната част на сайта; ограничава се 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, след стиловите таблици на темата и добавките.
Пропускане на неизползваните ресурси
Шаблон, който не връща нищо, не добавя ресурси към опашката. Задайте assets.enqueue на false, за да управлявате всички ресурси сами.
Команди за кеша
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 показва файловете за всеки блок.
Официалният комплект за разширения
Премиум шаблони за сайтове, системни инструкции за AI и частна общност в Discord. Еднократна покупка, актуализации за цял живот.
- 500+ шаблона за сайтове
- Системни инструкции за AI
- Актуализации за целия период
- Частна общност на Discord