Pereiti prie turinio

Statinis, kai įmanoma

Iš anksto sugeneruoti puslapiai ir gamybinės aplinkos numatytieji nustatymai konfigūruojami sistemoje blockstudio.json.

Iš anksto sugeneruokite anoniminių lankytojų puslapius

Pagal numatytuosius nustatymus statinis išankstinis generavimas išjungtas. Įjunkite performance.staticPrerender, ir Blockstudio išsaugos kiekvieną visą HTML dokumentą, kurį gauna anoniminis lankytojas, o kitam anonimiam lankytojui pateiks jo kopiją.

Užklausos, kurios turi būti apdorojamos įprastai, čia nepatenka: ne GET užklausos, užklausos su eilutėmis, administravimo skydas, REST, Ajax, cron, sklaidos kanalai, paieška, peržiūros, puslapiai su nonce, visi keliai po dynamicPaths ir prisijungę lankytojai, nebent įjungta serveLoggedIn.

blockstudio.json
{
  "performance": {
    "staticPrerender": {
      "enabled": true,
      "ttl": 3600,
      "earlyServe": true,
      "dynamicPaths": ["/account", "/checkout"]
    }
  }
}

Pagal numatytuosius nustatymus išjungta

Nieko nekeičiama, kol blockstudio.json nenurodo funkcijos.

Dinaminiai keliai

Dinaminis kelias /account apima /account/orders, bet ne /accounting.

Atsisakymo žymeklis

blockstudio:no-cache komentaras neleidžia jokio atsakymo įtraukti į podėlį.

Prisijungę lankytojai

Naudojant serveLoggedIn, jiems pateikiami išsaugoti puslapiai; jų pačių puslapiai niekada neišsaugomi.

Pasirinktinis apėjimas

Filtras static_prerender/request_bypass neleidžia saugomuose puslapiuose pateikti jūsų nurodytų užklausų, pavyzdžiui, turinčių krepšelio slapuką.

Pašildymo eilė

Patvari eilė iš naujo atvaizduoja pasenusius puslapius jūsų nustatytu intervalu.

Rečiau lankomi maršrutai

Maršrutai, kurių nėra įdiegtame žemėlapyje, taip pat pateikiami iš anksto, kai WordPress juos atvaizduoja ir išsaugo.

Stilių lentelės patikra

Jei išsaugotame puslapyje nurodytos Tailwind stilių lentelės nebėra, puslapis atvaizduojamas iš naujo ir niekada nepateikiamas be stilių.

Pateikiamas prieš paleidžiant WordPress

Įjungus earlyServe, Blockstudio įdiegia advanced-cache.php drop-in, kuris perduoda išsaugotą puslapį dar prieš įkeliant WordPress, įskiepius ar temą. Jis niekada neperrašo drop-in, maršrutų žemėlapio ar WP_CACHE eilutės, kurios pats neįrašė.

Ši svetainė jį naudoja. Spalio 8 d. 2026 blockstudio.dev puslapiai atsakė su x-blockstudio-static-prerender: HIT-EARLY – antrašte, kurią siunčia drop-in.

Terminalas
# Identity, files, queue, and hit/miss counters
wp bs prerender status

# Re-render stale entries now
wp bs prerender warm

# Dead or orphaned early-serve map entries
wp bs prerender map status
wp bs prerender map prune --dry-run

# Remove the drop-in and map this install owns
wp bs teardown

Atnaujinama po kiekvieno pakeitimo

Numatytasis signature režimas užpildo podėlį, kai anoniminio lankytojo užklausa jo neranda, ir atnaujina jį po visos svetainės pakeitimų. Išsaugojus ar ištrynus įrašą, išvalomas jo ir pagrindinis puslapis arba, įjungus pašildymą, jų atvaizdavimas įtraukiamas į eilę.

graph režimas skirtas diegimo įrankiams. Jis įrašo, kuriuos failus skaitė kiekvienas puslapis, todėl atliekant komponavimą iš naujo atvaizduojami tik maršrutai, kurių failai pasikeitė, o naujas rinkinys aktyvinamas kaip vienas artefaktas. Jei nurodyto failo patikra nepavyksta, ankstesnis artefaktas lieka aktyvus.

Diegiant artefaktą palyginami baitai, o pasikeitę dokumentai pakeičiami atominiu būdu. last_promotion() nurodo, kiek maršrutų perkelta į aktyvią versiją, pakeista, praleista arba palikta, todėl diegimo procesas gali tai užregistruoti ir palyginti aktyvios versijos ID.

deploy.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']
  );
}

Static_Prerender_Runtime::garbage_collect(array_keys($plan['live']));

Už CDN

Išankstinio atvaizdavimo antraštėje jau nurodyta, kuriais atsakymais saugu dalytis. Susiekite HIT ir HIT-EARLY su Cache-Control galiojimo trukme kilmės serveryje, talpykloje saugokite tik tai, kas ją turi, o užklausas su slapukais wordpress_logged_in_, wp-postpass_ ir comment_author_email_, jūsų dynamicPaths, wp-admin bei wp-json apeikite kraštiniame serveryje.

Kraštinėje talpykloje saugomi puslapiai ir toliau pateikia nuorodą į turinio maiša pažymėtą stilių lentelę, su kuria buvo atvaizduoti. Nustatykite cache.namespaceGrace į ilgiausią laiką, kurį tokia kopija gali galioti, o pašalintos stilių lentelės liks diske, kol šis laikas baigsis.

nginx.conf
map $upstream_http_x_blockstudio_static_prerender $edge_cache_control {
  "~^HIT"  "public, s-maxage=604800";
  default  "";
}

location ~ \.php$ {
  include fastcgi_params;
  fastcgi_pass unix:/run/php/php-fpm.sock;
  add_header Cache-Control $edge_cache_control;
}

Vienas dinaminis blokas talpykloje saugomame puslapyje

Nustatykite blockstudio.island į dynamic – talpykloje saugomame puslapyje vietoj bloko bus rodoma vietaženklė. Naršyklė surenka visas dinamines saleles puslapyje ir viena paketine užklausa gauna jų fragmentus, kiekvieną pasirašytą bloko pavadinimu ir leidžiamais atributais.

hydrate puslapyje išsaugo visą HTML ir siunčia tik prijungimo įvykį. Dinaminės salelės gali laukti, kol taps matomos, atsinaujinti suveikus lango įvykiui ir saugoti fragmentus kiekvienam naudotojui arba bendrai.

block.json
{
  "name": "acme/cart-count",
  "title": "Cart count",
  "blockstudio": {
    "island": {
      "mode": "dynamic",
      "attributes": ["productId"],
      "loading": "visible",
      "event": "cart:updated",
      "cache": {
        "ttl": 60,
        "per": "user"
      }
    }
  }
}

Sužinokite, kam skiriamas atvaizdavimo laikas

Pridėkite ?blockstudio-perf prie bet kurio frontend URL – skydelyje bus pateikti kiekvieno bloko atvaizdavimo laikai, iškvietimų skaičius ir transformavimo, šablono bei komponento etapai. Tas pats laikas pateikiamas ir Server-Timing antraštėse, kurios veikia net jei CDN saugo HTML talpykloje.

Rezultatus mato tik prisijungę naudotojai, turintys edit_posts, o visų kitų užklausų atveju profiliavimo priemonė išjungiama ties init. performance.measurement prideda profilio ir konfigūracijos maišos antraštes bei Performance_Measurement::snapshot() API.

blockstudio.json
{
  "dev": {
    "perf": true
  },
  "performance": {
    "measurement": {
      "enabled": true,
      "headers": true,
      "timings": true
    }
  }
}

Vienas jungiklis gamybinės aplinkos numatytiesiems nustatymams

Nustačius performance.profile į speed, iš antraštės pašalinama generatoriaus, jaustukų, sklaidos kanalų ir aptikimo informacija, išjungiama oEmbed aptikimo funkcija, XML-RPC ir pingback, pašalinami bendrieji pagrindinės sistemos frontend ištekliai, apribojamas Heartbeat veikimas ne redaktoriuose, o užvedus pelės žymeklį ar perkėlus į jį klaviatūros fokusą iš anksto įkeliamos tos pačios svetainės nuorodos.

Numatytoji reikšmė yra compat, kuri nieko nekeičia. Kiekviena antrinė reikšmė pakeičia profilio nustatymą, todėl galite palikti vieną elgseną ir naudoti likusias.

blockstudio.json
{
  "performance": {
    "profile": "speed",
    "preload": {
      "links": "off"
    }
  }
}

Vaizdai, kuriems išsaugoma vieta

Temos vaizdai saugomi ne medijos bibliotekoje, todėl WordPress nežino jų dydžio. bs_media_image() nuskaito tikruosius matmenis iš sugeneruoto assets/media.json ir rezervuoja kraštinių santykį dar prieš įkeliant failą.

Įjunkite performance.media.lazy, ir tikrasis URL bus rodomas už tinkamo dydžio vietaženklio, kol vaizdas priartės prie matomos srities.

index.php
<?php
echo bs_media_image([
  'src' => 'assets/images/hero.webp',
  'alt' => 'Hero',
  'eager' => true,
]);

Vienas podėlio katalogas

Visi sugeneruoti failai saugomi po cache.path ir atskiriami pagal vykdymo aplinkos identifikatorių.

Bendras vienkartinis komponavimas

Vienas užklausos procesas sukuria dar neužpildytos talpyklos raktą. Kiti laukia, pakartotinai naudoja paskutinį tinkamą duomenų rinkinį arba gauna 503 atsakymą su antrašte Retry-After.

OPcache pritaikyti duomenų rinkiniai

Maži talpyklos duomenų rinkiniai yra paprasti PHP masyvai, kuriuos OPcache gali pakartotinai naudoti iš bendrosios atminties. Didesni lieka suspausti.

Atvaizdavimo talpykla

Savaime užsidarantis bloko žymeklis su tais pačiais atributais per užklausą atvaizduojamas vieną kartą. Pakartotiniai atvaizdavimo rezultatai gaunami iš atminties.

Sujungtas pasirinkimų atnaujinimas

Keli iš eilės turinio įrašymai, pavyzdžiui, importas, sujungiami į vieną talpykloje saugomų užpildytų laukų pasirinkimų atnaujinimą.

Kelių nuomininkų talpyklos

Filtruokite cache/site_key, kad nustatytumėte savo nuomininkų ribas, o cache/context – toje pačioje svetainėje veikiančius variantus.

Kompiliuoti ištekliai talpykloje

Kai assets.output nustatyta kaip cache, kompiliuoti ištekliai pašalinami iš blokų medžio, todėl galima diegti iš nekintančios kodo kopijos.

Skirtingų dalių komponavimas

Static_Prerender_Batch_Renderer padalija komponavimą į stabilias N/TOTAL dalis, o iškvietėjas gali apskaičiuoti tą patį skaidinį.

Įterpkite mažas stilių lenteles

assets.inlineLimit įterpia mažiausias blokų stilių lenteles tiesiai į puslapį pagal baitų limitą ir ta pačia kaskados tvarka.

Bloko CSS stilių lentelė – paskutinė galvutėje

Bloko CSS stilių lentelė pridedama prieš pat uždarant head žymą, po temos ir papildinių stilių lentelių.

Praleiskite nenaudojamus išteklius

Šablonas, kuris nieko negrąžina, neįtraukia jokių išteklių. assets.enqueue false perduoda visų išteklių valdymą jums.

Talpyklos komandos

wp bs cache status, cleanup ir clear komandos tikrina, ištuština ir išvalo vykdymo laiko talpyklą. wp bs prerender purge pašalina išsaugotus puslapius.

Švarus pašalinimas

wp bs teardown pašalina tik šio diegimo valdomus duomenis.

Rezultatų veiksmai

cache/outcome ir static_prerender/outcome ataskaitose pateikiami pasiekimų, kūrimo, praleidimų ir nesėkmių duomenys jūsų metrikoms.

Klaidų apdorojimo funkcijos

error/logged ir error/exception perduoda Blockstudio klaidas išoriniam žurnalo įrankiui arba stebėjimo sistemai.

Paketinis atvaizdavimas

Batch_Render::reset() išvalo užklausos būseną tarp dokumentų tame pačiame procese. render/dependencies išvardija kiekvieno bloko failus.

Plus

Oficialus plėtinių rinkinys

Aukščiausios klasės svetainių šablonai, DI sistemos instrukcijos ir privati Discord bendruomenė. Vienkartinis pirkimas, atnaujinimai visam laikui.

  • 500+ svetainių šablonų
  • AI sistemos instrukcijos
  • Naujiniai visam laikui
  • Privati Discord bendruomenė