WordPress als statische HTML aanbieden
De meeste pagina’s op een marketingsite of documentatiesite zijn voor iedere anonieme bezoeker hetzelfde. WordPress wordt nog steeds gestart, laadt elke plugin, voert het thema uit en rendert de blokken voor elk verzoek. Een paginacacheplugin kan helpen, maar voegt een extra onderdeel toe met eigen regels voor wat veilig kan worden opgeslagen.
Blockstudio biedt optionele statische prerendering. Volledige HTML-documenten voor anonieme bezoekers worden opgeslagen in een eigen cachemap. Als je dit toestaat, worden ze aangeboden via een drop-in van advanced-cache.php voordat WordPress wordt gestart. Alles wordt ingesteld in blockstudio.json.
Deze handleiding laat stap voor stap zien hoe je de functie inschakelt, controleert wat wel en niet in de cache wordt opgeslagen en de regel toepast die ingelogde bezoekers beschermt. Tot slot configureer je CDN zo dat alleen inhoud in de cache wordt opgeslagen die de origin als cachebaar markeert.
Hoe een verzoek wordt verwerkt
Met ingeschakelde prerendering eindigt een verzoek dat hiervoor in aanmerking komt op een van drie manieren:
- Vroege treffer. De drop-in vindt een opgeslagen document in de routekaart en streamt het voordat WordPress wordt geladen. Het antwoord bevat
X-Blockstudio-Static-Prerender: HIT-EARLY. - Treffer. WordPress wordt gestart en bij
template_redirectvindt Blockstudio een recent opgeslagen document en verstuurt dit in plaats van de template te renderen. Het antwoord bevatX-Blockstudio-Static-Prerender: HIT. - Misser. WordPress rendert de pagina op de gebruikelijke manier. Als de bezoeker anoniem is en het resultaat een volledig HTML-document met status 200 is, slaat Blockstudio het op voor het volgende verzoek.
Verzoeken die niet in aanmerking komen, raken de cache helemaal niet.
Stap 1: het profiel en de cache inschakelen
Begin met het prestatieprofiel en de prerendering, met vroege levering uitgeschakeld:
{
"$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
}
}
}
}
Dit doet elk onderdeel:
profile: "speed"schakelt de standaardinstellingen voor de productiefrontend in: overbodige head-elementen, oEmbed-detectie, XML-RPC en algemene core-frontendassets worden verwijderd, en links naar dezelfde origin worden vooraf opgehaald zodra de gebruiker intentie toont. Test eerst het verwijderen van core-frontendassets, want pagina’s die ervan afhankelijk zijn, kunnen zichtbaar kapotgaan. Elke onderliggende waarde overschrijft het profiel.staticPrerender.enabledregistreert de runtime. Zolang deze opfalsestaat, schrijft de functie geen bestanden en registreert deze geen verzoekhooks.ttlis de maximale leeftijd van een opgeslagen document in seconden (standaard86400).dynamicPathsbevat padvoorvoegsels die altijd live moeten worden gerenderd.warmplant een achtergrondproces in dat verouderde openbare URL’s elkeintervalseconden opnieuw rendert.
De regel $schema dekt elke sleutel. Een editor met ondersteuning voor het schema JSON signaleert daardoor fouten zoals "ttl": 0 (het minimum is 1).
Stap 2: weten welke verzoeken in aanmerking komen
Blockstudio is terughoudend met wat het opslaat. Deze verzoeken omzeilen altijd de cache:
- alles behalve
GET - elk URL met een querystring
wp-admin,wp-json,wp-login.php,xmlrpc.php, Ajax en cron- feeds, zoekopdrachten en voorbeeldweergaven
- verzoeken met een header
X-WP-Nonce - paden onder
dynamicPaths - bezoekers met een cookie
wordpress_logged_in_*,wp-postpass_*ofcomment_author_email_*, tenzijserveLoggedInis ingeschakeld
Dynamische paden worden vergeleken op padgrenzen. Met de bovenstaande configuratie:
| Verzoek | Omzeilt cache |
|---|---|
/pricing/ |
nee |
/account/orders/ |
ja |
/accounting/ |
nee |
/checkout |
ja |
/pricing/?utm_source=x |
ja |
/blog/feed/ |
ja |
Bij het opslaan wordt alleen een volledig document bewaard: het antwoord moet beginnen met <!doctype html of <html, status 200 hebben en de opt-outmarkering niet bevatten. Een template die nooit mag worden opgeslagen, kan de markering overal op de pagina afdrukken:
<!-- blockstudio:no-cache -->
Foutpagina’s worden nooit opgeslagen. Een thematische 404 kan dus nooit opnieuw worden weergegeven als geslaagde pagina.
Stap 3: treffers controleren
Bezoek enkele pagina’s in een privévenster en vraag vervolgens aan Blockstudio wat er is opgeslagen:
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 en bytes groeien naarmate documenten worden opgeslagen, queue toont de achterstand van het voorverwarmproces en diagnostics bevat tellers voor treffers, missers, opbouw en fouten per scope. Vraag een pagina twee keer op als anonieme bezoeker en controleer de header om één pagina te controleren:
curl -s -o /dev/null -D - https://example.com/pricing/ | grep -i x-blockstudio-static-prerender
Het tweede antwoord bevat X-Blockstudio-Static-Prerender: HIT. Gebruik een GET zoals hierboven: curl -I stuurt een verzoek HEAD, dat de cache altijd omzeilt.
Stap 4: aanbieden voordat WordPress wordt gestart
Zodra de treffers kloppen, stel je "earlyServe": true in. Blockstudio beheert dan drie kleine onderdelen van de status: een drop-in wp-content/advanced-cache.php, een gedeelde routekaart wp-content/blockstudio-static-prerender-map.php en een declaratie WP_CACHE in wp-config.php. Ze worden geïnstalleerd bij het volgende beheerderverzoek.
Enkele regels zorgen voor veilig gebruik op gedeelde hosting en multisite:
- Blockstudio overschrijft nooit een drop-in, map of
WP_CACHE-regel die niet van zichzelf is. Als een andere cachingplugin al eigenaar is vanadvanced-cache.php, blijft vroeg serveren uitgeschakeld. - Als
WP_CACHEal is gedefinieerd alstrue, blijftwp-config.phpongemoeid. Stel het zelf in op hosts waarwp-config.phpniet schrijfbaar is. - Vóór het serveren controleren zowel de drop-in als het PHP-pad of het content-hashed Tailwind-stylesheet waarnaar een document verwijst nog bestaat. Als dat niet zo is, wordt het verzoek doorgestuurd naar WordPress in plaats van een pagina zonder opmaak te serveren.
- Multisite-vermeldingen delen één map, maar zijn gescheiden op host, thuispad en site-ID.
- Reactieheaders die in
replayHeaderszijn genoemd (standaardLink), worden bij elk document opgeslagen en bij elke hit opnieuw verstuurd. Zo blijft eenLink-header die een pagina metheader()verstuurt, behouden bij vroeg serveren. Cookie- en cacheheaders worden nooit opnieuw verstuurd.
Vroege hits bevatten X-Blockstudio-Static-Prerender: HIT-EARLY. Als u earlyServe of enabled uitschakelt, wordt de status die Blockstudio beheert eenmaal verwijderd, en met wp bs teardown wordt deze expliciet verwijderd voor Composer-installaties zonder deactivatiehook.
Ingelogde bezoekers en identieke markup
Standaard krijgen ingelogde bezoekers altijd een live-rendering. Met "serveLoggedIn": true kunnen zij ook een bestaand opgeslagen document gebruiken, waardoor de site voor editors en klanten net zo snel is als voor anonieme bezoekers.
Gepersonaliseerde reacties maken nooit cache-items aan: bij een cachemiss wordt voor een ingelogde bezoeker live gerenderd en niets opgeslagen. Het gevolg is makkelijk over het hoofd te zien. Met serveLoggedIn aan krijgt een ingelogde bezoeker het anonieme document als dat bestaat, en alleen een gepersonaliseerde live-rendering als dat niet zo is. Elke templatevertakking op basis van de huidige gebruiker wordt alleen bij cachemisses uitgevoerd, waardoor dezelfde pagina bij verschillende bezoeken verandert en de gepersonaliseerde vertakking op gecachte routes feitelijk niet wordt gebruikt.
De regel die hieruit volgt: op elke route buiten dynamicPaths moet ingelogde markup byte voor byte identiek zijn aan anonieme markup. Dat betekent geen is_user_logged_in()– of wp_get_current_user()-vertakkingen in templates die op statische routes worden gerenderd:
<?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; ?>
Er zijn twee goede oplossingen. Verplaats de route naar dynamicPaths als de hele pagina persoonlijk is, bijvoorbeeld een accountdashboard. Of houd de pagina statisch en render het persoonlijke deel als een dynamisch block island. Dat levert een cacheveilige tijdelijke aanduiding op in het opgeslagen HTML en haalt het echte fragment op in het eigen verzoek van de bezoeker:
<?php echo bs_block( array( 'name' => 'acme/greeting' ) ); ?>
De gids Gepersonaliseerde fragmenten op gecachte pagina’s bouwt dat block.
Ongeldigmaking op basis van handtekening of graaf
invalidate bepaalt hoe opgeslagen documenten verlopen.
| Aspect | signature (standaard) |
graph |
|---|---|---|
| Wie de cache vult | anonieme cachemisses en de warmer | uw buildstap plus anonieme cachemisses |
| Waardoor vermeldingen verlopen | TTL, berichtopslag en wijzigingen op siteniveau | een nieuwe build, met TTL als bovengrens |
| Achtergrondwarmer | beschikbaar | uit |
| Geschikt voor | gewone sites | sites met een deploypipeline |
signature-modus vereist geen tooling. Als u een bericht opslaat, wordt de homepage en de permalink van dat bericht geleegd of opnieuw opgewarmd. Wijzigingen op siteniveau, zoals een themawissel, veranderen de cache-identiteit.
graph-modus is bedoeld voor deterministische deploys. Een build berekent met Static_Prerender_Runtime::build_plan() een plan, rendert alleen de getroffen URL’s, legt elk resultaat vast en activeert de voltooide set atomair met Static_Prerender_Early_Serve::install_artifact_entry(). Als de validatie van een document waarnaar wordt verwezen mislukt, blijft de vorige set actief. Gemapte routes worden vanuit het geactiveerde artefact geserveerd totdat de volgende build het vervangt, waardoor inhoud die in wp-admin is bewerkt die routes bij de volgende deploy bereikt. De warmer per URL is in deze modus uitgeschakeld, omdat artefacten als één geheel worden gebouwd en geactiveerd. Een typische productieopzet ziet er zo uit:
{
"performance": {
"profile": "speed",
"staticPrerender": {
"enabled": true,
"invalidate": "graph",
"ttl": 2592000,
"earlyServe": true,
"serveLoggedIn": true,
"dynamicPaths": [
"/account",
"/cart",
"/checkout",
"/login",
"/reset-password"
]
}
}
}
De termijn van 30 dagen van ttl begrenst alleen hoe oud een geserveerd document mag zijn. De deploy die de graaf opnieuw opbouwt, zorgt voor actualiteit. De build API, sharding en het interne rendertransport worden behandeld in de referentie voor Statische prerendering.
Een CDN ervoor zetten
De prerendering geeft al aan welke reacties veilig gedeeld kunnen worden: precies die met een HIT-header. Laat de origin dat omzetten in een cacheheader en laat de CDN de origin volgen. Met nginx vóó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;
}
}
De reguliere expressie komt overeen met zowel HIT als HIT-EARLY. Bij elke andere reactie is de variabele leeg. nginx voegt geen header met een lege waarde toe, dus bij cachemisses, dynamische paden en renderingen voor ingelogde gebruikers krijgt de origin geen gedeelde cacheduur.
Aan de CDN-kant:
- Cache HTML alleen als de origin een cacheduur meestuurt. Schakel een standaard edge-TTL uit voor reacties zonder cacheduur.
- Omzeil de edge voor dezelfde cookies die Blockstudio als persoonlijk behandelt (
wordpress_logged_in_,wp-postpass_,comment_author_email_) en voor uwdynamicPaths,wp-adminenwp-json. - Wis de CDN na elke deploy die pagina’s, templates of assets wijzigt. De cache van de origin wordt zelf vernieuwd; de edge weet niet dat dit nodig is.
Als u Tailwind met "output": "link" gebruikt, wordt stylesheet URL voorzien van een content-hash, zodat dat pad kan worden geserveerd met een langdurige immutable cacheheader.
Onderhoudsopdrachten
wp bs prerender warm
wp bs prerender status
wp bs prerender purge
wp bs teardown
warm zet verouderde publieke URL’s in de wachtrij en rendert er per uitvoering maximaal warm.concurrency, met een samenvatting van JSON. purge verwijdert de opgeslagen documenten en wachtrij van de huidige site. teardown verwijdert de cron-gebeurtenissen en de status voor vroeg serveren die deze installatie beheert, en laat configuratiebestanden ongemoeid.
Voer de uitrol in deze volgorde uit: eerst het profiel, daarna de prerendering met earlyServe uitgeschakeld, en vervolgens vroeg serveren zodra status en de headers er goed uitzien. U kunt elke laag afzonderlijk terugdraaien door de waarde ervan terug te zetten.
Volgende stappen
- Referentie voor statische prerendering: graafbuilds, activering van artefacten, bewaartermijn en observatiehooks.
- Prestaties: wat het
speed-profiel verandert en hoe u dit meet. - Caching: de cachemap waarin elk opgeslagen document staat.
- Gepersonaliseerde fragmenten op gecachte pagina’s: inhoud per bezoeker op statische routes.
- Een Blockstudio-site deployen: hoe paginasynchronisatie, wissen en opwarmen passen in een release.