Statično predizrisovanje
Statično predizrisovanje je neobvezni anonimni HTML predpomnilnik. Odgovor, primeren za predpomnjenje, mora biti celoten dokument HTML in lahko iz njega izstopi z <!-- blockstudio:no-cache -->. Blockstudio obide zahteve, ki niso GET, poizvedbene nize, skrbniški del WordPress, REST, Ajax, cron, vire, rezultate iskanja pod osnovno potjo iskanja na domači poti spletnega mesta (na primer /search/term/), glave za predogled in platno, zahteve z nonce, deklarirane dinamične poti, piškotke za geslo/komentar ter privzeto tudi prijavljene zahteve. Stran, katere pot vsebuje segment search ali preview šele globlje v poti, na primer /docs/blocks/preview/, se predpomni kot katera koli druga stran.
{
"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"
}
}
}
}
Prijavljeni uporabniki lahko uporabijo obstoječi zadetek samo, kadar je serveLoggedIn resničen; personalizirani odgovori nikoli ne ustvarijo vnosov v predpomnilniku. Dinamične poti upoštevajo meje poti, zato se /account ujema z /account/orders, ne pa z /accounting.
Ko je funkcija onemogočena, ne zapisuje datotek, ne namesti dodatka in ne registrira kavljev za zahteve ali skrbniški del. earlyServe: false prav tako ne registrira skrbniškega povratnega klica Early Serve, warm.enabled: false pa ne registrira povratnega klica cron ali razporeda. Ko katero koli funkcijo izklopite, se predhodno upravljano stanje enkrat odstrani; pri naslednjih zahtevah se ne izvajajo preverjanja datotečnega sistema ali čiščenja cron.
Izklop v posameznem okolju
Vsako zgornjo vrednost je mogoče nastaviti tudi s filtrom nastavitev. Blockstudio se zažene pred aktivno temo, iz vtičnika ali iz samodejnega nalaganja Composer teme, zato znova razreši nastavitve izvajalnega okolja, ko se tema naloži, in odloči o kavljih za statično predizrisovanje ob after_setup_theme. Filter, dodan vtičniku ali v datoteki functions.php teme, zato začne učinkovati:
add_filter('blockstudio/settings/performance/staticPrerender/enabled', function ($enabled) {
return 'local' === wp_get_environment_type() ? false : $enabled;
});
Izklop funkcije na ta način deluje enako kot izklop v blockstudio.json: ne registrirajo se kavlji za zahteve, vsebino, skrbniški del ali cron, spletno mesto, ki je bilo prej postreženo zgodaj, pa enkrat odstrani svoj vnos Early Serve. Pozneje dodan filter, na primer na init, ne spremeni registriranih kavljev.
Načini podpisa in grafa
Način signature ob običajnem anonimnem zgrešenem zadetku izpolni odgovor, vezan na identiteto. Priročen je za običajna spletna mesta WordPress in se po spremembah na ravni spletnega mesta zamenja.
Način graph je namenjen determinističnim integracijam gradnje in uvajanja. Pokličite Static_Prerender_Runtime::build_plan() z aktivnimi izvornimi URL-ji, izrišite samo affectedUrls, nato pa vsak rezultat zabeležite z persist_built_response() ali persist_skipped_response(). Načrt primerja skupne datoteke in natančne zgoščene vrednosti odvisnosti vsake strani. Izbrisane URL-je in nereferencirane HTML odstrani garbage_collect().
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);
Izbirna argumenta ciljnega gostitelja in domače poti prepišeta poti za uvajanje, ne da bi bila pot prve strani uporabljena kot koren spletnega mesta. Paketna orodja lahko uporabijo Static_Prerender_Batch_Renderer::render() in stabilne razdelke N/TOTAL; možnost razdelkov podpirata Static_Prerender_Batch_Renderer::parse_shard() in select_shard(), zato lahko klicatelj izračuna isto razdelitev kot izrisovalnik. Znotraj gradnje Static_Prerender_Batch_Renderer::is_rendering() pove, ali je trenutna zahteva paketni izris in ne obiskovalec, zato lahko predloga preskoči opravila, ki se med gradnjo ne smejo izvajati. Prenos internal zagotovi splošni filter blockstudio/static_prerender/render_internal; izbirna nadomestna možnost HTTP uporabi običajno glavo za ogrevanje.
Kaj spremlja način grafa
Pri privzetem prenosu HTTP Static_Prerender_Batch_Renderer::render() vsaki zahtevi za ogrevanje pošlje podpisan žeton, zahteva pa sporoči, katere datoteke je prebrala: predlogo, ki jo je naložila predloga WordPress, predlogo vsakega izrisanega bloka Blockstudio, datoteke predlog in datoteke sredstev, datoteke, dodane prek blockstudio/render/dependencies, ter pri sinhronizirani strani njene definicijske, predlogovne, vsebinske in postavitvene datoteke. Poročilo se zapiše v imenik predpomnilnika spletnega mesta, ki si ga izrisovalnik in spletni strežnik že delita za izrisane HTML. Pri naslednji gradnji build_plan() znova izračuna zgoščene vrednosti teh datotek in označi samo poti, katerih datoteke so se spremenile, ter nove poti, poti po izteku njihovega ttl in vse poti ob spremembi skupne datoteke (blockstudio.json, theme.json, style.css, functions.php, header.php, footer.php, vse pod inc/, parts/ in templates/ ter viri sredstev UI, vključenih v paket Blockstudio). Podpis skupnih datotek zgosti izvorne datoteke, nikoli prevedenega izhoda, zato ga datoteke _dist, ki jih prevede prvi izris gradnje, ne spremenijo: artifact_entry() določi ID gradnje iz istega podpisa, ki ga je build_plan() zaznal pred izrisom.
Vsebina, ki obstaja samo v zbirki podatkov, ni datoteka in se ne spremlja: objave, urejene v skrbniškem delu, možnosti, ustvarjene vrstice ali cene. Gradnja, ki mora vključiti take spremembe, posreduje $force v build_plan() ali sama izriše zadevne URL-je. Prenos internal beleži odvisnosti, ki jih vrne njegov filter.
Zgodnje postrežanje in atomsko uvajanje
Ko je omogočen earlyServe, Blockstudio upravlja majhen wp-content/blockstudio-static-prerender-map.php, dodatek advanced-cache.php in eno natančno deklaracijo WP_CACHE. Dodatek prebere zemljevid poti za posamezno spletno mesto in pred zagonom WordPress, vtičnikov ali teme pretočno postreže primeren zadetek.
Blockstudio nikoli ne prepiše tujega zemljevida, dodatka ali deklaracije WP_CACHE. Artefakti grafa pred zamenjavo zemljevida preverijo vsako navedeno datoteko HTML; če preverjanje ne uspe, prejšnji graf ostane aktiven. Vnosi v večmestni namestitvi si delijo zemljevid, vendar so ločeni po gostitelju, domači poti in ID-ju spletnega mesta. Če funkcijo onemogočite ali deaktivirate Blockstudio, se odstrani samo vnos trenutnega spletnega mesta, skupni artefakti pa šele, ko izgine zadnji upravljani vnos.
Orodja za uvajanje lahko atomsko aktivirajo v celoti izrisan graf:
$entry = Static_Prerender_Runtime::artifact_entry($targetUrls);
Blockstudio\Static_Prerender_Early_Serve::install_artifact_entry(
$entry,
Static_Prerender_Runtime::cache_root_path()
);
Konfiguracija ostaja merodajna. install_artifact_entry() vrne false, razen če sta enabled in earlyServe oba resnična, zato uvajanje ne more namestiti zemljevida, dodatka in deklaracije WP_CACHE, ki bi jih naslednja skrbniška zahteva znova odstranila.
install_artifact_entry() ohrani build_id vnosa, zato ga lahko uvajanje primerja z vrednostjo, ki jo pozneje vrne installed_map_entries(). Zemljevid je datoteka PHP, prebrana z include, vsak zapis pa jo odstrani iz predpomnilnika opcode, zato branje v istem procesu zazna nov vnos, tudi ko je vklopljen opcache.enable_cli.
Namestitev artefakta njegove dokumente prenese v namenski obseg artefaktov, ki se ga čiščenje po pravilih hrambe nikoli ne dotakne; datoteke, na katere se sklicuje zemljevid, so zaščitene pred odstranitvijo, kjer koli se nahajajo. Tako jih promet izrisovanja v živo ne more postarati in odstraniti iz zgodnjega postrežanja. Ključ poti ni v celoti vsebinsko naslovljen, zato lahko ponovni izris spremeni dokument, ne da bi spremenil njegov ključ. Namestitev primerja bajte in atomsko zamenja dokument artefakta, če se razlikuje, enake dokumente pusti pri miru, dokument artefakta pa ohrani tudi, če njegova kopija v shrambi manjka. Static_Prerender_Early_Serve::last_promotion() poroča, koliko poti je zadnja namestitev prenesla, zamenjala, preskočila ali ohranila, zato jih je mogoče zabeležiti v dnevnik uvajanja.
Shranjeni dokument s URL pripne sredstva gradnje, na katera se sklicuje, te datoteke pa imajo lastna pravila hrambe, zato lahko ena preživi drugo. Pred postrežbo predpomnilnik PHP in dodatek preverita, ali povezana vsebinsko zgoščena slogovna datoteka Tailwind še obstaja na disku. Če slogovne datoteke ni več, se dokument preda WordPress namesto, da bi bil postrežen brez slogov; ta skupaj znova objavi slogovno datoteko in dokument. Enako preverjanje se izvede pred shranjevanjem odgovora, zato dokument, ki ga ni mogoče postreči, nikoli ni zapisan.
Zahteva, katere glava Accept vsebuje text/markdown, obide shrambo PHP in dodatek, saj so shranjeni dokumenti HTML, stran pa lahko na to zahtevo odgovori z izvirnim Markdown. Postreženi dokumenti zato pošljejo Vary: Accept. Posodobitev Blockstudio ob naslednjem zapisu zemljevida prepiše starejši dodatek.
Poti grafa na zemljevidu vedno uporabljajo aktivirani artefakt. Če varne anonimne poti ni na tem zemljevidu, vendar jo je WordPress medtem izrisal in shranil, Early Serve pred zagonom WordPress uporabi nadomestni predpomnilnik izvajalnega okolja, vezan na identiteto. To omogoča uporabo ustvarjenih poti ali dolgorepih poti zunaj namerno omejenega grafa uvajanja. Nadomestna možnost uporablja identiteto aktiviranega grafa ter enaka pravila za gostitelja, normalizacijo poti, TTL, piškotke, glave, poizvedbene nize, dinamične poti in obvod virov kot poti na zemljevidu; najde samo dokumente, ki jih je shranilo izvajalno okolje, med katerimi nikoli ni rezultatov iskanja.
Glave odgovora
Shranjeni dokument se znova predvaja brez zahteve, ki ga je izrisala, zato bi glava, ki jo tema ali vtičnik pošlje z header(), manjkala pri vsakem zadetku. Blockstudio z vsakim dokumentom shrani glave, navedene v replayHeaders, in jih znova pošlje iz predpomnilnika PHP ter dodatka za zgodnje pošiljanje. Privzeti nabor ["Link"] zajema glave, kot so alternativa Markdown za rel="alternate"; type="text/markdown", rel="describedby" ali rel="canonical". Imena se primerjajo brez razlikovanja med velikimi in malimi črkami, filter nastavitve pa seznam spreminja enako kot katero koli drugo vrednost:
add_filter('blockstudio/settings/performance/staticPrerender/replayHeaders', function (array $headers): array {
$headers[] = 'X-Robots-Tag';
return $headers;
});
Nastavite replayHeaders na [], da onemogočite ponovno pošiljanje glav. Izrecni seznam nadomesti privzetega, zato pri dodajanju drugih imen glav vključite Link, če želite še naprej znova pošiljati glave povezav.
Glave se zajamejo v procesu, ki izriše stran: iz headers_list(), ko se shrani zgrešeni zadetek v živo, in iz same ogrevalne zahteve, ko gradnja ali ogrevalnik izriše čez HTTP, zato glava, ki jo spletni strežnik doda sam in jo znova doda vsakemu poslanemu dokumentu, ni nikoli shranjena. Samo kadar izris HTTP ne zapiše poročila, se uporabijo glave njegovega odgovora. Prenos internal jih vrne kot headers v rezultatu, persist_built_response() pa jih sprejme kot zadnji argument, bodisi v obliki vrstic Name: value bodisi kot preslikavo imen v vrednosti.
Zapišejo se v <key>.headers.json poleg dokumenta, ga spremljajo pri promociji artefaktov, zbiranju smeti in obrezovanju hranjenih podatkov ter se odstranijo, ko ponovni izris ne pošlje nobene. Piškotki, predpomnilniške in transportne glave se nikoli ne shranijo ali znova pošljejo, tudi če so navedene: Set-Cookie, Cache-Control, Expires, Pragma, Age, ETag, Last-Modified, Vary, Content-Type, Content-Length, Content-Encoding, Transfer-Encoding, Location, Status, Date ter glave, ki veljajo samo za posamezen preskok, in avtentikacijske glave. Poslan dokument nastavi svoji lastni glavi Content-Type in Vary.
Shranjene glave se ob pošiljanju znova preverijo glede na seznam. Predpomnilnik PHP prebere trenutno nastavitev; dodatek pa prebere kopijo iz vnosa v zemljevidu mesta, ki se osveži ob naslednji namestitvi artefakta ali sinhronizaciji zemljevida. Dokumenti, shranjeni pred nadgradnjo, nimajo datoteke z glavami in se pošiljajo kot prej, dokler niso znova izrisani.
Ogrevanje, vzdrževanje in spremljanje
Čakalna vrsta za ogrevanje je trajna, združuje podvojene zahtevke URL, izvaja samo eno opravilo hkrati in obnavlja potekle prevzeme. Spremembe vsebine in spletnega mesta vedno sprožijo nadomestno opravilo, tudi če se trenutni podpis ne spremeni; intervalni prehodi dodajo v vrsto samo zastarela opravila. Vsak načrtovani prehod ali prehod prek wp bs prerender warm izriše do warm.concurrency opravil. Način graph izklopi ogrevanje na posamezen URL, saj se artefakti grafa zgradijo in aktivirajo kot celota.
wp bs prerender warm
wp bs prerender status
wp bs prerender purge
wp bs prerender map status
wp bs prerender map prune --dry-run
status poroča o aktivni identiteti, datotekah, bajtih, zapisih grafa, stanju čakalne vrste, poročilu zemljevida za zgodnje postrežanje ter števcih zadetkov, zgrešenih zadetkov, gradenj in napak za posamezne obsege.
Zemljevid za zgodnje postrežanje si delijo vsa spletna mesta v namestitvi. map status (in Static_Prerender_Early_Serve::map_report()) navaja vnose, ki jih zgodnje postrežanje ne more več uporabiti: vnose orphaned, katerih spletno mesto ne obstaja več, in vnose dead, katerih imenik je izginil, ter število missing dokumentov poti v preostalih vnosih. map prune (Static_Prerender_Early_Serve::prune_map()) pod zaklepanjem zemljevida odstrani osirotele in neaktivne vnose ter vsakega navede skupaj z razlogom; --dry-run samo poroča. Z odstranitvijo zadnjega vnosa se odstranijo zemljevid, dodatek in deklaracija WP_CACHE. Če izbrišete spletno mesto iz večmestnega omrežja, se njegovi vnosi odstranijo takoj; čiščenje predpomnilnika nikoli ne zbere imenskega prostora, iz katerega se postreže aktivirani artefakt, zato vnosi postanejo neaktivni samo, če se njihove datoteke odstranijo kako drugače.
Posamezne rezultate odgovorov spremljajte z blockstudio/static_prerender/outcome, vse rezultate skupnega predpomnilnika pa z blockstudio/cache/outcome.
Odstranitev
Namestitve brez kavlja za deaktivacijo vtičnika, na primer nastavitve z vključenim Composer, lahko vse, kar upravlja ta funkcija, odstranijo z enim ukazom:
wp bs teardown
Odstrani dogodke cron in stanje statičnega predizrisovanja, ki ga upravlja namestitev: vnos zemljevida trenutnega spletnega mesta ter skupni dodatek in deklaracijo WP_CACHE, ko izgine zadnji upravljani vnos. Konfiguracijske datoteke ostanejo nedotaknjene, zato se funkcija ob ponovnem vklopu zažene v čistem stanju.
Uvedba v produkciji
Smiseln vrstni red uvedbe:
- Nastavite
performance.profilenaspeed, nato preverite izhod glave, vire in vse vtičnike, ki so odvisni od oEmbed ali XML-RPC. - Ustvarite
assets/media.json, premaknite predloge vbs_media_image(), nato vklopiteperformance.media.lazy. - Omogočite
performance.staticPrerender, medtem ko jeearlyServeizklopljen, preverite zadetke zwp bs prerender status, nato vklopiteearlyServe.
Povrnitev sprememb se izvede za vsako funkcijo posebej: če nastavite staticPrerender.enabled na false, se enkrat odstrani stanje Early Serve, ki ga upravlja Blockstudio, in razporedi ogrevanja, izvajalno okolje za predizrisovanje pa ostane neregistrirano. Če performance.profile znova nastavite na compat, razveljavite profil. Vsak postopek pusti druge plasti nedotaknjene.
Profili, profiler in tehnike izrisa v ozadju.
En imenik predpomnilnika za vse ustvarjene artefakte.