Hoppa till innehåll

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.

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

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.

Terminal
# 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

Uppdateras 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.

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']));

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.

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;
}

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.

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"
      }
    }
  }
}

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.

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

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.

blockstudio.json
{
  "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.

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

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.

Plus

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