Pereiti prie turinio

Statinis išankstinis atvaizdavimas

Statinis išankstinis atvaizdavimas yra pasirenkamas anoniminis HTML podėlis. Podėliuojamas atsakymas turi būti visas HTML dokumentas ir gali atsisakyti podėliavimo naudodamas <!-- blockstudio:no-cache -->. Blockstudio apeina ne-GET užklausas, užklausos parametrus, WordPress administravimo sritį, REST, Ajax, cron, sklaidos kanalus, paieškos rezultatus žemiau svetainės pagrindinio kelio esančio paieškos bazinio kelio (pvz., /search/term/), peržiūros ir canvas antraštes, užklausas su nonce reikšmėmis, deklaruotus dinaminius kelius, slaptažodžių / komentarų slapukus ir, pagal numatytuosius nustatymus, prisijungusių naudotojų užklausas. Puslapis, kurio kelyje search arba preview segmentas yra tik giliau, pvz., /docs/blocks/preview/, podėliuojamas kaip bet kuris kitas puslapis.

JSON
{
  "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"
      }
    }
  }
}

Prisijungę naudotojai gali gauti esamą podėlio įrašą tik kai serveLoggedIn yra teisinga; personalizuoti atsakymai niekada nesukuria podėlio įrašų. Dinaminiai keliai tikrinami pagal kelio ribas, todėl /account atitinka /account/orders, bet ne /accounting.

Kol ši funkcija išjungta, ji nerašo failų, neįdiegia įterptinio modulio ir neregistruoja užklausų ar administravimo kablių. earlyServe: false taip pat neregistruoja ankstyvo pateikimo administravimo atgalinio iškvietimo, o warm.enabled: false neregistruoja cron atgalinio iškvietimo ar tvarkaraščio. Išjungus bet kurią funkciją, anksčiau jos valdoma būsena pašalinama vieną kartą; vėlesnėse užklausose neatliekami failų sistemos ar cron valymo patikrinimai.

Išjungimas konkrečioje aplinkoje

Kiekvieną anksčiau nurodytą reikšmę taip pat galima nustatyti nustatymų filtru. Blockstudio paleidžiamas prieš aktyvią temą iš įskiepio arba iš temos Composer autoload, todėl, temai įsikėlus, vykdymo aplinkos nustatymai nustatomi iš naujo ir sprendimas dėl statinio išankstinio atvaizdavimo kablių priimamas ties after_setup_theme. Todėl įskiepio arba temos functions.php pridėtas filtras įsigalioja:

PHP
add_filter('blockstudio/settings/performance/staticPrerender/enabled', function ($enabled) {
    return 'local' === wp_get_environment_type() ? false : $enabled;
});

Taip išjungus funkciją, ji elgiasi taip pat, kaip ją išjungus per blockstudio.json: neregistruojami užklausų, turinio, administravimo ar cron kabliai, o anksčiau anksčiau pateiktas „Early Serve“ įrašas pašalinamas vieną kartą. Vėliau, pavyzdžiui, ties init pridėtas filtras nekeičia registruojamų kablių.

Parašo ir grafiko režimai

signature režimu įprasto anoniminio podėlio praleidimo atveju užpildomas tapatybe pagrįstas atsakymas. Tai patogu įprastoms WordPress svetainėms; pasikeitus svetainės lygmens duomenims, podėlis atnaujinamas.

graph režimas skirtas deterministinėms kūrimo ir diegimo integracijoms. Iškvieskite Static_Prerender_Runtime::build_plan() su veikiančiais šaltinio URL adresais, atvaizduokite tik affectedUrls, tada užregistruokite kiekvieną rezultatą naudodami persist_built_response() arba persist_skipped_response(). Planas palygina bendrinamus failus ir tikslias kiekvieno puslapio priklausomybių maišas. Ištrinti URL adresai ir nebenaudojami HTML pašalinami naudojant garbage_collect().

PHP
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);

Pasirenkami tikslinio pagrindinio kompiuterio / pagrindinio puslapio argumentai perrašo maršrutus diegimui, nenaudodami pirmojo puslapio kelio kaip svetainės šaknies. Paketinio apdorojimo įrankiai gali naudoti Static_Prerender_Batch_Renderer::render() ir stabilius N/TOTAL skaidinius; Static_Prerender_Batch_Renderer::parse_shard() ir select_shard() įgyvendina skaidinių parinktį, kad iškvietėjas galėtų apskaičiuoti tą patį skaidinį kaip atvaizdavimo priemonė. Kūrimo proceso metu Static_Prerender_Batch_Renderer::is_rendering() atsako, ar dabartinė užklausa yra paketinis atvaizdavimas, o ne lankytojo užklausa, kad šablonas galėtų praleisti veiksmus, kurių nereikia atlikti kuriant. internal transportą pateikia bendrasis blockstudio/static_prerender/render_internal filtras; pasirenkamas HTTP atsarginis variantas naudoja įprastą apšilimo antraštę.

Kokius duomenis seka grafiko režimas

Naudojant numatytąjį HTTP transportą, Static_Prerender_Batch_Renderer::render() prie kiekvienos apšilimo užklausos prideda pasirašytą prieigos raktą, o užklausa pateikia perskaitytus failus: įkeltą šabloną WordPress, kiekvieno atvaizduoto Blockstudio bloko šabloną, šablonų failus ir išteklių failus, per blockstudio/render/dependencies pridėtus failus, o sinchronizuotam puslapiui – jo aprašo, šablono, turinio ir maketo failus. Ataskaita įrašoma į svetainės podėlio katalogą, kurį atvaizdavimo priemonė ir žiniatinklio serveris jau bendrina su pateiktais HTML. Kito kūrimo proceso metu build_plan() vėl apskaičiuoja tų failų maišas ir pažymi tik tuos maršrutus, kurių failai pasikeitė, taip pat naujus maršrutus, maršrutus, kurių ttl galiojimo laikas baigėsi, ir visus maršrutus, kai pasikeičia bendrinamas failas (blockstudio.json, theme.json, style.css, functions.php, header.php, footer.php, viskas, kas yra inc/, parts/ ir templates/ kataloguose, bei Blockstudio paketinių UI išteklių šaltiniai). Bendrinamas parašas maišą apskaičiuoja iš šaltinių, o ne iš sukompiliuotos išvesties, todėl pirmojo atvaizdavimo metu sukompiliuoti _dist failai jo nekeičia: artifact_entry() kūrimo ID nustato pagal tą patį parašą, kurį build_plan() užfiksavo prieš atvaizdavimą.

Duomenų bazėje esantis turinys nėra failas ir nėra sekamas: administravimo srityje redaguojami įrašai, parinktys, sugeneruotos eilutės ar kainos. Kūrimo procesas, kuriam reikia įtraukti tokius pakeitimus, perduoda $force į build_plan() arba pats atvaizduoja paveiktus URL adresus. internal transportas registruoja priklausomybes, kurias grąžina jo filtras.

Ankstyvas pateikimas ir atominis diegimas

Įjungus earlyServe, Blockstudio valdo nedidelį wp-content/blockstudio-static-prerender-map.php, vieną advanced-cache.php įterptinį modulį ir tikslią WP_CACHE deklaraciją. Įterptinis modulis nuskaito konkrečiai svetainei skirtą maršrutų žemėlapį ir pateikia tinkamą podėlio įrašą dar prieš paleidžiant WordPress, įskiepius ar temą.

Blockstudio niekada neperrašo svetimo žemėlapio, įterptinio modulio ar WP_CACHE deklaracijos. Prieš pakeičiant žemėlapį, patikrinama grafiko artefaktuose nurodytų HTML failų galiojimo būsena; jei patikra nepavyksta, ankstesnis grafikas lieka aktyvus. Multisite įrašai naudoja bendrą žemėlapį, tačiau atskiriami pagal pagrindinį kompiuterį, pagrindinio puslapio kelią ir svetainės ID. Išjungus funkciją arba išjungus Blockstudio įskiepį, pašalinamas tik dabartinės svetainės įrašas, o bendrinami artefaktai pašalinami tik nelikus paskutinio valdomo įrašo.

Diegimo įrankiai gali atomiškai aktyvinti visiškai atvaizduotą grafiką:

PHP
$entry = Static_Prerender_Runtime::artifact_entry($targetUrls);

Blockstudio\Static_Prerender_Early_Serve::install_artifact_entry(
    $entry,
    Static_Prerender_Runtime::cache_root_path()
);

Konfigūracija išlieka pagrindinis nustatymų šaltinis. install_artifact_entry() grąžina false, nebent ir enabled, ir earlyServe yra teisingi, todėl diegimas negali įdiegti žemėlapio, įterptinio modulio ir WP_CACHE deklaracijos, kurias kita administravimo užklausa vėl pašalintų.

install_artifact_entry() išsaugo įrašo build_id, todėl po diegimo galima palyginti jį su įrašu, kurį vėliau grąžina installed_map_entries(). Žemėlapis yra PHP failas, skaitomas naudojant include, o kiekvienas įrašymas pašalina jį iš opkodų podėlio, todėl net ir įjungus opcache.enable_cli tame pačiame procese nuskaitoma nauja įrašo versija.

Įdiegus artefaktą, jo dokumentai perkeliami į specialiai artefaktams skirtą sritį, kurios neliečia saugojimo trukmės valymas. Žemėlapyje nurodytų failų negalima išmesti iš podėlio, kad ir kur jie būtų, todėl aktyvus atvaizdavimas negali pasendinti susietų maršrutų ir pašalinti jų iš ankstyvo pateikimo. Maršruto raktas nevisiškai pagrįstas turiniu, todėl iš naujo atvaizdavus dokumentą jo raktas gali nepasikeisti; diegimo metu palyginami baitai ir atominiu būdu pakeičiamas besiskiriantis artefakto dokumentas, identiški dokumentai paliekami nepaliesti, o artefakto dokumentas išsaugomas net jei dingo jo kopija saugykloje. Static_Prerender_Early_Serve::last_promotion() pateikia informaciją, kiek maršrutų per paskutinį diegimą perkelta, pakeista, praleista ar išsaugota, kad šiuos duomenis būtų galima įrašyti diegimo žurnale.

Išsaugotas dokumentas susieja su kūrimo ištekliais, kuriuos nurodo per URL, o šiems failams taikomas atskiras saugojimo terminas, todėl dokumentas ir ištekliai gali būti išsaugoti nevienodą laiką. Prieš pateikdami dokumentą, tiek PHP podėlis, tiek įterptinis modulis patikrina, ar susietas turinio maiša pavadintas Tailwind stiliaus failas vis dar yra diske. Jei stiliaus failo nebėra, dokumentas perduodamas WordPress, o ne pateikiamas be stilių; ši sistema vėl paskelbia stiliaus failą ir dokumentą kartu. Tas pats tikrinimas atliekamas prieš išsaugant atsakymą, todėl niekada neįrašomas dokumentas, kurio nebūtų galima pateikti.

Užklausa, kurios Accept antraštėje yra text/markdown, apeina ir PHP saugyklą, ir įterptinį modulį, nes išsaugoti dokumentai yra HTML, o puslapis į tokią užklausą gali atsakyti savo šaltinio Markdown. Todėl pateikiami dokumentai siunčia Vary: Accept. Atnaujinus Blockstudio, senesnis įterptinis modulis perrašomas kitą kartą įrašant žemėlapį.

Grafiko žemėlapyje nurodyti maršrutai visada naudoja aktyvintą artefaktą. Jei saugaus anoniminio maršruto tame žemėlapyje nėra, bet WordPress jį jau atvaizdavo ir išsaugojo, „Early Serve“ prieš paleidžiant WordPress naudoja atsarginę tapatybe pagrįstą vykdymo aplinkos saugyklą. Taip palaikomi sugeneruoti arba retesni maršrutai, nepatenkantys į sąmoningai apribotą diegimo grafiką. Atsarginis variantas naudoja aktyvinto grafiko tapatybę ir tas pačias pagrindinio kompiuterio, kelio normalizavimo, TTL, slapukų, antraščių, užklausos parametrų, dinaminių kelių ir sklaidos kanalų apėjimo taisykles kaip ir žemėlapyje esantys maršrutai. Jis randa tik vykdymo aplinkos išsaugotus dokumentus, tarp kurių niekada nebūna paieškos rezultatų.

Atsakymo antraštės

Išsaugotas dokumentas pateikiamas pakartotinai be užklausos, kurios metu jis buvo sugeneruotas, todėl kiekviename apsilankyme trūktų antraštės, kurią tema arba įskiepis siunčia su header(). Blockstudio su kiekvienu dokumentu išsaugo antraštes, nurodytas replayHeaders, ir vėl jas siunčia tiek iš PHP podėlio, tiek iš ankstyvojo pateikimo papildinio. Numatytoji reikšmė ["Link"] apima tokias antraštes kaip Markdown alternatyva (rel="alternate"; type="text/markdown"), rel="describedby" arba rel="canonical". Pavadinimai lyginami neatsižvelgiant į raidžių dydį, o nustatymo filtras, kaip ir bet kurios kitos reikšmės atveju, pakeičia sąrašą:

PHP
add_filter('blockstudio/settings/performance/staticPrerender/replayHeaders', function (array $headers): array {
    $headers[] = 'X-Robots-Tag';

    return $headers;
});

Norėdami išjungti antraščių pakartotinį siuntimą, nustatykite replayHeaders į []. Nurodžius aiškų sąrašą, jis pakeičia numatytąjį, todėl įtraukite Link, jei pridėdami kitų antraščių pavadinimų vis dar norite pakartotinai siųsti nuorodų antraštes.

Antraštės užfiksuojamos puslapį generuojančiame procese: iš headers_list(), kai išsaugomas podėlio praleidimas, ir pačioje šiltojoje užklausoje, kai komponavimo procesas arba podėlio užpildymo įrankis generuoja puslapį virš HTTP. Todėl žiniatinklio serverio savarankiškai pridedama ir prie kiekvieno pateikiamo dokumento vėl pridedama antraštė niekada neišsaugoma. Tik jei HTTP generavimo procesas nepateikia ataskaitos, naudojamos jo atsakymo antraštės. internal transportas jas grąžina kaip headers savo rezultate, o persist_built_response() priima jas kaip paskutinį argumentą – eilučių Name: value pavidalu arba kaip pavadinimų ir reikšmių susiejimą.

Jos įrašomos į <key>.headers.json greta dokumento, išsaugomos jį perkeliant tarp artefaktų, atliekant šiukšlių surinkimą ir trumpinant saugojimo laikotarpį, o jei generuojant iš naujo jų neatsiunčiama, pašalinamos. Slapukų, podėlio ir transporto antraštės niekada neišsaugomos ir nepersiunčiamos, net jei yra sąraše: Set-Cookie, Cache-Control, Expires, Pragma, Age, ETag, Last-Modified, Vary, Content-Type, Content-Length, Content-Encoding, Transfer-Encoding, Location, Status, Date, taip pat kiekvieną šuolį apimančios ir autentifikavimo antraštės. Pateikiamas dokumentas nustato savo Content-Type ir Vary.

Prieš siunčiant išsaugotos antraštės dar kartą patikrinamos pagal sąrašą. PHP podėlis skaito dabartinį nustatymą, o papildinys skaito svetainės susiejimo įraše esančią kopiją; ją atnaujina kitas artefakto įdiegimas arba susiejimo sinchronizavimas. Prieš atnaujinimą išsaugoti dokumentai neturi antraščių failo ir pateikiami kaip anksčiau, kol nėra sugeneruojami iš naujo.

Apšilimas, priežiūra ir stebėsena

Apšilimo eilė yra patvari, užklausas URL sujungianti, vienu metu vykdanti tik vieną užduotį ir atkurianti pasibaigusio laiko užraktus. Turinio ir svetainės pakeitimai priverčia pakeisti užduotį net jei dabartinis parašas nepasikeitė; periodiniai ciklai į eilę įtraukia tik pasenusias užduotis. Kiekvieno ciklo metu, suplanuotai arba per wp bs prerender warm, apdorojama iki warm.concurrency užduočių. graph režimu išjungiamas kiekvieno URL apšilimas, nes grafiko artefaktai kuriami ir aktyvinami kaip vienas vienetas.

Shell
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 pateikia informaciją apie aktyvią tapatybę, failus, baitus, grafiko įrašus, eilės būseną, ankstyvo pateikimo žemėlapį ir kiekvienos srities podėlio pataikymų, praleidimų, kūrimų bei klaidų skaitiklius.

Ankstyvo pateikimo žemėlapį bendrina visi vieno diegimo svetainių įrašai. map status (ir Static_Prerender_Early_Serve::map_report()) pateikia įrašų, kurie nebėra tinkami ankstyvam pateikimui, sąrašą: orphaned įrašus, kurių svetainė nebeegzistuoja, ir dead įrašus, kurių katalogo nebėra, taip pat likusiuose įrašuose esančių missing maršruto dokumentų skaičių. map prune (Static_Prerender_Early_Serve::prune_map()) užrakina žemėlapį, pašalina nebepriklausančius ir nebeveikiančius įrašus bei pateikia kiekvieno jų šalinimo priežastį; --dry-run pateikia tik informaciją. Pašalinus paskutinį įrašą, pašalinamas žemėlapis, įterptinis modulis ir WP_CACHE deklaracija. Pašalinus svetainę iš multisite tinklo, jos įrašai pašalinami iš karto. Podėlio valymas niekada nepašalina vardų srities, iš kurios pateikiamas aktyvintas artefaktas, todėl įrašai tampa nebegaliojantys tik tada, kai jų failai pašalinami kitu būdu.

Atskirų atsakymų rezultatus stebėkite naudodami blockstudio/static_prerender/outcome, o visus bendro podėlio rezultatus – blockstudio/cache/outcome.

Pašalinimas

Diegimai be įskiepio išjungimo kablio, pavyzdžiui, Composer įtraukiamose konfigūracijose, gali vienoje komandoje pašalinti viską, ką valdo ši funkcija:

Shell
wp bs teardown

Pašalinami cron įvykiai ir statinio išankstinio atvaizdavimo būsena, kurią valdo diegimas: dabartinės svetainės žemėlapio įrašas, o bendrinamas įterptinis modulis ir WP_CACHE deklaracija pašalinami, kai nebelieka paskutinio valdomo įrašo. Konfigūracijos failai paliekami nepakeisti, todėl vėl įjungus funkciją ji veikia nuo švarios būsenos.

Diegimas gamybinėje aplinkoje

Tinkama diegimo tvarka:

  1. Nustatykite performance.profile į speed, tada patikrinkite head išvestį, sklaidos kanalus ir visus įskiepius, kurie naudoja oEmbed arba XML-RPC.
  2. Sugeneruokite assets/media.json, perkelkite šablonus į bs_media_image(), tada įjunkite performance.media.lazy.
  3. Įjunkite performance.staticPrerender, kai earlyServe išjungta, patikrinkite podėlio pataikymus naudodami wp bs prerender status, tada įjunkite earlyServe.

Grąžinimas atgal atliekamas kiekvienai funkcijai atskirai: nustačius staticPrerender.enabled į false, vieną kartą pašalinama Blockstudio valdoma „Early Serve“ būsena ir apšilimo tvarkaraščiai, tada išankstinio atvaizdavimo vykdymo aplinka lieka neregistruota. Vėl nustačius performance.profile į compat, atšaukiamas profilis. Kiti sluoksniai kiekvienu atveju lieka nepakeisti.

Našumas

Profiliai, profiliavimo įrankis ir juos palaikantys atvaizdavimo būdai.

Podėliavimas

Vienas podėlio katalogas, kuriame laikomi visi sugeneruoti artefaktai.