Staattinen esirenderöinti
Staattinen esirenderöinti on valinnainen anonyymien pyyntöjen HTML välimuisti. Välimuistiin kelpaavan vastauksen on oltava kokonainen HTML-dokumentti, ja sen voi sulkea pois asetuksella <!-- blockstudio:no-cache -->. Blockstudio ohittaa oletusarvoisesti muut kuin GET-pyynnöt, kyselymerkkijonot, WordPress-hallinnan, REST, Ajaxin, cron, syötteet, haun tulokset, jotka eivät sijaitse sivuston etusivun hakupolussa (kuten /search/term/), esikatselu- ja canvas-otsakkeet, nonce-arvon sisältävät pyynnöt, määritetyt dynaamiset polut, salasana- ja kommenttievästeet sekä sisäänkirjautuneiden pyynnöt. Sivu, jonka polussa on vain myöhempänä search– tai preview-segmentti, kuten /docs/blocks/preview/, tallennetaan välimuistiin kuten mikä tahansa muu sivu.
{
"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"
}
}
}
}
Sisäänkirjautuneet käyttäjät voivat käyttää välimuistissa olevaa osumaa vain, kun serveLoggedIn on tosi; personoiduista vastauksista ei koskaan luoda välimuistimerkintöjä. Dynaamisissa poluissa käytetään polkurajoja, joten /account vastaa arvoa /account/orders mutta ei arvoa /accounting.
Kun ominaisuus ei ole käytössä, se ei kirjoita tiedostoja, asenna drop-in-komponenttia eikä rekisteröi pyyntö- tai hallintakoukkuja. earlyServe: false ei myöskään rekisteröi Early Serve -hallinnan callbackia, eikä warm.enabled: false rekisteröi cron-callbackia tai ajastusta. Kun jompikumpi ominaisuus poistetaan käytöstä, sen aiemmin omistama tila poistetaan kerran; myöhemmillä pyynnöillä ei tehdä tiedostojärjestelmän tai cron:n siivoustarkistuksia.
Poistaminen käytöstä ympäristökohtaisesti
Jokaisen yllä olevan arvon voi asettaa myös asetus-suodattimella. Blockstudio käynnistyy ennen aktiivista teemaa joko lisäosasta tai teeman Composer-autoloadista, joten se selvittää ajonaikaiset asetuksensa uudelleen teeman latauduttua ja päättää staattisen esirenderöinnin koukuista kohdassa after_setup_theme. Lisäosassa tai teeman functions.php-tiedostossa lisätty suodatin tulee siis voimaan:
add_filter('blockstudio/settings/performance/staticPrerender/enabled', function ($enabled) {
return 'local' === wp_get_environment_type() ? false : $enabled;
});
Ominaisuuden poistaminen käytöstä tällä tavalla toimii kuten sen poistaminen käytöstä kohdassa blockstudio.json: pyyntö-, sisältö-, hallinta- tai cron-koukkuja ei rekisteröidä, ja aiemmin varhain tarjoillun sivuston Early Serve -merkintä poistetaan kerran. Myöhemmin lisätty suodatin, esimerkiksi kohdassa init, ei muuta rekisteröitäviä koukkuja.
Allekirjoitus- ja graafitilat
signature-tila täyttää identiteettiavaimella varustetun vastauksen tavallisen anonyymin välimuistiosuman puuttuessa. Se sopii tavallisille WordPress-sivustoille, ja sivustotason muutokset uudistavat sen.
graph-tila on tarkoitettu deterministisiin koonti- ja käyttöönottointegraatioihin. Kutsu Static_Prerender_Runtime::build_plan() aktiivisilla lähde-URL-osoitteilla, renderöi vain affectedUrls ja tallenna sitten jokainen tulos funktiolla persist_built_response() tai persist_skipped_response(). Suunnitelma vertaa yhteisiä tiedostoja ja kunkin sivun tarkkoja riippuvuustiivisteitä. Poistetut URL-osoitteet ja viittaamattomat HTML-kohteet poistetaan funktiolla 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);
Valinnaisilla kohdepalvelimen ja etusivun argumenteilla reitit voidaan kirjoittaa käyttöönottokohdetta varten käyttämättä ensimmäisen sivun polkua sivuston juurena. Eräajotyökalut voivat käyttää asetusta Static_Prerender_Batch_Renderer::render() ja pysyviä N/TOTAL-osioita; valitsimet Static_Prerender_Batch_Renderer::parse_shard() ja select_shard() toteuttavat osiointivaihtoehdon, joten kutsuja voi laskea saman osion kuin renderöijä. Koontiprosessin aikana Static_Prerender_Batch_Renderer::is_rendering() kertoo, onko nykyinen pyyntö erärenderöinti eikä kävijän pyyntö, joten malli voi ohittaa työn, jota ei pidä suorittaa koonnin aikana. internal-siirto määritetään yleisellä blockstudio/static_prerender/render_internal-suodattimella; valinnainen HTTP-vararatkaisu käyttää tavallista lämmitysotsaketta.
Mitä graafitila seuraa
Oletusarvoisella HTTP-siirrolla Static_Prerender_Batch_Renderer::render() lähettää jokaiseen lämmityspyyntöön allekirjoitetun tunnisteen, ja pyyntö ilmoittaa lukemansa tiedostot: ladatun mallitiedoston WordPress, jokaisen renderöidyn Blockstudio-lohkon mallin, mallitiedostot ja resurssitiedostot, blockstudio/render/dependencies-toiminnolla lisätyt tiedostot sekä synkronoidun sivun määritys-, malli-, sisältö- ja asettelutiedostot. Raportti kirjoitetaan sivuston välimuistihakemistoon, joka on jo renderöijän ja verkkopalvelimen yhteiskäytössä renderöityä HTML-sisältöä varten. Seuraavassa koonnissa build_plan() tiivistää tiedostot uudelleen ja merkitsee vain ne reitit, joiden tiedostot ovat muuttuneet, sekä uudet reitit, ttl-arvonsa ylittäneet reitit ja kaikki reitit yhteisen tiedoston muuttuessa (blockstudio.json, theme.json, style.css, functions.php, header.php, footer.php, kaikki kohteen inc/ alla, parts/ ja templates/ sekä Blockstudio-lisäosan pakattujen UI-resurssien lähteet). Yhteinen allekirjoitus lasketaan lähdetiedostoista, ei käännetystä tulosteesta, joten tiedostot _dist, jotka koonnin ensimmäinen renderöinti kääntää, eivät muuta sitä: artifact_entry() määrittää koontitunnisteen samasta allekirjoituksesta, jonka build_plan() näki ennen renderöintiä.
Vain tietokannassa oleva sisältö ei ole tiedosto, joten sitä ei seurata: näin ovat esimerkiksi hallinnassa muokatut artikkelit, asetukset, luodut rivit ja hinnat. Jos koonnin on huomioitava tällaiset muutokset, sen on välitettävä $force funktiolle build_plan() tai renderöitävä kyseiset URL-osoitteet itse. internal-siirto tallentaa suodattimensa palauttamat riippuvuudet.
Varhainen tarjoilu ja atominen käyttöönotto
Kun earlyServe on käytössä, Blockstudio hallitsee pientä wp-content/blockstudio-static-prerender-map.php-tiedostoa, advanced-cache.php-drop-in-komponenttia ja yhtä täsmällistä WP_CACHE-määritystä. Drop-in lukee sivustokohtaisen reittikartan ja siirtää kelvollisen välimuistiosuman ennen kuin WordPress, lisäosat tai teema käynnistyvät.
Blockstudio ei koskaan korvaa muiden omistamaa karttaa, drop-in-komponenttia tai WP_CACHE-määritystä. Graafiartifaktit tarkistavat jokaisen viitatun HTML-tiedoston ennen kartan vaihtamista; jos tarkistus epäonnistuu, edellinen graafi pysyy aktiivisena. Monisivustoasennusten merkinnät jakavat kartan, mutta ne erotellaan palvelimen, etusivun polun ja sivustotunnuksen perusteella. Ominaisuuden poistaminen käytöstä tai Blockstudio:n deaktivointi poistaa vain nykyisen sivuston merkinnän, ja jaetut artifaktit poistetaan vasta, kun viimeinen omistettu merkintä on poissa.
Käyttöönottotyökalut voivat aktivoida kokonaan renderöidyn graafin atomisesti:
$entry = Static_Prerender_Runtime::artifact_entry($targetUrls);
Blockstudio\Static_Prerender_Early_Serve::install_artifact_entry(
$entry,
Static_Prerender_Runtime::cache_root_path()
);
Määritykset pysyvät ensisijaisina. install_artifact_entry() palauttaa arvon false, elleivät sekä enabled että earlyServe ole tosia. Näin käyttöönotto ei voi asentaa karttaa, drop-in-komponenttia ja WP_CACHE-määritystä, jotka seuraava hallintapyyntö poistaisi.
install_artifact_entry() säilyttää merkinnän build_id-arvon, joten käyttöönotto voi verrata sitä merkinnän arvoon, jonka installed_map_entries() palauttaa sen jälkeen. Kartta on PHP-tiedosto, joka luetaan asetuksella include, ja jokainen kirjoitus poistaa sen opcode-välimuistista. Näin luku näkee samassa prosessissa uuden merkinnän, vaikka opcache.enable_cli olisi käytössä.
Artifaktin asentaminen siirtää sen dokumentit omaan artifaktialueeseen, johon säilytyksen siivous ei koske. Kartan viittaamat tiedostot ovat suojassa poistamiselta riippumatta tallennuspaikastaan, joten aktiivinen renderöintiliikenne ei voi vanhentaa kartoitettuja reittejä ennenaikaisen tarjoilun ulkopuolelle. Reittiavain ei ole täysin sisältöosoitteinen, joten uudelleenrenderöinti voi muuttaa dokumenttia muuttamatta sen avainta. Asennus vertaa tavuja ja korvaa poikkeavan artifaktidokumentin atomisesti, jättää samanlaiset dokumentit ennalleen ja säilyttää artifaktidokumentin, vaikka sen tallennuskopio olisi kadonnut. Static_Prerender_Early_Serve::last_promotion() ilmoittaa, kuinka monta reittiä viimeisin asennus siirsi artifaktialueeseen, korvasi, ohitti tai säilytti, joten käyttöönotto voi kirjata tiedon lokiin.
Tallennettu dokumentti lukitsee linkittämiensä koontiresurssien URL-arvot, ja näillä tiedostoilla on oma säilytyksensä, joten toinen voi säilyä toista pidempään. Ennen tarjoilua sekä PHP-välimuisti että drop-in tarkistavat, että linkitetty sisältötiivisteellinen Tailwind-tyylitiedosto on yhä levyllä. Jos dokumentin tyylitiedosto puuttuu, dokumentti ohjataan WordPress-toiminnolle sen sijaan, että se tarjoiltaisiin ilman tyylejä; toiminto julkaisee tyylitiedoston ja dokumentin yhdessä uudelleen. Sama tarkistus tehdään ennen vastauksen tallentamista, joten dokumenttia, jota ei voida tarjoilla, ei koskaan kirjoiteta.
Pyyntö, jonka Accept-otsake sisältää arvon text/markdown, ohittaa sekä PHP-tallennuksen että drop-in-komponentin, koska tallennetut dokumentit ovat HTML ja sivu voi vastata pyyntöön sen lähde-Markdown-sisällöllä.
Tarjoillut dokumentit lähettävät siksi Vary: Accept-arvon. Asetuksen Blockstudio päivittäminen kirjoittaa vanhan drop-in-komponentin uudelleen seuraavan karttakirjoituksen yhteydessä.
Karttaan lisätyt graafireitit käyttävät aina aktivoitua artifaktia. Jos turvallista anonyymia reittiä ei ole kartassa, mutta WordPress on sittemmin renderöinyt ja tallentanut sen, Early Serve käyttää identiteettiavaimella varustettua ajonaikaista tallennusta ennen WordPress-käynnistystä. Näin tuetaan luotuja tai pitkän hännän reittejä, jotka jäävät tarkoituksella rajatun käyttöönottograafin ulkopuolelle. Vararatkaisu käyttää aktivoidun graafin identiteettiä sekä samoja palvelin-, polkujen normalisointi-, TTL-, eväste-, otsake-, kyselymerkkijono-, dynaamisen polun ja syötteen ohitussääntöjä kuin karttaan lisätyt reitit. Se löytää vain ajonaikaisen tallennuksen tallentamia dokumentteja, joihin hakutulokset eivät koskaan sisälly.
Vastausotsakkeet
Tallennettu dokumentti toistetaan ilman pyyntöä, joka sen muodosti, joten teeman tai lisäosan header()-otsake puuttuisi jokaiselta osumalta. Blockstudio tallentaa replayHeaders-kohdassa nimetyt otsakkeet kunkin dokumentin yhteyteen ja lähettää ne uudelleen sekä PHP-välimuistista että varhaisen tarjoilun drop-inistä. Oletus ["Link"] kattaa esimerkiksi Markdown-vaihtoehdon (rel="alternate"; type="text/markdown"), rel="describedby"-otsakkeen tai rel="canonical"-otsakkeen. Nimiä verrataan kirjainkoosta riippumatta, ja asetusfiltteri muuttaa luetteloa kuten mitä tahansa muutakin arvoa:
add_filter('blockstudio/settings/performance/staticPrerender/replayHeaders', function (array $headers): array {
$headers[] = 'X-Robots-Tag';
return $headers;
});
Poista otsakkeiden toisto käytöstä asettamalla replayHeaders arvoon []. Nimenomainen luettelo korvaa oletuksen, joten lisää Link mukaan, kun lisäät muita otsakenimiä, jos haluat yhä toistaa linkkiotsakkeet.
Otsakkeet poimitaan sivun muodostavassa prosessissa: headers_list()-lähteestä, kun reaaliaikainen välimuistin ohitus tallennetaan, ja lämmityspyynnöstä itsestään, kun koonti tai lämmittäjä muodostaa sivun HTTP-palvelimen kautta. Siksi verkkopalvelimen itsenäisesti lisäämää ja jokaiseen tarjottavaan dokumenttiin uudelleen lisäämää otsaketta ei koskaan tallenneta. Vain silloin, kun HTTP-muodostus ei kirjoita raporttia, käytetään sen vastauksen otsakkeita. internal-siirtotapa palauttaa ne tuloksessaan muodossa headers, ja persist_built_response() ottaa ne viimeisenä argumenttinaan joko Name: value-riveinä tai nimi-arvo-karttana.
Ne kirjoitetaan dokumentin viereen sijaintiin <key>.headers.json, kulkevat sen mukana artefaktin käyttöönoton, roskienkeruun ja säilytysajan mukaisen karsimisen läpi, ja poistetaan, kun uudelleenmuodostus ei lähetä niitä. Eväste-, välimuisti- ja siirto-otsakkeita ei koskaan tallenneta eikä toisteta, vaikka ne olisi lueteltu: Set-Cookie, Cache-Control, Expires, Pragma, Age, ETag, Last-Modified, Vary, Content-Type, Content-Length, Content-Encoding, Transfer-Encoding, Location, Status, Date sekä hyppykohtaiset ja todennusotsakkeet. Tarjottava dokumentti asettaa omat Content-Type– ja Vary-otsakkeensa.
Tallennetut otsakkeet tarkistetaan luetteloa vasten uudelleen lähetyksen yhteydessä. PHP-välimuisti lukee nykyisen asetuksen; drop-in lukee kopion sivuston karttamerkinnästä, jonka seuraava artefaktin asennus tai kartan synkronointi päivittää. Ennen päivitystä tallennetuilla dokumenteilla ei ole otsaketiedostoa, ja ne tarjotaan täsmälleen kuten ennenkin, kunnes ne muodostetaan uudelleen.
Lämmitys, ylläpito ja havainnoitavuus
Lämmitysjonon tiedot säilyvät, se yhdistää URL-pyyntöjä, käsittelee yhden kerrallaan ja palauttaa aikakatkaistut varaukset. Sisältö- ja sivustomuutokset pakottavat korvaavan työn, vaikka nykyinen allekirjoitus olisi sama; ajastusvälien käsittely lisää jonoon vain vanhentuneet työt. Kukin ajoitettu tai wp bs prerender warm-toiminnon kautta käynnistetty käsittelykerta renderöi enintään warm.concurrency työtä. graph-tila poistaa sivukohtaisen URL-lämmittäjän käytöstä, koska graafiartifaktit muodostetaan ja aktivoidaan yhtenä kokonaisuutena.
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 ilmoittaa aktiivisen identiteetin, tiedostot, tavut, graafitietueet, jonon tilan, varhaisen tarjoilun karttaraportin sekä osumien, ohitusten, koontien ja virheiden laskurit alueittain.
Varhaisen tarjoilun kartta on kaikkien asennuksen sivustojen yhteinen. map status (ja Static_Prerender_Early_Serve::map_report()) luettelee merkinnät, joita varhainen tarjoilu ei voi enää käyttää: orphaned-merkinnät sivustoille, joita ei enää ole, ja dead-merkinnät puuttuville hakemistoille. Se ilmoittaa myös jäljellä olevien merkintöjen missing-reittidokumenttien määrän. map prune (Static_Prerender_Early_Serve::prune_map()) poistaa orvot ja kuolleet merkinnät karttalukon alla ja ilmoittaa kunkin syyn; --dry-run vain raportoi. Viimeisen merkinnän poistaminen poistaa kartan, drop-in-komponentin ja WP_CACHE-määrityksen. Sivuston poistaminen monisivustoverkosta poistaa sen merkinnät heti, eikä välimuistin siivous kerää aktivoidun artifaktin tarjoilualuetta. Siksi merkinnät vanhenevat vain, jos niiden tiedostot poistetaan muulla tavoin.
Seuraa yksittäisten vastausten tuloksia komennolla blockstudio/static_prerender/outcome ja kaikkia jaetun välimuistin tuloksia komennolla blockstudio/cache/outcome.
Purkaminen
Asennuksissa, joissa ei ole lisäosan deaktivointikoukkua, kuten Composer-pakatuissa asennuksissa, voi poistaa kaikki ominaisuuden omistamat tiedot yhdellä komennolla:
wp bs teardown
Se poistaa asennuksen omistamat cron-tapahtumat ja staattisen esirenderöinnin tilan: nykyisen sivuston karttamerkinnän sekä jaetun drop-in-komponentin ja WP_CACHE-määrityksen, kun viimeinen omistettu merkintä on poistettu. Määritystiedostoihin ei kosketa, joten ominaisuuden käyttöönotto uudelleen alkaa puhtaalta pohjalta.
Käyttöönotto tuotannossa
Järkevä käyttöönottojärjestys:
- Aseta
performance.profilearvoonspeedja tarkista sitten head-tuloste, syötteet sekä kaikki lisäosat, jotka käyttävät oEmbediä tai XML-RPC-ominaisuutta. - Luo
assets/media.json, siirrä mallit sijaintiinbs_media_image()ja ota sitten käyttöönperformance.media.lazy. - Ota käyttöön
performance.staticPrerenderasetuksenearlyServeollessa pois päältä. Varmista osumat komennollawp bs prerender statusja ota sittenearlyServekäyttöön.
Palautus tehdään ominaisuuskohtaisesti: asetuksen staticPrerender.enabled muuttaminen arvoon false poistaa Blockstudio-ominaisuuden omistaman Early Serve -tilan ja lämmitysajastukset kerran, minkä jälkeen esirenderöinnin ajonaikaista ympäristöä ei rekisteröidä. Asetuksen performance.profile palauttaminen arvoon compat kumoaa profiilin. Kummassakin tapauksessa muut kerrokset jäävät ennalleen.
Profiilit, profiler ja niiden taustalla olevat renderöintitekniikat.
Yksi välimuistihakemisto kaikille luoduille artifakteille.