Brug WordPress som statisk HTML
De fleste sider på et marketingwebsted eller dokumentationswebsted er ens for alle anonyme besøgende. WordPress starter stadig op, indlæser alle plugins, kører temaet og gengiver blokkene for hver anmodning. Et sidecache-plugin kan hjælpe, men det er endnu en bevægelig del med sine egne regler for, hvad der er sikkert at gemme.
Blockstudio har valgfri statisk prerendering. Den gemmer komplette HTML-dokumenter for anonyme brugere i sin egen cachemappe og kan, hvis du tillader det, levere dem fra et drop-in for advanced-cache.php, før WordPress starter. Alt konfigureres i blockstudio.json.
Denne vejledning aktiverer funktionen trin for trin, viser, hvordan du kontrollerer, hvad der caches og ikke caches, forklarer den ene regel, der beskytter indloggede besøgende, og slutter med en opsætning af CDN, som kun cacher det, oprindelsesserveren markerer som cachebart.
Sådan leveres en anmodning
Når prerendering er aktiveret, ender en kvalificeret anmodning på én af tre måder:
- Tidligt cachehit. Drop-in’et finder et gemt dokument i sit rutekort og sender det, før WordPress indlæses. Svaret indeholder
X-Blockstudio-Static-Prerender: HIT-EARLY. - Cachehit. WordPress starter, og ved
template_redirectfinder Blockstudio et nyt gemt dokument og sender det i stedet for at gengive skabelonen. Svaret indeholderX-Blockstudio-Static-Prerender: HIT. - Cachemiss. WordPress gengiver siden normalt. Hvis besøgende er anonym, og resultatet er et komplet HTML-dokument med status 200, gemmer Blockstudio det til næste anmodning.
Anmodninger, der ikke er kvalificerede, berører aldrig cachen.
Trin 1: Aktivér profilen og cachen
Start med ydelsesprofilen og prerendering, men med tidlig levering slået fra:
{
"$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
}
}
}
}
Hvad de enkelte dele gør:
profile: "speed"aktiverer standardindstillingerne for produktionsfrontend: unødvendig head-markup, oEmbed-registrering, XML-RPC og generiske frontendressourcer fra kernen fjernes, og links med samme oprindelse forhåndshentes ved brugerens hensigt. Fjernelse af frontendressourcer fra kernen er den indstilling, du først bør teste, da en side, der afhænger af dem, tydeligt går i stykker. Alle underordnede værdier tilsidesætter profilen.staticPrerender.enabledregistrerer kørselsmiljøet. Når den erfalse, skriver funktionen ingen filer og registrerer ingen anmodningshooks.ttler den maksimale alder for et gemt dokument i sekunder (standard86400).dynamicPathsangiver stipræfikser, der altid skal gengives live.warmplanlægger en baggrundsopvarmning, der gengiver forældede offentlige URL’er igen hvertintervalsekund.
Linjen $schema dækker alle nøgler, så en editor med skemaunderstøttelse i JSON markerer en fejl som "ttl": 0 (minimum er 1).
Trin 2: Find ud af, hvad der er kvalificeret
Blockstudio er forsigtig med, hvad den gemmer. Disse anmodninger går altid uden om cachen:
- alt andet end
GET - ethvert URL med en forespørgselsstreng
wp-admin,wp-json,wp-login.php,xmlrpc.php, Ajax og cron- feeds, søgning og forhåndsvisningsstier
- anmodninger med en
X-WP-Nonce-header - stier under
dynamicPaths - besøgende med en
wordpress_logged_in_*-,wp-postpass_*– ellercomment_author_email_*-cookie, medmindreserveLoggedIner slået til
Dynamiske stier matches ved stigrænser. Med konfigurationen ovenfor:
| Anmodning | Gået uden om |
|---|---|
/pricing/ |
nej |
/account/orders/ |
ja |
/accounting/ |
nej |
/checkout |
ja |
/pricing/?utm_source=x |
ja |
/blog/feed/ |
ja |
Når et svar gemmes, beholdes kun komplette dokumenter: Svaret skal begynde med <!doctype html eller <html, have status 200 og ikke indeholde fravalgsmarkøren. En skabelon, der aldrig må gemmes, kan udskrive markøren hvor som helst på siden:
<!-- blockstudio:no-cache -->
Fejlsider gemmes aldrig, så en tematiseret 404 kan aldrig blive afspillet som en succes.
Trin 3: Kontrollér cachehits
Besøg nogle sider i et privat vindue, og spørg derefter Blockstudio, hvad den gemmer:
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 og bytes vokser, efterhånden som dokumenter gemmes, queue viser opvarmningens kø, og diagnostics indeholder tællere for hits, misses, builds og fejl pr. område. Kontrollér en enkelt side ved at anmode om den to gange som anonym besøgende, og se efter headeren:
curl -s -o /dev/null -D - https://example.com/pricing/ | grep -i x-blockstudio-static-prerender
Det andet svar indeholder X-Blockstudio-Static-Prerender: HIT. Brug et GET som ovenfor: curl -I sender en HEAD-anmodning, der altid går uden om cachen.
Trin 4: Lever før WordPress starter
Når cachehits ser rigtige ud, skal du indstille "earlyServe": true. Blockstudio administrerer derefter tre små dele af tilstanden: et drop-in wp-content/advanced-cache.php, et delt rutekort wp-content/blockstudio-static-prerender-map.php og en erklæring WP_CACHE i wp-config.php. De installeres ved den næste anmodning fra administrationen.
Et par regler gør dette sikkert på delt hosting og multisite:
- Blockstudio overskriver aldrig en drop-in-komponent, et map eller en
WP_CACHE-linje, som den ikke ejer. Hvis et andet caching-plugin allerede ejeradvanced-cache.php, forbliver tidlig levering deaktiveret. - Hvis
WP_CACHEallerede er defineret somtrue, ladeswp-config.phpurørt. På værter, hvorwp-config.phpikke kan skrives til, skal du selv definere den. - Før levering kontrollerer både drop-in-komponenten og stien PHP, at det indholdshash-baserede Tailwind-stylesheet, som et dokument linker til, stadig findes. Hvis det ikke gør, sendes anmodningen videre til WordPress i stedet for at blive leveret uden styling.
- Multisite-poster deler ét map, men er adskilt efter vært, hjemmesidesti og websteds-ID.
- Svarheadere angivet i
replayHeaders, som standardLink, gemmes sammen med hvert dokument og sendes igen ved hvert hit, så enLink-header, som en side sender medheader(), bevares ved tidlig levering. Cookie- og cacheheadere genafspilles aldrig.
Tidlige cachetræf indeholder X-Blockstudio-Static-Prerender: HIT-EARLY. Hvis earlyServe eller enabled slås fra, fjerner det den tilstand, som Blockstudio ejer, én gang, og wp bs teardown fjerner den eksplicit for installationer af Composer, der ikke har en deaktiveringshook.
Indloggede besøgende og identisk markup
Som standard får indloggede besøgende altid en live-rendering. Med "serveLoggedIn": true kan de også bruge et eksisterende gemt dokument, så webstedet er lige så hurtigt for redaktører og kunder som for anonyme besøgende.
Personaliserede svar opretter aldrig cacheposter: Ved et cache-miss får en indlogget besøgende en live-rendering, som ikke gemmes. Konsekvensen er let at overse. Når serveLoggedIn er slået til, får en indlogget besøgende det anonyme dokument, hvis det findes, og en personaliseret live-rendering kun hvis det ikke gør. Enhver skabelongren, der afhænger af den aktuelle bruger, vises kun ved cache-miss, så den samme side ændrer sig mellem besøg, og den personaliserede gren bruges reelt aldrig på cachelagrede ruter.
Reglen er derfor: På alle ruter uden for dynamicPaths skal markup for indloggede brugere være byteidentisk med markup for anonyme brugere. Det betyder, at skabeloner, der rendrer på statiske ruter, ikke må indeholde grene for 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; ?>
Der er to enkle løsninger. Flyt ruten ind i dynamicPaths, hvis hele siden er personlig, f.eks. et kontodashboard. Eller behold siden statisk, og rendr den personlige del som en dynamisk blokø, der sender en cache-sikker pladsholder i det gemte HTML og henter det rigtige fragment i den besøgendes egen anmodning:
<?php echo bs_block( array( 'name' => 'acme/greeting' ) ); ?>
Guiden Personaliserede fragmenter på cachelagrede sider bygger denne blok.
Ugyldiggørelse efter signatur eller graf
invalidate bestemmer, hvordan gemte dokumenter udløber.
| Aspekt | signature (standard) |
graph |
|---|---|---|
| Hvem fylder cachen | anonyme cache-miss og opvarmeren | dit build-trin samt anonyme cache-miss |
| Hvad udløber poster | TTL, lagring af indlæg og ændringer på siteniveau | et nyt build med TTL som øvre grænse |
| Baggrundsopvarmer | tilgængelig | slået fra |
| Passer til | almindelige websteder | websteder med en deploy-pipeline |
signature kræver ingen værktøjer. Når et indlæg gemmes, ryddes cachen for eller genopvarmes for startsiden og indlæggets permalink, og ændringer på siteniveau, f.eks. et temaskift, ændrer cacheidentiteten.
graph er beregnet til deterministiske deploys. Et build beregner en plan med Static_Prerender_Runtime::build_plan(), rendrer kun de berørte URL’er, registrerer hvert resultat og aktiverer det færdige sæt atomisk med Static_Prerender_Early_Serve::install_artifact_entry(). Hvis validering af et refereret dokument fejler, forbliver det forrige sæt aktivt. Tilknyttede ruter leveres fra det aktiverede artefakt, indtil næste build erstatter det, så indhold, der redigeres i wp-admin, når ruterne ved næste deploy. Opvarmeren pr. URL er slået fra i denne tilstand, fordi artefakter bygges og aktiveres som én enhed. Et typisk produktionssetup ser sådan ud:
{
"performance": {
"profile": "speed",
"staticPrerender": {
"enabled": true,
"invalidate": "graph",
"ttl": 2592000,
"earlyServe": true,
"serveLoggedIn": true,
"dynamicPaths": [
"/account",
"/cart",
"/checkout",
"/login",
"/reset-password"
]
}
}
}
30-dages-ttl sætter kun en grænse for, hvor gammelt et leveret dokument må være. Aktualiteten kommer fra det deploy, der genopbygger grafen. Build-API, opdeling i shards og den interne rendertransport beskrives i referencen om statisk prerendering.
Placering af en CDN foran
Prerenderingen viser allerede, hvilke svar der er sikre at dele: præcis dem, der har en HIT-header. Lad origin-serveren omsætte den til en cache-header, og lad CDN følge origin-serveren. Med nginx foran 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 regulære udtryk matcher både HIT og HIT-EARLY. For alle andre svar er variablen tom, og nginx tilføjer ikke en header med en tom værdi, så cache-miss, dynamiske stier og renderinger for indloggede brugere får ingen fælles cachelevetid fra origin-serveren.
På CDN-siden:
- Cachelagr kun HTML, når origin-serveren angiver en cachelevetid. Deaktivér enhver standard-TTL for svar uden en sådan.
- Omgå edge-cachen for de samme cookies, som Blockstudio behandler som personlige (
wordpress_logged_in_,wp-postpass_,comment_author_email_), og for dinedynamicPaths,wp-adminogwp-json. - Ryd CDN efter hver deploy, der ændrer sider, skabeloner eller aktiver. Origin-cachen skifter selv, men edge-cachen ved ikke, at den skal gøre det.
Hvis du bruger Tailwind med "output": "link", er typografiarket URL indholdshashbaseret, så stien kan leveres med en langlivet, uforanderlig cache-header.
Vedligeholdelseskommandoer
wp bs prerender warm
wp bs prerender status
wp bs prerender purge
wp bs teardown
warm føjer forældede offentlige URL’er til køen og rendrer op til warm.concurrency af dem pr. kørsel og udskriver en oversigt over JSON. purge fjerner det aktuelle sites gemte dokumenter og kø. teardown fjerner cron-hændelserne og den tidlige leverings tilstand, som denne installation ejer, og lader konfigurationsfilerne være urørte.
Rul ud i denne rækkefølge: Først profilering, derefter prerendering med earlyServe slået fra og til sidst tidlig levering, når status og headerne ser rigtige ud. Hvert lag kan rulles tilbage for sig ved at sætte værdien tilbage.
Næste trin
- Reference om statisk prerendering: graf-builds, aktivering af artefakter, opbevaring og hooks til overvågning.
- Ydeevne: hvad
speed-profilen ændrer, og hvordan du måler det. - Caching: cachemappen, hvor alle gemte dokumenter ligger.
- Personaliserede fragmenter på cachelagrede sider: indhold pr. besøgende på statiske ruter.
- Udrulning af et Blockstudio-websted: hvordan sidesynkronisering, cache-rydning og opvarmning indgår i en release.