Furnizarea WordPress ca HTML static
Majoritatea paginilor de pe un site de marketing sau de documentație sunt identice pentru toți vizitatorii anonimi. WordPress pornește totuși, încarcă fiecare plugin, rulează tema și randează blocurile pentru fiecare cerere. Un plugin de cache pentru pagini poate ajuta, dar adaugă încă o componentă, cu propriile reguli despre ce se poate stoca în siguranță.
Blockstudio include o funcție opțională de pre-randare statică. Aceasta stochează documente HTML anonime complete în propriul director de cache și, dacă permiteți, le servește dintr-un drop-in advanced-cache.php înainte de pornirea WordPress. Totul se configurează în blockstudio.json.
Acest ghid activează funcția pas cu pas, arată cum puteți verifica ce se stochează și ce nu, explică singura regulă care protejează vizitatorii autentificați și se încheie cu o configurare CDN care memorează în cache numai ceea ce originea marchează drept stocabil.
Cum este servită o cerere
Când pre-randarea este activată, o cerere eligibilă se încheie într-unul dintre aceste trei moduri:
- Rezultat găsit devreme. Drop-in-ul găsește un document stocat în harta rutelor și îl transmite înainte ca WordPress să se încarce. Răspunsul include
X-Blockstudio-Static-Prerender: HIT-EARLY. - Rezultat găsit. WordPress pornește, iar la
template_redirectBlockstudio găsește un document stocat încă valabil și îl trimite în loc să randeze șablonul. Răspunsul includeX-Blockstudio-Static-Prerender: HIT. - Fără rezultat. WordPress randează pagina în mod normal. Dacă vizitatorul este anonim, iar rezultatul este un document HTML complet, cu starea 200, Blockstudio îl stochează pentru următoarea cerere.
Cererile neeligibile nu accesează niciodată memoria cache.
Pasul 1: Activați profilul și memoria cache
Începeți cu profilul de performanță și pre-randarea, fără servirea timpurie:
{
"$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
}
}
}
}
Ce face fiecare componentă:
profile: "speed"activează setările implicite de producție pentru partea publică: elimină elementele inutile din head, descoperirea oEmbed, XML-RPC și resursele generice ale părții publice din nucleu, iar linkurile de aceeași origine sunt preîncărcate la inițierea navigării. Eliminarea resurselor din partea publică a nucleului este prima setare de testat, deoarece o pagină care depinde de ele se defectează vizibil. Orice valoare copil suprascrie profilul.staticPrerender.enabledînregistrează mediul de execuție. Cât timp estefalse, funcția nu scrie fișiere și nu înregistrează hook-uri pentru cereri.ttleste vârsta maximă, în secunde, a unui document stocat (implicit86400).dynamicPathsenumeră prefixele de cale care trebuie întotdeauna randate dinamic.warmprogramează un proces de reîmprospătare în fundal, care randează din nou URL-urile publice expirate la fiecareintervalsecunde.
Linia $schema acoperă toate cheile, astfel încât un editor cu suport pentru schema JSON semnalează o greșeală precum "ttl": 0 (valoarea minimă este 1).
Pasul 2: Aflați ce este eligibil
Blockstudio este prudent în privința datelor stocate. Aceste cereri ocolesc întotdeauna memoria cache:
- orice metodă diferită de
GET - orice URL cu un șir de interogare
wp-admin,wp-json,wp-login.php,xmlrpc.php, Ajax și cron- fluxuri, căutări și căi de previzualizare
- cereri care trimit un antet
X-WP-Nonce - căi din
dynamicPaths - vizitatori cu un cookie
wordpress_logged_in_*,wp-postpass_*saucomment_author_email_*, dacăserveLoggedInnu este activat
Căile dinamice sunt potrivite la limitele segmentelor de cale. Cu configurația de mai sus:
| Cerere | Ocolită |
|---|---|
/pricing/ |
nu |
/account/orders/ |
da |
/accounting/ |
nu |
/checkout |
da |
/pricing/?utm_source=x |
da |
/blog/feed/ |
da |
La stocare se păstrează numai un document complet: răspunsul trebuie să înceapă cu <!doctype html sau <html, să aibă starea 200 și să nu conțină marcajul de renunțare. Un șablon care nu trebuie stocat niciodată poate afișa marcajul oriunde în pagină:
<!-- blockstudio:no-cache -->
Paginile de eroare nu sunt stocate niciodată, astfel că un 404 stilizat nu poate fi redat ulterior ca succes.
Pasul 3: Verificați rezultatele găsite
Vizitați câteva pagini într-o fereastră privată, apoi cereți-i lui Blockstudio să vă arate ce conține:
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 și bytes cresc pe măsură ce se stochează documente, queue afișează lista de așteptare a procesului de reîmprospătare, iar diagnostics conține contoare de rezultate găsite, rezultate lipsă, compilări și erori pentru fiecare domeniu. Pentru a verifica o singură pagină, solicitați-o de două ori ca vizitator anonim și căutați antetul:
curl -s -o /dev/null -D - https://example.com/pricing/ | grep -i x-blockstudio-static-prerender
Al doilea răspuns include X-Blockstudio-Static-Prerender: HIT. Folosiți o GET ca mai sus: curl -I trimite o cerere HEAD, care ocolește întotdeauna memoria cache.
Pasul 4: Serviți înainte de pornirea WordPress
După ce rezultatele găsite sunt corecte, setați "earlyServe": true. Blockstudio va gestiona apoi trei componente simple: un drop-in wp-content/advanced-cache.php, o hartă de rute wp-content/blockstudio-static-prerender-map.php partajată și o declarație WP_CACHE în wp-config.php. Acestea se instalează la următoarea cerere de administrare.
Câteva reguli asigură funcționarea în siguranță pe găzduire partajată și în multisite:
- Blockstudio nu suprascrie niciun drop-in, nicio hartă și nicio linie
WP_CACHEpe care nu le deține. Dacă un alt plugin de cache deține dejaadvanced-cache.php, servirea timpurie rămâne dezactivată. - Dacă
WP_CACHEeste deja definit catrue,wp-config.phpeste lăsat neschimbat. Pe gazdele undewp-config.phpnu poate fi scris, definiți-l manual. - Înainte de servire, atât componenta drop-in, cât și calea PHP verifică dacă foaia de stiluri Tailwind cu hash-ul conținutului, la care face legătura un document, există încă. Dacă nu există, solicitarea este direcționată către WordPress în loc să fie servită fără stiluri.
- Intrările multisite folosesc aceeași hartă, dar sunt izolate după gazdă, calea principală și ID-ul site-ului.
- Antetele de răspuns specificate în
replayHeaders,Linkîn mod implicit, sunt stocate pentru fiecare document și retrimise la fiecare accesare, astfel încât un antetLinktrimis de o pagină împreună cuheader()se păstrează la servirea timpurie. Antetele pentru cookie-uri și cache nu sunt niciodată redate.
Accesările timpurii conțin X-Blockstudio-Static-Prerender: HIT-EARLY. Dezactivarea earlyServe sau enabled elimină o singură dată starea deținută de Blockstudio, iar wp bs teardown o elimină explicit pentru instalările Composer care nu au un hook de dezactivare.
Vizitatori autentificați și markup identic
În mod implicit, vizitatorii autentificați primesc întotdeauna o randare în timp real. Setarea "serveLoggedIn": true le permite să folosească și un document stocat existent, astfel încât site-ul să fie la fel de rapid pentru editori și clienți ca pentru vizitatorii anonimi.
Răspunsurile personalizate nu creează niciodată intrări în cache: o solicitare fără rezultat a unui utilizator autentificat este randată în timp real și nu este stocată. Consecința este ușor de trecut cu vederea. Cu serveLoggedIn activat, un vizitator autentificat primește documentul anonim ori de câte ori acesta există și o randare personalizată în timp real doar când nu există. Orice ramură de șablon bazată pe utilizatorul curent apare numai când nu există o intrare în cache, astfel încât aceeași pagină se schimbă de la o vizită la alta, iar ramura personalizată devine practic inutilă pe rutele din cache.
Regula care rezultă: pe fiecare rută din afara dynamicPaths, markup-ul pentru utilizatorii autentificați trebuie să fie identic la nivel de octet cu cel anonim. Asta înseamnă că șabloanele randate pe rutele statice nu trebuie să aibă ramuri is_user_logged_in() sau 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; ?>
Există două soluții simple. Mutați ruta în dynamicPaths dacă întreaga pagină este personală, de exemplu un tablou de bord al contului. Sau păstrați pagina statică și redați partea personală ca o insulă de bloc dinamică, care livrează un substituent sigur pentru cache în HTML stocat și preia fragmentul real prin cererea proprie a vizitatorului:
<?php echo bs_block( array( 'name' => 'acme/greeting' ) ); ?>
Ghidul Fragmentelor personalizate pe pagini din cache construiește acel bloc.
Invalidare după semnătură sau graf
invalidate stabilește cum expiră documentele stocate.
| Aspect | signature (implicit) |
graph |
|---|---|---|
| Cine umple cache-ul | solicitările anonime fără rezultat și încălzitorul | pasul de compilare, plus solicitările anonime fără rezultat |
| Ce expiră intrările | TTL, salvările articolelor, modificările la nivel de site | o compilare nouă, cu TTL drept limită superioară |
| Încălzitorul în fundal | disponibil | dezactivat |
| Potrivit pentru | site-uri obișnuite | site-uri cu un flux de livrare |
Modul signature nu necesită instrumente. Salvarea unui articol golește sau reîncălzește pagina principală și legătura permanentă a articolului, iar modificările la nivel de site, precum schimbarea temei, rotesc identitatea cache-ului.
Modul graph este destinat livrărilor deterministe. O compilare calculează un plan cu Static_Prerender_Runtime::build_plan(), randează doar URL-urile afectate, înregistrează fiecare rezultat și activează atomic setul final cu Static_Prerender_Early_Serve::install_artifact_entry(). Dacă validarea unui document referențiat eșuează, setul anterior rămâne activ. Rutele mapate sunt servite din artefactul activat până când următoarea compilare îl înlocuiește, astfel încât conținutul modificat în wp-admin ajunge pe acele rute la următoarea livrare. În acest mod, încălzitorul URL este dezactivat, deoarece artefactele sunt compilate și activate ca o singură unitate. O configurație obișnuită de producție arată astfel:
{
"performance": {
"profile": "speed",
"staticPrerender": {
"enabled": true,
"invalidate": "graph",
"ttl": 2592000,
"earlyServe": true,
"serveLoggedIn": true,
"dynamicPaths": [
"/account",
"/cart",
"/checkout",
"/login",
"/reset-password"
]
}
}
}
ttl de 30 de zile stabilește doar vechimea maximă a unui document servit. Prospețimea vine din livrarea care reconstruiește graful. Compilarea API, fragmentarea și transportul intern pentru randare sunt descrise în referința Randare statică anticipată.
Adăugarea unui CDN în față
Randarea anticipată indică deja ce răspunsuri pot fi partajate în siguranță: exact cele care conțin un antet HIT. Lăsați serverul de origine să transforme acest lucru într-un antet de cache și lăsați CDN să urmeze serverul de origine. Cu nginx în fața 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;
}
}
Expresia regulată se potrivește atât cu HIT, cât și cu HIT-EARLY. Pentru orice alt răspuns, variabila este goală, iar nginx nu adaugă un antet cu valoare goală; astfel, solicitările fără rezultat, căile dinamice și randările pentru utilizatorii autentificați nu primesc o durată de cache partajată de la serverul de origine.
Pe partea CDN:
- Puneți în cache HTML doar când serverul de origine trimite o durată de cache. Dezactivați orice TTL implicit la nivelul edge pentru răspunsurile fără o astfel de durată.
- Ocoliți edge-ul pentru aceleași cookie-uri pe care Blockstudio le tratează ca personale (
wordpress_logged_in_,wp-postpass_,comment_author_email_) și pentrudynamicPaths,wp-adminșiwp-json. - Goliți CDN după fiecare livrare care modifică pagini, șabloane sau resurse. Cache-ul serverului de origine se rotește automat; edge-ul nu știe că ar trebui să facă la fel.
Dacă folosiți Tailwind cu "output": "link", foaia de stil URL are un hash de conținut, așa că acea cale poate fi servită cu un antet de cache imuabil, cu durată lungă.
Commandes de maintenance
wp bs prerender warm
wp bs prerender status
wp bs prerender purge
wp bs teardown
warm adaugă în coadă URL-urile publice expirate și randează până la warm.concurrency dintre ele la fiecare execuție, afișând un rezumat JSON. purge elimină documentele stocate și coada site-ului curent. teardown elimină evenimentele cron și starea de servire timpurie deținute de această instalare, fără să atingă fișierele de configurare.
Lansați în această ordine: mai întâi profilul, apoi randarea anticipată cu earlyServe dezactivat, apoi servirea timpurie după ce status și antetele arată corect. Fiecare nivel poate fi anulat separat, readucând valoarea sa anterioară.
Pașii următori
- Referință pentru randarea statică anticipată: compilări de grafuri, activarea artefactelor, păstrarea acestora și hook-uri de observabilitate.
- Performanță: ce modifică profilul
speedși cum se măsoară. - Caching: directorul de cache în care se află fiecare document stocat.
- Fragmente personalizate pe pagini din cache: conținut specific fiecărui vizitator pe rutele statice.
- Livrarea unui site Blockstudio: unde se încadrează sincronizarea, golirea și încălzirea paginilor într-o versiune.