WordPress kaip statinė HTML paslauga
Dauguma rinkodaros ar dokumentacijos svetainės puslapių visiems neprisijungusiems lankytojams yra vienodi. WordPress vis tiek paleidžiamas, įkelia kiekvieną įskiepį, vykdo temą ir atvaizduoja blokus kiekvienai užklausai. Puslapių talpyklos įskiepis gali padėti, bet tai dar vienas komponentas su savomis saugaus saugojimo taisyklėmis.
Blockstudio turi pasirenkamą statinį išankstinį generavimą. Jis išsaugo visus neprisijungusiems skirtus HTML dokumentus atskirame talpyklos kataloge ir, jei leidžiate, pateikia juos iš advanced-cache.php įskiepio dar prieš paleidžiant WordPress. Viskas konfigūruojama blockstudio.json.
Šiame vadove žingsnis po žingsnio įjungiama ši funkcija, parodoma, kaip patikrinti, kas saugoma talpykloje, paaiškinama vienintelė taisyklė, apsauganti prisijungusius lankytojus, o pabaigoje pateikiama CDN sąranka, kuri talpykloje saugo tik tai, ką šaltinis pažymi kaip tinkamą saugoti.
Kaip pateikiama užklausa
Įjungus išankstinį generavimą, tinkama užklausa baigiasi vienu iš trijų būdų:
- Ankstyvasis talpyklos pataikymas. Įskiepis randa išsaugotą dokumentą maršrutų žemėlapyje ir perduoda jį dar prieš įkeliant WordPress. Atsakyme yra
X-Blockstudio-Static-Prerender: HIT-EARLY. - Talpyklos pataikymas. WordPress paleidžiamas, o ties
template_redirectBlockstudio randa naują išsaugotą dokumentą ir jį pateikia, užuot atvaizdavęs šabloną. Atsakyme yraX-Blockstudio-Static-Prerender: HIT. - Talpyklos praleidimas. WordPress puslapį atvaizduoja įprastai. Jei lankytojas neprisijungęs, rezultatas yra visas HTML dokumentas, o būsena – 200, Blockstudio išsaugo jį kitai užklausai.
Netinkamos užklausos talpyklos apskritai nepasiekia.
1 žingsnis: įjunkite profilį ir talpyklą
Pradėkite nuo našumo profilio ir išankstinio generavimo, išjungę ankstyvąjį pateikimą:
{
"$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
}
}
}
}
Ką daro kiekviena dalis:
profile: "speed"įjungia produkcinės aplinkos priekinės dalies numatytąsias nuostatas: pašalinami antraštės pertekliniai duomenys, oEmbed aptikimas, XML-RPC ir bendrieji pagrindinės sistemos priekinės dalies ištekliai, o tos pačios kilmės nuorodos iš anksto įkeliamos esant naudotojo ketinimui. Pirmiausia patikrinkite pagrindinės sistemos priekinės dalies išteklių šalinimo nustatymą, nes nuo jų priklausantis puslapis gali akivaizdžiai sugesti. Antrinio lygio reikšmės perrašo profilį.staticPrerender.enabledužregistruoja vykdymo aplinką. Kai funkcijafalse, ji nekuria failų ir neregistruoja užklausų kablių.ttlyra maksimalus saugomo dokumento amžius sekundėmis (numatytoji reikšmė86400).dynamicPathsnurodo kelių prefiksus, kuriuos visada reikia atvaizduoti dinamiškai.warmsuplanuoja foninį talpyklos užpildymo procesą, kuris kasintervalsekundžių iš naujo atvaizduoja nebeaktualius viešus URL.
Eilutė $schema apima visus raktus, todėl redaktorius su JSON schemų palaikymu aptinka klaidą, pvz., "ttl": 0 (mažiausia reikšmė yra 1).
2 žingsnis: sužinokite, kas tinkama talpyklai
Blockstudio atsargiai renkasi, ką saugoti. Šios užklausos visada apeina talpyklą:
- visos užklausos, išskyrus
GET - bet kuris URL su užklausos eilute
wp-admin,wp-json,wp-login.php,xmlrpc.php, Ajax ir cron- sklaidos kanalų, paieškos ir peržiūros keliai
- užklausos su
X-WP-Nonceantrašte - keliai po
dynamicPaths - lankytojai, turintys
wordpress_logged_in_*,wp-postpass_*arbacomment_author_email_*slapuką, nebent įjungtaserveLoggedIn
Dinaminiai keliai nustatomi pagal kelio ribas. Esant pirmiau nurodytai konfigūracijai:
| Užklausa | Apeinama talpykla |
|---|---|
/pricing/ |
ne |
/account/orders/ |
taip |
/accounting/ |
ne |
/checkout |
taip |
/pricing/?utm_source=x |
taip |
/blog/feed/ |
taip |
Saugoma tik visas dokumentas: atsakymas turi prasidėti <!doctype html arba <html, jo būsena turi būti 200, jame neturi būti atsisakymo žymeklio. Šablonas, kurio niekada negalima saugoti, gali bet kurioje puslapio vietoje išvesti žymeklį:
<!-- blockstudio:no-cache -->
Klaidų puslapiai niekada nesaugomi, todėl stilizuotas 404 niekada negali būti pateiktas kaip sėkmingas atsakymas.
3 žingsnis: patikrinkite pataikymus
Apsilankykite keliuose puslapiuose privačiame lange, tada paprašykite Blockstudio parodyti, kas saugoma:
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 ir bytes didėja saugant dokumentus, queue rodo laukiančius talpyklos užpildymo darbus, o diagnostics pateikia atskirus skaitiklius pagal sritį: pataikymų, praleidimų, kūrimų ir nesėkmių. Norėdami patikrinti vieną puslapį, pateikite jo užklausą du kartus kaip neprisijungęs lankytojas ir ieškokite antraštės:
curl -s -o /dev/null -D - https://example.com/pricing/ | grep -i x-blockstudio-static-prerender
Antrajame atsakyme yra X-Blockstudio-Static-Prerender: HIT. Naudokite GET, kaip nurodyta pirmiau: curl -I siunčia HEAD užklausą, kuri visada apeina talpyklą.
4 žingsnis: pateikite anksčiau, nei paleidžiamas WordPress
Kai pataikymai atrodo teisingi, nustatykite "earlyServe": true. Tada Blockstudio valdo tris nedidelius būsenos elementus: wp-content/advanced-cache.php įskiepį, bendrą wp-content/blockstudio-static-prerender-map.php maršrutų žemėlapį ir WP_CACHE deklaraciją faile wp-config.php. Jie įdiegiami kitos administravimo užklausos metu.
Kelios taisyklės užtikrina saugų veikimą bendrojo prieglobos plano aplinkoje ir kelių svetainių tinkle:
- Blockstudio niekada neperrašo papildinio, susiejimo žemėlapio ar
WP_CACHEeilutės, kurios nevaldo. Jeiadvanced-cache.phpjau priklauso kitam podėlio įskiepiui, ankstyvasis pateikimas lieka išjungtas. - Jei
WP_CACHEjau apibrėžtas kaiptrue,wp-config.phppaliekamas nepakeistas. Jei prieglobojewp-config.phpneįrašomas, apibrėžkite jį patys. - Prieš pateikdami turinį, ir papildinys, ir kelias PHP patikrina, ar vis dar yra dokumento susiejamo turinio maiša pažymėtas Tailwind stilių failas. Jei jo nėra, užklausa perduodama WordPress, kad puslapis nebūtų pateiktas be stilių.
- Multisite įrašai naudoja vieną susiejimo žemėlapį, bet yra atskirti pagal prieglobos vardą, pagrindinį kelią ir svetainės ID.
- Kiekvienas dokumentas išsaugomas su atsakymo antraštėmis, nurodytomis
replayHeaders; numatytoji reikšmė yraLink. Jos vėl siunčiamos kiekvieno apsilankymo metu, todėlheader()siunčiamaLinkantraštė išlieka ir ankstyvojo pateikimo metu. Slapukų ir podėlio antraštės niekada nepersiunčiamos.
Ankstyvosios užklausos turi X-Blockstudio-Static-Prerender: HIT-EARLY. Išjungus
earlyServe arba enabled, vieną kartą pašalinama Blockstudio valdoma būsena, o
wp bs teardown ją pašalina aiškiai tuose Composer įdiegimuose, kuriuose nėra išjungimo kablio.
Prisijungę lankytojai ir identiškas žymėjimas
Pagal numatytuosius nustatymus prisijungę lankytojai visada gauna tiesiogiai sugeneruotą turinį. Nustačius
"serveLoggedIn": true, jie taip pat gali naudoti jau išsaugotą dokumentą,
todėl redaktoriams ir klientams svetainė veikia taip pat greitai kaip anoniminiams
lankytojams.
Suasmeninti atsakymai niekada nesukuria podėlio įrašų: jei prisijungusio lankytojo turinio nėra, jis sugeneruojamas tiesiogiai ir neišsaugomas. Šią pasekmę lengva pražiūrėti. Kai įjungta
serveLoggedIn, prisijungęs lankytojas gauna anoniminį dokumentą, jei toks yra, o suasmenintą tiesiogiai sugeneruotą turinį – tik jei jo nėra. Bet kuri šablono šaka, priklausanti nuo dabartinio naudotojo, suveikia tik tada, kai turinio nėra, todėl tas pats puslapis skirtingų apsilankymų metu keičiasi, o suasmeninta šaka podėlyje laikomuose maršrutuose faktiškai niekada nesuveikia.
Iš to kyla ši taisyklė: kiekviename maršrute už dynamicPaths ribų prisijungusiems ir anoniminiams lankytojams skirtas žymėjimas turi būti identiškas baitas į baitą. Tai reiškia, kad šablonuose, kurie pateikiami statiniuose maršrutuose, negali būti is_user_logged_in() ar wp_get_current_user() šakų:
<?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; ?>
Yra du paprasti sprendimai. Jei visas puslapis suasmenintas, perkelkite maršrutą į dynamicPaths, pavyzdžiui, paskyros skydelį. Arba palikite puslapį statinį ir asmeninę dalį pateikite kaip dinaminį bloko elementą: išsaugotame HTML jis pateikia podėliui saugią rezervuotąją vietą, o tikrąją iškarpą gauna atskiroje lankytojo užklausoje:
<?php echo bs_block( array( 'name' => 'acme/greeting' ) ); ?>
Vadove Suasmenintos iškarpos podėlyje laikomuose puslapiuose aprašoma, kaip sukurti tokį bloką.
Parašo arba grafiko invalidavimas
invalidate nustato, kaip baigiasi išsaugotų dokumentų galiojimas.
| Savybė | signature (numatytasis) |
graph |
|---|---|---|
| Kas užpildo podėlį | anoniminės užklausos be įrašų ir podėlio apšildymo procesas | jūsų kūrimo procesas ir anoniminės užklausos be įrašų |
| Dėl ko baigiasi įrašų galiojimas | TTL, įrašų išsaugojimas, svetainės lygmens pakeitimai | naujas kūrimas, o TTL yra viršutinė riba |
| Foninis podėlio apšildymas | galimas | išjungtas |
| Tinka | įprastoms svetainėms | svetainėms su diegimo procesu |
signature režimui nereikia jokių įrankių. Išsaugojus įrašą, pradinis puslapis ir to įrašo nuolatinė nuoroda pašalinami iš podėlio arba jame atnaujinami, o pakeitus svetainės lygmens nustatymus, pavyzdžiui, temą, pasikeičia podėlio tapatybė.
graph režimas skirtas deterministiniams diegimams. Kūrimo procesas apskaičiuoja planą naudodamas Static_Prerender_Runtime::build_plan(), pateikia tik paveiktus URL adresus,
įrašo kiekvieną rezultatą ir aktyvuoja visą užbaigtą rinkinį vienu veiksmu su
Static_Prerender_Early_Serve::install_artifact_entry(). Jei nepavyksta patikrinti kurio nors nurodyto dokumento, ankstesnis rinkinys lieka aktyvus. Susieti maršrutai pateikiami iš aktyvuoto artefakto, kol kitas kūrimas jį pakeičia, todėl turinys, redaguotas per wp-admin, tuos maršrutus pasiekia su kitu diegimu. Šiuo režimu vienam URL skirtas podėlio apšildymas išjungtas, nes artefaktai kuriami ir aktyvuojami kaip vienas vienetas. Įprasta gamybinės aplinkos konfigūracija atrodo taip:
{
"performance": {
"profile": "speed",
"staticPrerender": {
"enabled": true,
"invalidate": "graph",
"ttl": 2592000,
"earlyServe": true,
"serveLoggedIn": true,
"dynamicPaths": [
"/account",
"/cart",
"/checkout",
"/login",
"/reset-password"
]
}
}
}
30 dienų ttl tik apriboja, kiek senas gali būti pateikiamas dokumentas. Naujausias turinys gaunamas diegimo metu atkūrus grafą. Kūrimo API, skaidymas į dalis ir vidinis pateikimo transportas aprašyti Statinio išankstinio pateikimo nuorodoje.
Priekyje pridėkite CDN
Išankstinio pateikimo procesas jau nurodo, kuriais atsakymais saugu dalytis: būtent tais, kurie turi HIT antraštę. Leiskite serveriui ją paversti podėlio antrašte, o CDN sekite serverio nurodymais. Kai priešais PHP-FPM naudojamas nginx:
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;
}
}
Reguliarioji išraiška atitinka ir HIT, ir HIT-EARLY. Visų kitų atsakymų atveju kintamasis tuščias, o nginx neprideda antraštės su tuščia reikšme, todėl užklausos be podėlio įrašo, dinaminiai keliai ir prisijungusių naudotojų turinys negauna bendro podėlio galiojimo trukmės iš serverio.
CDN pusėje:
- Podėlyje laikykite HTML tik tada, kai serveris nurodo podėlio galiojimo trukmę. Išjunkite numatytąjį briaunos TTL atsakymams, kuriems tokia trukmė nenurodyta.
- Apeikite briauną tiems patiems slapukams, kuriuos Blockstudio laiko suasmeninimo požymiu
(
wordpress_logged_in_,wp-postpass_,comment_author_email_), taip pat jūsųdynamicPaths,wp-adminirwp-json. - Po kiekvieno diegimo, pakeičiančio puslapius, šablonus ar išteklius, išvalykite CDN. Pradinio serverio podėlis atsinaujina pats, o briauna apie tai nežino.
Jei naudojate Tailwind su "output": "link", stiliaus failas URL identifikuojamas pagal turinį, todėl šiam keliui galima nustatyti ilgalaikę nekintamo podėlio antraštę.
Priežiūros komandos
wp bs prerender warm
wp bs prerender status
wp bs prerender purge
wp bs teardown
warm į eilę įtraukia pasenusius viešuosius URL adresus ir per vykdymą pateikia iki warm.concurrency jų, išspausdindama JSON suvestinę. purge pašalina dabartinės svetainės išsaugotus dokumentus ir eilę. teardown pašalina cron įvykius ir šio diegimo valdomą ankstyvo pateikimo būseną, o konfigūracijos failų neliečia.
Diekite šia tvarka: pirmiausia profilį, tada išankstinį pateikimą su išjungtu earlyServe, o galiausiai ankstyvą pateikimą, kai status ir antraštės atrodo tinkamai. Kiekvieną sluoksnį galima atskirai grąžinti į ankstesnę būseną, atkūrus ankstesnę jo reikšmę.
Tolesni veiksmai
- Statinio išankstinio pateikimo nuoroda: grafų kūrimas, artefaktų aktyvavimas, saugojimas ir stebėjimo kabliai.
- Našumas: ką pakeičia
speedprofilis ir kaip tai išmatuoti. - Podėlio naudojimas: podėlio katalogas, kuriame laikomi visi dokumentai.
- Suasmenintos iškarpos podėlyje laikomuose puslapiuose: kiekvienam lankytojui skirtas turinys statiniuose maršrutuose.
- Blockstudio svetainės diegimas: kaip puslapių sinchronizavimas, podėlio išvalymas ir apšildymas įtraukiami į leidimą.