Statisk när det går
Förgenererade sidor och produktionsstandarder, angivna i blockstudio.json.
Förgenerera anonyma sidor
Statisk förgenerering är inaktiverad som standard. Aktivera performance.staticPrerender så lagrar Blockstudio hela HTML-dokumentet som en anonym besökare får, och svarar sedan nästa anonyma besökare från den kopian.
Förfrågningar som måste förbli live berör den aldrig: andra förfrågningar än GET, frågesträngar, admin, REST, Ajax, cron, flöden, sökning, förhandsvisningar, sidor med nonce, alla sökvägar under dynamicPaths och inloggade besökare om inte serveLoggedIn är aktiverat.
{
"performance": {
"staticPrerender": {
"enabled": true,
"ttl": 3600,
"earlyServe": true,
"dynamicPaths": ["/account", "/checkout"]
}
}
}<!-- blockstudio:no-cache -->
<p class="stock">
<?php echo esc_html( $a['label'] ); ?>
</p>Av som standard
Inget ändras förrän blockstudio.json anger funktionen.
Dynamiska sökvägar
En dynamisk sökväg /account omfattar /account/orders men inte /accounting.
Markör för undantag
En blockstudio:no-cache-kommentar håller alla svar utanför cachen.
Inloggade besökare
Med serveLoggedIn läser de lagrade sidor; deras egna sidor lagras aldrig.
Anpassad förbikoppling
Filtret static_prerender/request_bypass håller alla begäranden du anger, till exempel en med en kundvagnskaka, utanför lagrade sidor.
Uppvärmningskö
En beständig kö renderar om inaktuella sidor med det intervall du anger.
Långsvansade rutter
Även rutter som inte finns i den driftsatta kartan levereras tidigt, när WordPress har renderat och lagrat dem.
Kontroll av formatmall
En lagrad sida renderas om om dess länkade formatmall Tailwind saknas; den levereras aldrig utan format.
Levereras innan WordPress startar
När earlyServe är aktiverat installerar Blockstudio en advanced-cache.php-drop-in som strömmar en lagrad sida innan WordPress, tillägg eller temat läses in. Den skriver aldrig över en drop-in, en routningskarta eller en WP_CACHE-rad som den inte själv har skrivit.
Den här webbplatsen kör det. Den 8 oktober 2026 svarade blockstudio.dev-sidor med x-blockstudio-static-prerender: HIT-EARLY, rubriken som drop-in-modulen skickar.
# 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-EARLYUppdateras efter varje ändring
Standardläget signature fyller cachen vid en anonym cachemiss och uppdaterar den efter ändringar på webbplatsnivå. När ett inlägg sparas eller tas bort rensas det inlägget och startsidan från cachen, eller så köas de för omrendering när uppvärmning är aktiverad.
Läget graph är avsett för driftsättningsverktyg. Det registrerar vilka filer varje sida läste, så att en byggprocess bara renderar om de rutter vars filer ändrats och sedan aktiverar den nya uppsättningen som en enda artefakt. Om en refererad fil inte godkänns vid valideringen förblir den föregående artefakten aktiv.
När en artefakt installeras jämförs byte och ändrade dokument byts ut atomärt. last_promotion() rapporterar hur många rutter som befordrades, ersattes, hoppades över eller behölls, så att en driftsättning kan logga resultatet och jämföra det aktiva bygg-ID:t.
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();Bakom en CDN
Förhandsrenderingshuvudet anger redan vilka svar som är säkra att dela. Koppla HIT och HIT-EARLY till en livslängd på Cache-Control vid ursprungsservern, cachelagra bara svar som har en sådan och kringgå edge-cachen för kakorna wordpress_logged_in_, wp-postpass_ och comment_author_email_, din dynamicPaths, wp-admin och wp-json.
Sidor som cachelagras vid edge fortsätter att länka till den innehållshashade formatmall som de renderades med. Höj cache.namespaceGrace till den längsta tid en sådan kopia kan finnas kvar, så ligger de utgångna formatmallarna kvar på disken tills tiden löpt ut.
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"
}
}Ett aktivt block på en cachelagrad sida
Ange blockstudio.island till dynamic så får den cachelagrade sidan en platshållare i stället för blocket. Webbläsaren samlar in alla dynamiska öar på sidan och hämtar deras fragment i en enda samlad begäran. Varje fragment signeras med blocknamnet och dess tillåtna attribut.
hydrate behåller hela HTML på sidan och skickar bara en monteringshändelse. Dynamiska öar kan vänta tills de blir synliga, uppdateras när en fönsterhändelse inträffar och cachelagra fragment per användare eller globalt.
{
"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'));Se vart renderingstiden går
Lägg till ?blockstudio-perf i valfri URL i frontend så visar en panel renderingstider per block, antal anrop samt faserna transformering, mall och komponent. Samma tidsmätningar skickas som Server-Timing-headers, vilket fortfarande fungerar när en CDN cachelagrar HTML.
Endast inloggade användare med edit_posts ser resultatet, och alla andra begäranden stänger av profileraren vid init. performance.measurement lägger till headers för profil och konfigurationshash samt en Performance_Measurement::snapshot() API.
{
"dev": {
"perf": true
},
"performance": {
"measurement": {
"enabled": true,
"headers": true,
"timings": true
}
}
}use Blockstudio\Performance_Measurement;
$snapshot = Performance_Measurement::snapshot();En växel för produktionsstandarder
När performance.profile är inställt på speed tas generator-, emoji-, flödes- och upptäcktsutdata bort från head, oEmbed-upptäckt tas bort, XML-RPC och pingbacks inaktiveras, generella frontend-resurser från kärnan tas bort, Heartbeat begränsas utanför redigerare och länkar med samma ursprung förhämtas vid hovring eller fokus.
Standardvärdet är compat, vilket inte ändrar något. Varje barnvärde åsidosätter profilen, så att du kan behålla ett beteende och ändra resten.
{
"performance": {
"profile": "speed",
"preload": {
"links": "off"
}
}
}Bilder som behåller sitt utrymme
Temabilder finns utanför mediebiblioteket, så WordPress känner inte till deras storlek. bs_media_image() läser in de faktiska måtten från en genererad assets/media.json och reserverar bildförhållandet innan filen läses in.
Aktivera performance.media.lazy så väntar den riktiga URL bakom en platshållare med rätt storlek tills bilden närmar sig visningsområdet.
<?php
echo bs_media_image([
'src' => 'assets/images/hero.webp',
'alt' => 'Hero',
'eager' => true,
]);{
"performance": {
"media": {
"lazy": true,
"skeleton": true,
"metadata": true,
"rootMargin": "300px"
}
}
}En cachekatalog
Alla genererade filer finns under cache.path, sorterade efter en körningsidentitet.
Byggen med enkel flygning
En begäran bygger en kall cache-nyckel. Övriga väntar, återanvänder den senast fungerande nyttolasten eller får en 503 med Retry-After.
Nyttolaster anpassade för OPcache
Små nyttolaster i cachen är vanliga PHP-arrayer som OPcache kan återanvända från delat minne. Större nyttolaster förblir komprimerade.
Renderingscache
En själavslutande blocktagg med samma attribut renderas en gång per begäran. Upprepningar hämtas från minnet.
Samordnad uppdatering av val
En mängd innehållsskrivningar, till exempel en import, blir en enda uppdatering av cachelagrade ifyllda fältval.
Cache för flera klienter
Filtrera cache/site_key för din egen klientgräns och cache/context för körningsvarianter av samma webbplats.
Kompilerade tillgångar i cachen
När assets.output är inställt på cache lämnar kompilerade tillgångar blockträdet, så att driftsättningen kan göras från en oföränderlig utcheckning.
Uppdelade byggen
Static_Prerender_Batch_Renderer delar upp ett bygge i stabila N/TOTAL-delar, och den som anropar kan beräkna samma partition.
Infoga små formatmallar inline
assets.inlineLimit infogar de minsta blockformatmallarna inline inom en bytebudget och i samma kaskadordning.
Placera blocket CSS sist i head
Blocket CSS läggs till precis före den avslutande head-taggen, efter temats och tilläggens formatmallar.
Hoppa över oanvända tillgångar
En mall som inte returnerar något köar inga tillgångar. assets.enqueue false låter dig hantera alla tillgångar själv.
Cachekommandon
wp bs cache status, cleanup och clear granskar, tömmer och rensar körningscachen. wp bs prerender purge tar bort lagrade sidor.
Ren borttagning
wp bs teardown tar bara bort det tillstånd som den här installationen äger.
Resultatkrokar
cache/outcome och static_prerender/outcome rapporterar träffar, byggen, missar och fel till dina mätvärden.
Felhanterare
error/logged och error/exception vidarebefordrar Blockstudio fel till en extern loggtjänst eller spårare.
Batchrendering
Batch_Render::reset() rensar förfrågningstillståndet mellan dokument i samma process. render/dependencies listar varje blocks filer.
Det officiella tilläggspaketet
Premiumwebbplatsmallar, systeminstruktioner för AI och en privat Discord-community. Engångsköp, uppdateringar på livstid.
- 500+ webbplatsmallar
- AI-systeminstruktioner
- Uppdateringar livet ut
- Privat Discord-community