WordPress kā statiska HTML apkalpošana
Lielākā daļa mārketinga vai dokumentācijas vietnes lapu visiem anonīmajiem apmeklētājiem ir vienādas. WordPress joprojām tiek inicializēts, ielādē katru spraudni, palaiž tēmu un renderē blokus katram pieprasījumam. Lapu kešatmiņas spraudnis var palīdzēt, taču tas ir vēl viens komponents ar saviem noteikumiem par drošu datu glabāšanu.
Blockstudio piedāvā statisku iepriekšējo renderēšanu, kas jāiespējo atsevišķi. Tā savā kešatmiņas direktorijā saglabā pilnus anonīmus HTML dokumentus un, ja atļausiet, apkalpo tos no advanced-cache.php drop-in pirms WordPress inicializēšanas. Viss tiek konfigurēts failā blockstudio.json.
Šajā pamācībā soli pa solim tiek ieslēgta šī funkcija, parādīts, kā pārbaudīt, kas tiek un netiek saglabāts kešatmiņā, izskaidrots viens noteikums, kas aizsargā pieteikušos apmeklētājus, un beigās parādīts CDN iestatījums, kas saglabā kešatmiņā tikai to, ko izcelsmes serveris atzīmē kā kešojamu.
Kā tiek apkalpots pieprasījums
Ja iepriekšējā renderēšana ir iespējota, atbilstošs pieprasījums var beigties vienā no trim veidiem:
- Agrīns trāpījums. Drop-in atrod saglabāto dokumentu savā maršrutu kartē un nosūta to pa daļām pirms WordPress ielādes. Atbilde satur
X-Blockstudio-Static-Prerender: HIT-EARLY. - Trāpījums. Tiek inicializēts WordPress, un brīdī, kad tiek izpildīts
template_redirect, Blockstudio atrod svaigu saglabātu dokumentu un nosūta to veidnes renderēšanas vietā. Atbilde saturX-Blockstudio-Static-Prerender: HIT. - Neveiksmīgs trāpījums. WordPress renderē lapu parastajā veidā. Ja apmeklētājs ir anonīms un rezultāts ir pilns HTML dokuments ar statusu 200, Blockstudio saglabā to nākamajam pieprasījumam.
Pieprasījumi, kas neatbilst nosacījumiem, kešatmiņu neizmanto vispār.
1. darbība: iespējojiet profilu un kešatmiņu
Sāciet ar veiktspējas profilu un iepriekšējo renderēšanu, bet atstājiet agrīno apkalpošanu izslēgtu:
{
"$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
}
}
}
}
Katras daļas funkcija:
profile: "speed"ieslēdz ražošanas vides saskarnes noklusējuma iestatījumus: tiek noņemts liekais kods galvenē, oEmbed atklāšana, XML-RPC un vispārīgie pamata saskarnes resursi; pēc pieprasījuma tiek sākta vienas izcelsmes saišu iepriekšēja ielāde. Vispirms pārbaudiet pamata saskarnes resursu noņemšanas iestatījumu, jo lapa, kas no tiem ir atkarīga, acīmredzami nedarbosies. Profila vērtības var aizstāt ar pakārtotām vērtībām.staticPrerender.enabledreģistrē izpildlaika vidi. Kamēr tā irfalse, funkcija neraksta failus un nereģistrē pieprasījumu āķus.ttlir saglabāta dokumenta maksimālais vecums sekundēs (noklusējums:86400).dynamicPathsuzskaita ceļu prefiksus, kuriem vienmēr jārenderējas tiešsaistē.warmieplāno fona kešatmiņas atjaunotāju, kas ik pēcintervalsekundēm no jauna renderē novecojušus publiskos URL.
Rindiņa $schema aptver katru atslēgu, tāpēc redaktors ar JSON shēmas atbalstu atzīmē kļūdu, piemēram, "ttl": 0 (minimālā vērtība ir 1).
2. darbība: noskaidrojiet, kuri pieprasījumi atbilst nosacījumiem
Blockstudio konservatīvi izvērtē, ko saglabāt. Šie pieprasījumi vienmēr apiet kešatmiņu:
- viss, izņemot
GET - jebkurš URL ar vaicājuma virkni
wp-admin,wp-json,wp-login.php,xmlrpc.php, Ajax un cron- plūsmu, meklēšanas un priekšskatījuma ceļi
- pieprasījumi ar
X-WP-Noncegalveni - ceļi mapē
dynamicPaths - apmeklētāji ar sīkdatni
wordpress_logged_in_*,wp-postpass_*vaicomment_author_email_*, izņemot gadījumu, kad ir ieslēgtsserveLoggedIn
Dinamiskie ceļi tiek salīdzināti pēc ceļa robežām. Ar iepriekš minēto konfigurāciju:
| Pieprasījums | Apiet kešatmiņu |
|---|---|
/pricing/ |
nē |
/account/orders/ |
jā |
/accounting/ |
nē |
/checkout |
jā |
/pricing/?utm_source=x |
jā |
/blog/feed/ |
jā |
Saglabāšanas laikā tiek paturēts tikai pilns dokuments: atbildei jāsākas ar <!doctype html vai <html, tās statusam jābūt 200, un tajā nedrīkst būt atteikšanās marķiera. Veidne, kuru nekad nevajadzētu saglabāt, var izvadīt marķieri jebkurā lapas vietā:
<!-- blockstudio:no-cache -->
Kļūdu lapas nekad netiek saglabātas, tāpēc tematizētu 404 nekad nevar atkārtoti parādīt kā veiksmīgu atbildi.
3. darbība: pārbaudiet trāpījumus
Apmeklējiet dažas lapas privātā logā un pēc tam noskaidrojiet, kas ir saglabāts Blockstudio:
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 un bytes palielinās, dokumentiem uzkrājoties; queue rāda atjaunotāja neapstrādāto darbu sarakstu, bet diagnostics ietver trāpījumu, neveiksmīgu trāpījumu, būvēšanas un kļūmju skaitītājus katram tvērumam. Lai pārbaudītu atsevišķu lapu, pieprasiet to divreiz kā anonīms apmeklētājs un meklējiet galveni:
curl -s -o /dev/null -D - https://example.com/pricing/ | grep -i x-blockstudio-static-prerender
Otrajā atbildē ir X-Blockstudio-Static-Prerender: HIT. Izmantojiet GET, kā norādīts iepriekš: curl -I nosūta HEAD pieprasījumu, kas vienmēr apiet kešatmiņu.
4. darbība: apkalpojiet saturu, pirms tiek inicializēts WordPress
Kad trāpījumi izskatās pareizi, iestatiet "earlyServe": true. Pēc tam Blockstudio pārvalda trīs nelielus stāvokļa elementus: drop-in wp-content/advanced-cache.php, koplietojamu wp-content/blockstudio-static-prerender-map.php maršrutu karti un WP_CACHE deklarāciju failā wp-config.php. Tie tiek instalēti nākamajā administrācijas pieprasījumā.
Daži noteikumi palīdz nodrošināt drošu darbību koplietotajā mitināšanā un vairāku vietņu vidē:
- Blockstudio nekad nepārraksta ielāpu, karti vai
WP_CACHErindu, kas tam nepieder. Jaadvanced-cache.phpjau pieder citam kešatmiņas spraudnim, agrīnā apkalpošana paliek izslēgta. - Ja
WP_CACHEjau ir definēts kātrue,wp-config.phpnetiek mainīts. Resursdatoros, kuroswp-config.phpnav rakstāms, definējiet to paši. - Pirms apkalpošanas gan ielāps, gan ceļš PHP pārbauda, vai joprojām pastāv dokumenta saitē norādītā satura jaucējkoda Tailwind stila lapa. Ja tās nav, pieprasījums tiek novirzīts uz WordPress, nevis apkalpots bez stiliem.
- Multisite ierakstiem ir kopīga karte, taču tie tiek nodalīti pēc resursdatora, sākumceļa un vietnes ID.
- Katrā dokumentā tiek saglabātas un katrā trāpījumā nosūtītas atkārtoti atbildes galvenes, kas norādītas
replayHeaders— pēc noklusējumaLink. TādējādiLinkgalvene, ko lapa sūta kopā arheader(), saglabājas arī agrīnās apkalpošanas laikā. Sīkdatņu un kešatmiņas galvenes nekad netiek nosūtītas atkārtoti.
Agrīnie trāpījumi ietver X-Blockstudio-Static-Prerender: HIT-EARLY. Izslēdzot earlyServe vai enabled, tiek noņemts stāvoklis, ko Blockstudio pārvalda, savukārt wp bs teardown to īpaši noņem instalācijās Composer, kurām nav deaktivizēšanas āķa.
Pieteikušies apmeklētāji un identisks marķējums
Pēc noklusējuma pieteikušies apmeklētāji vienmēr saņem aktuālu atveidojumu. Iestatot "serveLoggedIn": true, viņi var izmantot arī jau saglabātu dokumentu, tāpēc vietne ir tikpat ātra redaktoriem un klientiem kā anonīmiem apmeklētājiem.
Personalizētas atbildes nekad neveido kešatmiņas ierakstus: ja pieteicies apmeklētājs neatrod saglabātu dokumentu, lapa tiek atveidota aktuāli, bet rezultāts netiek saglabāts. Šo seku ir viegli nepamanīt. Ja serveLoggedIn ir ieslēgts, pieteicies apmeklētājs saņem anonīmo dokumentu, ja tāds ir, un personalizētu aktuālo atveidojumu tikai tad, ja tāda nav. Jebkurš veidnes atzars, kas atkarīgs no pašreizējā lietotāja, parādās tikai tad, ja dokumenta nav, tāpēc viena un tā pati lapa dažādos apmeklējumos mainās, un personalizētais atzars kešotajos maršrutos faktiski nekad netiek izmantots.
Tātad noteikums ir šāds: visos maršrutos ārpus dynamicPaths pieteikušos lietotāju marķējumam ir jābūt baitu pa baitam identiskam anonīmo lietotāju marķējumam. Tas nozīmē, ka veidnēs, kas tiek atveidotas statiskos maršrutos, nedrīkst būt is_user_logged_in() vai wp_get_current_user() atzaru:
<?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; ?>
Ir divi vienkārši risinājumi. Ja visa lapa ir personalizēta, piemēram, konta informācijas panelis, pārvietojiet maršrutu uz dynamicPaths. Vai arī atstājiet lapu statisku un atveidojiet personalizēto daļu kā dinamisku bloka salu, kas saglabātajā HTML nosūta kešatmiņai drošu vietturi un saņem īsto fragmentu paša apmeklētāja pieprasījumā:
<?php echo bs_block( array( 'name' => 'acme/greeting' ) ); ?>
Ceļvedī Personalizēti fragmenti kešotās lapās ir aprakstīts, kā izveidot šādu bloku.
Paraksta vai grafika invalidācija
invalidate nosaka, kā beidzas saglabāto dokumentu derīgums.
| Aspekts | signature (noklusējums) |
graph |
|---|---|---|
| Kas aizpilda kešatmiņu | anonīmi pieprasījumi bez saglabāta dokumenta un kešatmiņas sildītājs | jūsu būvēšanas solis un anonīmi pieprasījumi bez saglabāta dokumenta |
| Kas izbeidz ierakstu derīgumu | TTL, ziņu saglabāšana, vietnes līmeņa izmaiņas | jauna būvēšana; TTL ir maksimālais termiņš |
| Fona kešatmiņas sildītājs | pieejams | izslēgts |
| Piemērots | parastām vietnēm | vietnēm ar izvietošanas konveijeru |
signature režīmam nav vajadzīgi papildu rīki. Saglabājot ziņu, sākumlapa un šīs ziņas pastāvīgā saite tiek iztīrīta no kešatmiņas vai tajā atkārtoti ielādēta, savukārt vietnes līmeņa izmaiņas, piemēram, tēmas maiņa, maina kešatmiņas identitāti.
graph režīms paredzēts deterministiskai izvietošanai. Būvēšana aprēķina plānu ar Static_Prerender_Runtime::build_plan(), atveido tikai skartos URL, reģistrē katru rezultātu un ar Static_Prerender_Early_Serve::install_artifact_entry() aktivizē pabeigto kopu atomiski. Ja kāda atsauktā dokumenta validācija neizdodas, iepriekšējā kopa paliek aktīva. Kartētie maršruti tiek apkalpoti no aktivizētā artefakta, līdz to aizstāj nākamā būvēšana, tāpēc wp-admin rediģētais saturs šajos maršrutos nonāk līdz ar nākamo izvietošanu. Šajā režīmā katra URL kešatmiņas sildītājs ir izslēgts, jo artefakti tiek būvēti un aktivizēti kā viena vienība. Tipiska produkcijas konfigurācija izskatās šādi:
{
"performance": {
"profile": "speed",
"staticPrerender": {
"enabled": true,
"invalidate": "graph",
"ttl": 2592000,
"earlyServe": true,
"serveLoggedIn": true,
"dynamicPaths": [
"/account",
"/cart",
"/checkout",
"/login",
"/reset-password"
]
}
}
}
30 dienu ttl tikai nosaka maksimālo vecumu apkalpotam dokumentam. Aktualitāti nodrošina izvietošana, kurā grafiks tiek būvēts no jauna. Būvēšanas API, sadalīšana daļās un iekšējais atveidošanas transports ir aprakstīti Statiskās priekšatveidošanas uzziņu ceļvedī.
Ievietojot priekšā CDN
Priekšatveidošana jau norāda, kuras atbildes ir droši kopīgot: tieši tās, kurām ir HIT galvene. Ļaujiet sākotnējam serverim to pārvērst par kešatmiņas galveni un ļaujiet CDN sekot sākotnējā servera norādēm. Ar nginx PHP-FPM priekšā:
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;
}
}
Regulārā izteiksme atbilst gan HIT, gan HIT-EARLY. Visām pārējām atbildēm mainīgais ir tukšs, un nginx nepievieno galveni ar tukšu vērtību, tāpēc pieprasījumi bez trāpījuma, dinamiskie ceļi un pieteikušos lietotāju atveidojumi neatstāj sākotnējā serverī kopīgotas kešatmiņas termiņu.
No CDN puses:
- Kešojiet HTML tikai tad, ja sākotnējais serveris norāda kešatmiņas termiņu. Atspējojiet noklusējuma malas TTL atbildēm, kurām tāda nav.
- Apejiet malas kešatmiņu tiem pašiem sīkfailiem, kurus Blockstudio uzskata par personalizējošiem (
wordpress_logged_in_,wp-postpass_,comment_author_email_), kā arī jūsudynamicPaths,wp-adminunwp-json. - Pēc katras izvietošanas, kurā mainās lapas, veidnes vai resursi, iztīriet CDN no kešatmiņas. Sākotnējā servera kešatmiņa mainās pati, bet mala par to neuzzina.
Ja izmantojat Tailwind kopā ar "output": "link", stila lapa URL satur satura jaucējvērtību, tāpēc šim ceļam var iestatīt ilgstošu nemaināmas kešatmiņas galveni.
Uzturēšanas komandas
wp bs prerender warm
wp bs prerender status
wp bs prerender purge
wp bs teardown
warm pievieno rindai novecojušus publiskos URL un katrā izpildē atveido līdz warm.concurrency no tiem, izvadot kopsavilkumu JSON. purge noņem pašreizējās vietnes saglabātos dokumentus un rindu. teardown noņem cron notikumus un šai instalācijai piederošo agrīnās apkalpošanas stāvokli, neaizskarot konfigurācijas failus.
Izvietojiet šādā secībā: vispirms profilēšanu, pēc tam priekšatveidošanu ar izslēgtu earlyServe un visbeidzot agrīno apkalpošanu, kad status un galvenes izskatās pareizi. Katru slāni var atsevišķi atcelt, atiestatot tā vērtību.
Nākamās darbības
- Statiskās priekšatveidošanas uzziņu ceļvedis: grafu būvēšana, artefaktu aktivizēšana, glabāšana un novērojamības āķi.
- Veiktspēja: ko maina
speedprofils un kā to izmērīt. - Kešošana: direktorijs, kurā glabājas visi saglabātie dokumenti.
- Personalizēti fragmenti kešotās lapās: katram apmeklētājam pielāgots saturs statiskos maršrutos.
- Vietnes Blockstudio izvietošana: kā lapu sinhronizēšana, kešatmiņas iztīrīšana un sildīšana iekļaujas laidienā.