Servera WordPress som statisk HTML
De flesta sidor på en marknadsföringswebbplats eller dokumentationswebbplats ser likadana ut för alla anonyma besökare. WordPress startar ändå, läser in alla tillägg, kör temat och renderar blocken för varje begäran. Ett sidcachetillägg kan hjälpa, men det innebär ytterligare en rörlig del med egna regler för vad som är säkert att lagra.
Blockstudio har en inbyggd statisk förgenerering som du kan välja att aktivera. Den lagrar fullständiga HTML-dokument för anonyma besökare i en egen cachekatalog och kan, om du tillåter det, servera dem från ett advanced-cache.php-tillägg före start av WordPress. Allt konfigureras i blockstudio.json.
Den här guiden visar steg för steg hur du aktiverar funktionen, kontrollerar vad som cachelagras och inte, förklarar den enda regeln som skyddar inloggade besökare och avslutas med en CDN-konfiguration som bara cachelagrar sådant som ursprunget markerar som cachelagringsbart.
Så hanteras en begäran
När förgenereringen är aktiverad hanteras en berättigad begäran på ett av tre sätt:
- Tidig träff. Tillägget hittar ett lagrat dokument i sin sökvägskarta och strömmar det innan WordPress läses in. Svaret innehåller
X-Blockstudio-Static-Prerender: HIT-EARLY. - Träff. WordPress startar, och vid
template_redirecthittar Blockstudio ett färskt lagrat dokument och skickar det i stället för att rendera mallen. Svaret innehållerX-Blockstudio-Static-Prerender: HIT. - Miss. WordPress renderar sidan som vanligt. Om besökaren är anonym och resultatet är ett fullständigt HTML-dokument med status 200, lagrar Blockstudio det inför nästa begäran.
Begäranden som inte är berättigade berör aldrig cachen.
Steg 1: Aktivera profilen och cachen
Börja med prestandaprofilen och förgenereringen, men låt tidig servering vara avstängd:
{
"$schema": "https://blockstudio.dev/schema/blockstudio",
"performance": {
"profile": "speed",
"staticPrerender": {
"enabled": true,
"ttl": 86400,
"earlyServe": false,
"dynamicPaths": ["/account", "/checkout", "/login"],
"warm": {
"enabled": true,
"interval": 900,
"concurrency": 4
}
}
}
}
Vad varje del gör:
profile: "speed"aktiverar standardinställningarna för produktionsfrontend: onödigt innehåll i sidhuvudet, oEmbed-identifiering, XML-RPC och generiska kärnresurser för frontenden tas bort, och länkar på samma ursprung hämtas i förväg när användaren visar avsikt. Börja med att testa inställningen som tar bort kärnresurser för frontenden, eftersom sidor som är beroende av dem då kan gå sönder på ett synligt sätt. Alla underordnade värden åsidosätter profilen.staticPrerender.enabledregistrerar körningsmiljön. Så länge den ärfalseskapar funktionen inga filer och registrerar inga krokar för begäranden.ttlär den maximala åldern för ett lagrat dokument i sekunder (standardvärde86400).dynamicPathslistar sökvägsprefix som alltid måste renderas i realtid.warmschemalägger en bakgrundsuppvärmare som renderar inaktuella offentliga URL:er på nytt varintervalsekund.
Raden $schema omfattar alla nycklar, så en redigerare med stöd för schemat JSON flaggar fel som "ttl": 0 (minimivärdet är 1).
Steg 2: Ta reda på vad som är berättigat
Blockstudio är försiktig med vad den lagrar. Följande begäranden går alltid förbi cachen:
- allt annat än
GET - alla URL med en frågesträng
wp-admin,wp-json,wp-login.php,xmlrpc.php, Ajax och cron- flöden, sökningar och förhandsgranskningssökvägar
- begäranden med ett
X-WP-Nonce-huvud - sökvägar under
dynamicPaths - besökare med en
wordpress_logged_in_*-,wp-postpass_*– ellercomment_author_email_*-cookie, om inteserveLoggedInär aktiverat
Dynamiska sökvägar matchas vid sökvägsgränser. Med konfigurationen ovan:
| Begäran | Förbigången |
|---|---|
/pricing/ |
nej |
/account/orders/ |
ja |
/accounting/ |
nej |
/checkout |
ja |
/pricing/?utm_source=x |
ja |
/blog/feed/ |
ja |
Bara fullständiga dokument sparas: svaret måste börja med <!doctype html eller <html, ha status 200 och får inte innehålla markören för att välja bort lagring. En mall som aldrig ska lagras kan skriva ut markören var som helst på sidan:
<!-- blockstudio:no-cache -->
Felsidor lagras aldrig, så en temaanpassad 404 kan aldrig återges som ett lyckat svar.
Steg 3: Kontrollera träffar
Besök några sidor i ett privat fönster och fråga sedan Blockstudio vad som finns lagrat:
wp bs prerender status
{
"enabled": true,
"invalidate": "signature",
"identity": "e6cdd3fcda14ad6ded85a763bd01a33b",
"cacheRoot": ".../wp-content/blockstudio/cache/sites/.../static-prerender",
"files": 0,
"bytes": 0,
"records": 0,
"queue": {
"pending": 0,
"processing": 0,
"done": 0,
"unique": 0,
"bytes": 0
},
...
"diagnostics": []
}
files och bytes växer i takt med att dokument lagras, queue visar uppvärmarens kö och diagnostics innehåller räknare per omfattning för träffar, missar, byggen och fel. Om du vill kontrollera en enskild sida begär du den två gånger som anonym besökare och letar efter huvudet:
curl -s -o /dev/null -D - https://example.com/pricing/ | grep -i x-blockstudio-static-prerender
Det andra svaret innehåller X-Blockstudio-Static-Prerender: HIT. Använd en GET som ovan: curl -I skickar en begäran med HEAD, som alltid går förbi cachen.
Steg 4: Servera innan WordPress startar
När träffarna ser rätt ut ställer du in "earlyServe": true. Blockstudio hanterar då tre små delar av tillståndet: ett wp-content/advanced-cache.php-tillägg, en gemensam wp-content/blockstudio-static-prerender-map.php-sökvägskarta och en deklaration WP_CACHE i wp-config.php. De installeras vid nästa adminbegäran.
Några regler gör detta säkert på delad värdtjänst och i multisite:
- Blockstudio skriver aldrig över en drop-in-komponent, karta eller
WP_CACHE-rad som den inte äger. Om ett annat cachetillägg redan ägeradvanced-cache.phpförblir tidig leverans inaktiverad. - Om
WP_CACHEredan har definierats somtruelämnaswp-config.phporörd. På webbhotell därwp-config.phpinte är skrivbar definierar du den själv. - Innan leverans kontrollerar både drop-in-komponenten och sökvägen PHP att den innehållshashade stilmallen Tailwind som dokumentet länkar till fortfarande finns. Om den saknas skickas begäran till WordPress i stället för att levereras utan stilmall.
- Poster i Multisite delar en karta men isoleras efter värd, sökväg till startsidan och webbplats-ID.
- Svarshuvuden som anges i
replayHeaders,Linksom standard, lagras med varje dokument och skickas igen vid varje träff, så ettLink-huvud som en sida skickar medheader()finns kvar vid tidig leverans. Cookie- och cachehuvuden återspelas aldrig.
Tidig leverans medför X-Blockstudio-Static-Prerender: HIT-EARLY. Om earlyServe eller enabled stängs av tas det tillstånd bort som Blockstudio äger, och wp bs teardown tar uttryckligen bort det för Composer-installationer som saknar en avaktiveringshook.
Inloggade besökare och identisk markup
Som standard får inloggade besökare alltid en live-rendering. Med inställningen "serveLoggedIn": true kan de även använda ett befintligt lagrat dokument, vilket gör webbplatsen lika snabb för redaktörer och kunder som för anonyma besökare.
Personanpassade svar skapar aldrig cacheposter: en cachemiss för en inloggad besökare renderas live och lagras inte. Konsekvensen är lätt att missa. När serveLoggedIn är aktiverat får en inloggad besökare det anonyma dokumentet när ett sådant finns, och en personanpassad live-rendering endast när det saknas. Alla förgreningar i mallar som beror på den aktuella användaren visas bara vid cachemissar. Därför ändras samma sida mellan besök, och den personanpassade grenen blir i praktiken oanvänd på cachelagrade rutter.
Regeln som följer är att markup för inloggade användare måste vara byte-identisk med markup för anonyma användare på varje rutt utanför dynamicPaths. Det innebär att mallar som renderas på statiska rutter inte får innehålla grenar för is_user_logged_in() eller wp_get_current_user():
<?php // Do not do this on a static route. ?>
<?php if ( is_user_logged_in() ) : ?>
<a href="/account/">Hi, <?php echo esc_html( wp_get_current_user()->display_name ); ?></a>
<?php else : ?>
<a href="/login/">Sign in</a>
<?php endif; ?>
Det finns två enkla lösningar. Flytta rutten till dynamicPaths om hela sidan är personlig, till exempel en kontopanel. Eller behåll sidan statisk och rendera den personliga delen som en dynamisk blockö, som skickar en cache-säker platshållare i det lagrade HTML och hämtar det riktiga fragmentet i besökarens egen begäran:
<?php echo bs_block( array( 'name' => 'acme/greeting' ) ); ?>
Guiden Personanpassade fragment på cachelagrade sidor visar hur du bygger det blocket.
Signatur- eller grafogiltigförklaring
invalidate avgör hur lagrade dokument upphör att gälla.
| Aspekt | signature (standard) |
graph |
|---|---|---|
| Vem fyller cachen | anonyma cachemissar och uppvärmaren | ditt byggsteg samt anonyma cachemissar |
| Vad gör poster ogiltiga | TTL, sparade inlägg, ändringar på webbplatsnivå | ett nytt bygge, med TTL som övre gräns |
| Uppvärmare i bakgrunden | tillgänglig | av |
| Passar för | vanliga webbplatser | webbplatser med en driftsättningspipeline |
signature-läget kräver inga verktyg. När du sparar ett inlägg rensas startsidan och inläggets permalänk från cachen eller värms upp på nytt, och ändringar på webbplatsnivå, som temabyte, roterar cacheidentiteten.
graph-läget är avsett för deterministiska driftsättningar. Ett bygge beräknar en plan med Static_Prerender_Runtime::build_plan(), renderar endast berörda URL:er, registrerar varje resultat och aktiverar den färdiga uppsättningen atomärt med Static_Prerender_Early_Serve::install_artifact_entry(). Om valideringen av något refererat dokument misslyckas förblir den föregående uppsättningen aktiv. Mappade rutter levereras från den aktiverade artefakten tills nästa bygge ersätter den, så innehåll som redigeras i wp-admin når dessa rutter vid nästa driftsättning. Uppvärmaren per URL är avstängd i det här läget eftersom artefakter byggs och aktiveras som en enhet. En typisk produktionskonfiguration ser ut så här:
{
"performance": {
"profile": "speed",
"staticPrerender": {
"enabled": true,
"invalidate": "graph",
"ttl": 2592000,
"earlyServe": true,
"serveLoggedIn": true,
"dynamicPaths": [
"/account",
"/cart",
"/checkout",
"/login",
"/reset-password"
]
}
}
}
30-dagarsgränsen ttl begränsar bara hur gammalt ett levererat dokument får vara. Aktualiteten kommer från driftsättningen som bygger om grafen. Byggets API, uppdelning i delar och interna transport för rendering beskrivs i referensen Referens för statisk förhandsrendering.
Placera en CDN framför
Förhandsrenderingen talar redan om vilka svar som är säkra att dela: exakt de som har en HIT-header. Låt ursprungsservern omvandla den till en cacheheader och låt CDN följa ursprungsservern. Med nginx framför PHP-FPM:
map $upstream_http_x_blockstudio_static_prerender $edge_cache_control {
"~^HIT" "public, s-maxage=604800";
default "";
}
server {
listen 80;
server_name example.com;
root /var/www/html;
index index.php;
location / {
try_files $uri $uri/ /index.php?$args;
}
location ~ \.php$ {
include fastcgi_params;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
fastcgi_pass unix:/run/php/php-fpm.sock;
add_header Cache-Control $edge_cache_control;
}
}
Det reguljära uttrycket matchar både HIT och HIT-EARLY. För alla andra svar är variabeln tom, och nginx lägger inte till någon header med tomt värde. Därför lämnar cachemissar, dynamiska sökvägar och renderingar för inloggade användare ursprungsservern utan någon livslängd för delad cache.
På CDN-sidan:
- Cachelagra HTML endast när ursprungsservern anger en cachelivslängd. Inaktivera eventuell standard-TTL för svar som saknar en sådan.
- Förbigå kanten för samma cookies som Blockstudio behandlar som personliga (
wordpress_logged_in_,wp-postpass_,comment_author_email_) och för dinadynamicPaths,wp-adminochwp-json. - Rensa CDN efter varje driftsättning som ändrar sidor, mallar eller tillgångar. Cachen på ursprungsservern roterar av sig själv; kanten vet inte att den ska göra det.
Om du använder Tailwind med "output": "link" är formatmallen URL innehållshashad, så den sökvägen kan levereras med en långlivad cacheheader som anger oföränderligt innehåll.
Underhållskommandon
wp bs prerender warm
wp bs prerender status
wp bs prerender purge
wp bs teardown
warm lägger till inaktuella offentliga URL:er i kön och renderar upp till warm.concurrency av dem per körning, med en sammanfattning JSON. purge tar bort aktuella lagrade dokument och kön för webbplatsen. teardown tar bort händelserna cron och tillståndet för tidig leverans som den här installationen äger, och lämnar konfigurationsfiler orörda.
Rulla ut i den här ordningen: profilera först, kör sedan förhandsrenderingen med earlyServe avstängt och aktivera därefter tidig leverans när status och headrarna ser rätt ut. Varje lager kan återställas separat genom att ändra tillbaka dess värde.
Nästa steg
- Referens för statisk förhandsrendering: grafbyggen, aktivering av artefakter, lagringstid och hooks för observerbarhet.
- Prestanda: vad profilen
speedändrar och hur du mäter det. - Cachelagring: cachekatalogen där alla lagrade dokument finns.
- Personanpassade fragment på cachelagrade sidor: innehåll per besökare på statiska rutter.
- Driftsättning av en Blockstudio-webbplats: hur sidsynkronisering, rensning och uppvärmning passar in i en release.