Statikus előrenderelés
A statikus előrenderelés egy opcionálisan bekapcsolható, névtelen HTML gyorsítótár. A gyorsítótárazható válasznak teljes HTML dokumentumnak kell lennie, és a <!-- blockstudio:no-cache --> beállítással letiltható. Az Blockstudio kihagyja a nem GET kéréseket, a lekérdezési karakterláncokat, az WordPress adminfelületet, az REST, Ajax- és cron útvonalakat, a hírcsatornákat, a keresési alapútvonal alatti keresési találatokat a webhely kezdőlapján (például /search/term/), az előnézeti és vászonfejléceket, a nonce-ot tartalmazó kéréseket, a megadott dinamikus útvonalakat, a jelszó- és hozzászólás-sütiket, valamint alapértelmezés szerint a bejelentkezett felhasználók kéréseit. Ha egy útvonalban csak mélyebben szerepel search vagy preview szegmens, például /docs/blocks/preview/, akkor a rendszer ugyanúgy gyorsítótárazza, mint bármely más oldalt.
{
"performance": {
"staticPrerender": {
"enabled": true,
"ttl": 3600,
"invalidate": "graph",
"earlyServe": true,
"serveLoggedIn": false,
"dynamicPaths": ["/account", "/checkout"],
"replayHeaders": ["Link"],
"warm": {
"enabled": true,
"interval": 900,
"concurrency": 4,
"transport": "http"
}
}
}
}
A bejelentkezett felhasználók csak akkor használhatnak egy meglévő találatot, ha serveLoggedIn igaz; személyre szabott válaszok soha nem hoznak létre gyorsítótár-bejegyzést. A dinamikus útvonalaknál a határokat is figyelembe veszi a rendszer, ezért a /account illeszkedik a /account/orders útvonalra, de a /accounting útvonalra nem.
Amíg a funkció ki van kapcsolva, nem ír fájlokat, nem telepít drop-in modult, és nem regisztrál kéréshez vagy adminfelülethez kapcsolódó horgokat. Az earlyServe: false sem regisztrál Early Serve adminisztrációs visszahívást, az warm.enabled: false pedig nem regisztrál cron visszahívást vagy ütemezést. Bármelyik funkció kikapcsolásakor a korábban hozzá tartozó állapot egyszer törlődik; a későbbi kérések már nem végeznek fájlrendszer- vagy cron-tisztítási ellenőrzéseket.
Kikapcsolás környezetenként
A fenti értékek mindegyike beállítható egy beállításszűrővel is. Az Blockstudio az aktív sablon előtt indul el, egy bővítményből vagy a sablon Composer automatikus betöltéséből, ezért a sablon betöltése után ismét feloldja a futásidejű beállításait, és az after_setup_theme során dönt a statikus előrenderelési horgokról. Ezért egy bővítményben vagy a sablon functions.php fájljában hozzáadott szűrő érvénybe lép:
add_filter('blockstudio/settings/performance/staticPrerender/enabled', function ($enabled) {
return 'local' === wp_get_environment_type() ? false : $enabled;
});
A funkció ilyen módon történő kikapcsolása ugyanúgy működik, mint az blockstudio.json beállításban: nem regisztrálódik kéréshez, tartalomhoz, adminfelülethez vagy cron kapcsolódó horgok, és ha egy webhelyet korábban korai kiszolgálással szolgáltak ki, az Early Serve-bejegyzése egyszer törlődik. Egy később, például init során hozzáadott szűrő nem módosítja a regisztrált horgokat.
Aláírási és gráf módok
Az signature mód egy normál, névtelen gyorsítótárhiba esetén identitáskulcsú választ tölt be. Kényelmes a szokásos WordPress webhelyekhez, és a webhely szintű változtatások után új aláírást kap.
Az graph mód determinisztikus build- és telepítési integrációkhoz készült. Hívja meg a Static_Prerender_Runtime::build_plan() függvényt az élő forrás-URL-ekkel, csak az affectedUrls útvonalakat renderelje, majd rögzítse az eredményeket a persist_built_response() vagy a persist_skipped_response() használatával. A terv összehasonlítja a közös fájlokat és az egyes oldalak pontos függőségi kivonatait. A törölt URL-eket és a nem hivatkozott HTML elemeket az garbage_collect() távolítja el.
use Blockstudio\Static_Prerender_Runtime;
$plan = Static_Prerender_Runtime::build_plan($sourceUrls);
foreach ($plan['affectedUrls'] as $url) {
$result = render_with_dependencies($url);
Static_Prerender_Runtime::persist_built_response(
$url,
$result['html'],
$result['files'],
$result['virtualHashes']
);
}
$targets = array_keys($plan['live']);
Static_Prerender_Runtime::garbage_collect($targets);
Az opcionális célgazda- és kezdőlap-argumentumokkal átírhatók az útvonalak egy telepítéshez anélkül, hogy az első oldal útvonalát használná a rendszer a webhely gyökereként. A kötegelt eszközök használhatják a Static_Prerender_Batch_Renderer::render() függvényt és a stabil N/TOTAL részeket; a Static_Prerender_Batch_Renderer::parse_shard() és a select_shard() szolgál a részek beállítására, így a hívó kiszámíthatja ugyanazt a felosztást, amelyet a renderelő használna. Build közben az Static_Prerender_Batch_Renderer::is_rendering() megmutatja, hogy a jelenlegi kérés kötegelt renderelés-e, vagy látogatótól érkezik, így a sablon kihagyhatja a build során nem futtatható munkát. Az internal átvitelt az általános blockstudio/static_prerender/render_internal szűrő biztosítja; az opcionális HTTP tartalék a szokásos melegítési fejlécet használja.
Mit követ a gráf mód
Az alapértelmezett HTTP átvitellel az Static_Prerender_Batch_Renderer::render() minden melegítési kéréshez aláírt tokent küld, a kérés pedig jelentést küld az általa beolvasott fájlokról: a sablonról, amelyet az WordPress betöltött, minden renderelt Blockstudio blokk sablonjáról, sablonfájljairól és eszközfájljairól, az blockstudio/render/dependencies által hozzáadott fájlokról, valamint szinkronizált oldal esetén annak definíciós, sablon-, tartalom- és elrendezésfájljairól. A jelentés a webhely gyorsítótár-könyvtárába kerül, amelyen a renderelő és a webszerver már osztozik a renderelt HTML fájlokhoz. A következő build során az build_plan() ismét kivonatot készít ezekről a fájlokról, és csak azokhoz az útvonalakhoz, valamint az új útvonalakhoz ad jelölést, amelyek fájljai megváltoztak, amelyek elérték a ttl értéket, továbbá minden útvonalhoz, ha egy közös fájl megváltozik (blockstudio.json, theme.json, style.css, functions.php, header.php, footer.php, minden, ami az inc/ alatt található, parts/ és templates/, valamint az Blockstudio csomagolt UI eszközeinek forrásai). A közös aláírás a forrásokból, soha nem a lefordított kimenetből készül, így a build első renderelésekor a _dist fájlokon végzett fordítás nem módosítja: az artifact_entry() abból az aláírásból állapítja meg a build azonosítóját, amelyet az build_plan() a renderelés előtt látott.
Az adatbázisban tárolt, de kizárólag ott létező tartalom nem fájl, ezért a rendszer nem követi: ilyenek az adminfelületen szerkesztett bejegyzések, beállítások, generált sorok és árak. Ha a buildnek ezeket a változtatásokat is figyelembe kell vennie, adja át az $force értéket az build_plan() számára, vagy renderelje le saját maga az érintett URL-eket. Az internal átvitel rögzíti a szűrő által visszaadott függőségeket.
Korai kiszolgálás és atomi telepítés
Ha az earlyServe engedélyezve van, az Blockstudio kezeli a kis wp-content/blockstudio-static-prerender-map.php fájlt, egy advanced-cache.php drop-in modult és egy pontos WP_CACHE deklarációt. A drop-in modul beolvassa a webhelyenkénti útvonaltérképet, és a jogosult találatot még az WordPress, a bővítmények vagy a sablon indulása előtt továbbítja.
Az Blockstudio soha nem ír felül idegen térképet, drop-in modult vagy WP_CACHE deklarációt. A gráfban lévő elemek érvényesség-ellenőrzése minden hivatkozott HTML fájlt megvizsgál a térkép cseréje előtt; érvényesítési hiba esetén az előző gráf marad aktív. A több webhelyes bejegyzések közös térképet használnak, de gazdagép, kezdőlap-útvonal és webhelyazonosító szerint elkülönülnek. A funkció kikapcsolásakor vagy az Blockstudio deaktiválásakor csak az aktuális webhely bejegyzése törlődik; a megosztott elemek pedig csak az utolsó, saját kezelésű bejegyzés eltűnése után kerülnek törlésre.
A telepítőeszközök atomi módon aktiválhatnak egy teljesen renderelt gráfot:
$entry = Static_Prerender_Runtime::artifact_entry($targetUrls);
Blockstudio\Static_Prerender_Early_Serve::install_artifact_entry(
$entry,
Static_Prerender_Runtime::cache_root_path()
);
A konfiguráció marad a mérvadó. Az install_artifact_entry() visszaadja az false értéket, kivéve, ha az enabled és az earlyServe is igaz; így a telepítés soha nem helyezhet el olyan térképet, drop-in modult és WP_CACHE deklarációt, amelyet a következő adminisztrációs kérés ismét eltávolítana.
Az install_artifact_entry() megőrzi a bejegyzés build_id értékét, így a telepítés összehasonlíthatja azt azzal, amit az installed_map_entries() utólag visszaad. A térkép egy PHP fájl, amelyet az include olvas be, és minden írás eltávolítja a fájlt az opkód-gyorsítótárból, így ugyanabban a folyamatban is az új bejegyzés olvasható, ha az opcache.enable_cli be van kapcsolva.
Egy elem telepítése az ahhoz tartozó dokumentumokat külön elemhatókörbe helyezi, amelyet a megőrzési szabályok szerinti tisztítás soha nem érint; a térkép által hivatkozott fájlok pedig bárhol is legyenek, mentesülnek a törlés alól, így az élő renderelési forgalom nem szoríthatja ki a korai kiszolgálásból a feltérképezett útvonalakat. Az útvonalkulcs nem teljesen tartalomcímzett, ezért az újrarenderelés megváltoztathat egy dokumentumot anélkül, hogy a kulcsa megváltozna. A telepítés összehasonlítja a bájtokat, és eltérés esetén atomikusan lecseréli az elem dokumentumát, az azonos dokumentumokat érintetlenül hagyja, az eltűnt tárolópéldánnyal rendelkező elem dokumentumát pedig megőrzi. Az Static_Prerender_Early_Serve::last_promotion() jelentést ad arról, hogy az utolsó telepítés hány útvonalat helyezett át, cserélt le, hagyott ki vagy tartott meg, így a telepítés naplózhatja ezeket az adatokat.
A tárolt dokumentum az URL alapján rögzíti a hivatkozott build-eszközök verzióját, és ezeknek a fájloknak külön megőrzési idejük van, ezért az egyik tovább maradhat, mint a másik. Kiszolgálás előtt az PHP gyorsítótár és a drop-in is ellenőrzi, hogy a hivatkozott, tartalomhash-alapú Tailwind stíluslap továbbra is létezik-e a lemezen. Ha a dokumentum stíluslapja hiányzik, a rendszer az WordPress részére adja át a dokumentumot formázás nélküli kiszolgálás helyett; ez együtt teszi közzé újra a stíluslapot és a dokumentumot. Ugyanez az ellenőrzés a válasz tárolása előtt is lefut, így soha nem kerül tárolásra olyan dokumentum, amelyet nem lehetett kiszolgálni.
Ha egy kérés Accept fejléce text/markdown értéket tartalmaz, megkerüli az PHP tárolót és a drop-in modult is, mert a tárolt dokumentumok HTML formátumúak, és az oldal erre a kérésre a forrás-Markdown tartalmat adhatja vissza. Ezért a kiszolgált dokumentumok Vary: Accept fejlécet küldenek. Az Blockstudio frissítésekor a következő térképírás egy régebbi drop-in modult ír felül.
A feltérképezett gráf útvonalai mindig az aktivált elemet használják. Ha egy biztonságos, névtelen útvonal nincs a térképen, de az WordPress időközben renderelte és elmentette, az Early Serve a rendszerindítás előtt a futásidejű, identitáskulcsú tárolóból kérdezi le a dokumentumot az WordPress betöltése előtt. Ez támogatja az előre meghatározott méretkorláton kívül eső generált vagy ritkán látogatott útvonalakat. A tartalék ugyanazt az aktivált gráfazonosítót, gazdagépet, útvonal-normalizálást, TTL-t, sütikre, fejlécekre, lekérdezési karakterláncokra, dinamikus útvonalakra és hírcsatornákra vonatkozó kihagyási szabályokat használja, mint a feltérképezett útvonalak, és csak a futásidejű tárolóban lévő dokumentumokat találja meg; keresési találatok soha nincsenek közöttük.
Válaszfejlécek
A tárolt dokumentumot annak a kérésnek az újbóli végrehajtása nélkül szolgáljuk ki, amely létrehozta, ezért egy olyan fejléc, amelyet egy téma vagy bővítmény a header() segítségével küld, minden találatnál hiányozna. A Blockstudio minden dokumentummal együtt tárolja a replayHeaders alatt megadott fejléceket, majd ismét elküldi őket mind a PHP gyorsítótárból, mind a korai kiszolgálást végző drop-inből. Az alapértelmezett ["Link"] olyan fejléceket tartalmaz, mint egy Markdown alternatíva (rel="alternate"; type="text/markdown"), a rel="describedby" vagy a rel="canonical". A nevek kis- és nagybetűtől függetlenül egyeznek, a beállításszűrő pedig ugyanúgy módosítja a listát, mint bármely más értéket:
add_filter('blockstudio/settings/performance/staticPrerender/replayHeaders', function (array $headers): array {
$headers[] = 'X-Robots-Tag';
return $headers;
});
Állítsa a replayHeaders értékét erre: [], ha le szeretné tiltani a fejlécek újbóli elküldését. A megadott lista felülírja az alapértelmezettet, ezért más fejlécek hozzáadásakor vegye fel a Link elemet is, ha továbbra is szeretné újból elküldeni a hivatkozási fejléceket.
A fejléceket az az oldalrenderelő folyamat rögzíti, amelyben a headers_list() egy élő gyorsítótár-missz tárolásakor, illetve maga a bemelegítő kérés egy build vagy a gyorsítótár-bemelegítő által végzett HTTP renderelésekor fut; ezért a webszerver által önállóan hozzáadott, majd minden kiszolgált dokumentumhoz ismét hozzáadott fejlécet soha nem tárolja. Csak akkor használja fel a válasz fejléceit, ha egy HTTP renderelés nem ad jelentést. A internal átviteli réteg eredményében headers formában adja vissza őket, a persist_built_response() pedig utolsó argumentumként fogadja el őket, vagy Name: value sorokként, vagy név-érték leképezésként.
A dokumentum mellett a <key>.headers.json helyre kerülnek, követik azt az artifactok előléptetése, a szemétgyűjtés és a megőrzési idő szerinti törlés során, és eltávolításra kerülnek, ha az újrarenderelés nem küld egyet sem. A cookie-, gyorsítótárazási és átviteli fejléceket soha nem tárolja és nem küldi újra, akkor sem, ha szerepelnek a listában: Set-Cookie, Cache-Control, Expires, Pragma, Age, ETag, Last-Modified, Vary, Content-Type, Content-Length, Content-Encoding, Transfer-Encoding, Location, Status, Date, továbbá az ugrásonkénti és hitelesítési fejléceket. A kiszolgált dokumentum maga állítja be a Content-Type és a Vary értékét.
A tárolt fejléceket elküldéskor ismét ellenőrzi a listával szemben. A PHP gyorsítótár az aktuális beállítást olvassa; a drop-in a webhely térképelemében található másolatot használja, amelyet a következő artifacttelepítés vagy térképszinkronizálás frissít. A frissítés előtt tárolt dokumentumokhoz nem tartozik fejlécfájl, és pontosan a korábbi módon szolgálja ki őket, amíg újra nem rendereli.
Melegítés, karbantartás és megfigyelhetőség
A melegítési sor tartós, azonos URL értékű munkákat összevon, egyszerre csak egy feladatot futtat, és helyreáll az időtúllépett zárolásokból. A tartalmi és webhelyszintű változások mindig új feladatot hoznak létre akkor is, ha az aktuális aláírás nem változott; az időközönkénti futtatások csak az elavult munkákat veszik fel a sorba. Minden futtatás, akár ütemezett, akár az wp bs prerender warm segítségével indított, legfeljebb warm.concurrency feladatot renderel. Az graph mód kikapcsolja az URL szerinti melegítést, mivel a gráfelemeket egységként kell felépíteni és aktiválni.
wp bs prerender warm
wp bs prerender status
wp bs prerender purge
wp bs prerender map status
wp bs prerender map prune --dry-run
Az status jelentést ad az aktív identitásról, a fájlokról, bájtokról, gráfrekordokról, a sor állapotáról, a korai kiszolgálás térképéről, valamint a hatókörönkénti találat-, találathiány-, build- és hibaszámlálókról.
A korai kiszolgálás térképén a telepítés minden webhelye osztozik. Az map status (és az Static_Prerender_Early_Serve::map_report()) felsorolja azokat a bejegyzéseket, amelyeket a korai kiszolgálás már nem tud használni: azokat az orphaned bejegyzéseket, amelyekhez tartozó webhely már nem létezik, valamint azokat az dead bejegyzéseket, amelyek könyvtára már nem található, továbbá a megmaradt bejegyzésekben szereplő missing útvonaldokumentumok számát. Az map prune (Static_Prerender_Early_Serve::prune_map()) a térkép zárolása alatt eltávolítja az árva és elavult bejegyzéseket, és mindegyiknél megadja az okot; az --dry-run csak jelentést készít. Az utolsó bejegyzés eltávolításakor a térkép, a drop-in modul és az WP_CACHE deklaráció is törlődik. Egy webhely több webhelyes hálózatból való törlése azonnal eltávolítja annak bejegyzéseit, a gyorsítótár tisztítása pedig soha nem gyűjti be azt a névteret, amelyből egy aktivált elem kiszolgálja a tartalmat, ezért a bejegyzések csak akkor válnak elérhetetlenné, ha a fájljaikat más módon távolítják el.
Az egyes válaszeredményeket az blockstudio/static_prerender/outcome, az összes megosztott gyorsítótár-eredményt pedig az blockstudio/cache/outcome segítségével figyelheti meg.
Eltávolítás
Azok a telepítések, amelyekből hiányzik a bővítmény-deaktiválási horg, például az Composer csomaggal érkező beállítások, egy paranccsal eltávolíthatják mindazt, amit a funkció kezel:
wp bs teardown
Eltávolítja az cron eseményeit és a telepítés által kezelt statikus előrenderelési állapotot: az aktuális webhely térképi bejegyzését, valamint a megosztott drop-in modult és az WP_CACHE deklarációt, miután az utolsó kezelt bejegyzés is eltűnt. A konfigurációs fájlok érintetlenek maradnak, így a funkció tiszta állapotból engedélyezhető újra.
Éles környezetben történő bevezetés
Egy ésszerű bevezetési sorrend:
- Állítsa az
performance.profileértékét erre:speed, majd ellenőrizze a head kimenetét, a hírcsatornákat, valamint az oEmbedre vagy XML-RPC-ra támaszkodó bővítményeket. - Hozza létre az
assets/media.jsonértéket, helyezze át a sablonokat ide:bs_media_image(), majd kapcsolja be azperformance.media.lazyfunkciót. - Engedélyezze az
performance.staticPrerenderfunkciót kikapcsoltearlyServemellett, ellenőrizze a találatokat azwp bs prerender statussegítségével, majd kapcsolja be azearlyServefunkciót.
A visszaállítás funkciónként történik: ha az staticPrerender.enabled értékét false értékre állítja, egyszer eltávolítja az Blockstudio által kezelt Early Serve-állapotot és a melegítési ütemezéseket, majd a rendszer nem regisztrálja az előrenderelési futtatókörnyezetet. Ha az performance.profile értékét visszaállítja erre: compat, a profil is visszaáll. Mindkét esetben a többi réteg érintetlen marad.
A profilok, a profilozó és az alapjukat képező renderelési technikák.
Az egyetlen gyorsítótár-könyvtár, amelyben minden generált elem megtalálható.