Preskočiť na obsah

Statické vykresľovanie, keď je to možné

Predvykreslené stránky a predvolené nastavenia pre produkciu, definované v blockstudio.json.

Predvykreslite stránky pre anonymných návštevníkov

Statické predvykresľovanie je predvolene vypnuté. Zapnite performance.staticPrerender a Blockstudio uloží celý dokument HTML, ktorý dostane anonymný návštevník, a ďalšiemu anonymnému návštevníkovi ho odošle z tejto kópie.

Požiadavky, ktoré musia zostať dynamické, sa ho nikdy nedotknú: požiadavky, ktoré nie sú GET, reťazce dopytu, administrácia, REST, Ajax, cron, kanály, vyhľadávanie, náhľady, stránky obsahujúce nonce, všetky cesty pod dynamicPaths a prihlásení návštevníci, pokiaľ nie je zapnuté serveLoggedIn.

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

Predvolene vypnuté

Nič sa nezmení, kým blockstudio.json nepomenuje túto funkciu.

Dynamické cesty

Dynamická cesta /account zahŕňa /account/orders, ale nie /accounting.

Značka na vyradenie z vyrovnávacej pamäte

Komentár blockstudio:no-cache zabráni uloženiu akejkoľvek odpovede do vyrovnávacej pamäte.

Prihlásení návštevníci

Pri zapnutom serveLoggedIn sa im zobrazujú uložené stránky; ich vlastné stránky sa nikdy neukladajú.

Vlastné obídenie

Filter static_prerender/request_bypass ponechá každú požiadavku, ktorú určíte, napríklad požiadavku so súborom cookie košíka, mimo uložených stránok.

Front na predhrievanie

Trvalý front opätovne vykresľuje zastarané stránky v nastavenom intervale.

Trasy s nízkou návštevnosťou

Aj trasy mimo nasadenej mapy sa poskytujú vopred, keď ich WordPress vykreslí a uloží.

Kontrola štýlových súborov

Uložená stránka s chýbajúcim prepojeným štýlovým súborom Tailwind sa znova vykreslí, takže sa nikdy neposkytne bez štýlov.

Odoslanie pred spustením WordPress

Keď je zapnuté earlyServe, Blockstudio nainštaluje doplnok advanced-cache.php, ktorý odošle uloženú stránku ešte pred načítaním WordPress, pluginov alebo témy. Nikdy neprepíše doplnok, mapu trás ani riadok WP_CACHE, ktorý nevytvoril.

Tento web ho používa. Dňa 8. októbra stránky 2026 blockstudio.dev odpovedali s x-blockstudio-static-prerender: HIT-EARLY, hlavičkou, ktorú doplnok odosiela.

Terminál
# 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

Aktualizácia po každej zmene

Predvolený režim signature naplní vyrovnávaciu pamäť pri požiadavke anonymného návštevníka, ak v nej stránka chýba, a obnoví ju po zmenách na úrovni webu. Uložením alebo odstránením príspevku sa vymaže jeho stránka a úvodná stránka, prípadne sa zaradia do frontu na opätovné vykreslenie, keď je zapnuté predhrievanie.

Režim graph je určený pre nástroje nasadzovania. Zaznamenáva súbory, ktoré jednotlivé stránky načítali, takže zostavenie znova vykreslí iba trasy, ktorých súbory sa zmenili, a potom aktivuje novú sadu ako jeden artefakt. Ak sa nepodarí overiť niektorý odkazovaný súbor, predchádzajúci artefakt zostane aktívny.

Inštalácia artefaktu porovná bajty a atomicky vymení zmenené dokumenty. last_promotion() uvádza počet trás, ktoré boli povýšené, nahradené, preskočené alebo ponechané, takže nasadenie môže tento údaj zaznamenať a porovnať ID aktívneho zostavenia.

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

Za CDN

Hlavička predbežného vykreslenia už uvádza, ktoré odpovede možno bezpečne zdieľať. Namapujte HIT a HIT-EARLY na dobu platnosti Cache-Control na pôvodnom serveri, ukladajte do vyrovnávacej pamäte iba odpovede, ktoré ju obsahujú, a obíďte okrajovú vyrovnávaciu pamäť pri súboroch cookie wordpress_logged_in_, wp-postpass_ a comment_author_email_, ako aj pri vašich dynamicPaths, wp-admin a wp-json.

Stránky uložené v okrajovej vyrovnávacej pamäti naďalej odkazujú na štýlový súbor s hašovaným obsahom, s ktorým boli vykreslené. Nastavte cache.namespaceGrace na najdlhší čas, počas ktorého môže takáto kópia existovať, a staré štýlové súbory zostanú na disku až do jeho uplynutia.

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;
}

Jeden aktívny blok na stránke z vyrovnávacej pamäte

Nastavte blockstudio.island na dynamic a stránka z vyrovnávacej pamäte bude namiesto bloku obsahovať zástupný prvok. Prehliadač zhromaždí všetky dynamické ostrovčeky na stránke a načíta ich úryvky v jednej dávkovej požiadavke; každý úryvok je podpísaný názvom bloku a jeho atribútmi zo zoznamu povolených.

hydrate ponechá na stránke celý HTML a odošle iba udalosť pripojenia. Dynamické ostrovčeky môžu počkať, kým sa stanú viditeľnými, obnoviť sa pri vyvolaní udalosti okna a ukladať úryvky do vyrovnávacej pamäte pre jednotlivých používateľov alebo globálne.

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

Zistite, kam smeruje čas vykresľovania

Pridajte ?blockstudio-perf do ľubovoľného frontendu URL a panel zobrazí časy vykresľovania jednotlivých blokov, počty volaní a fázy transformácie, šablóny a komponentu. Rovnaké časové údaje sa odosielajú aj v hlavičkách Server-Timing, ktoré fungujú aj vtedy, keď CDN ukladá HTML do vyrovnávacej pamäte.

Výstup vidia iba prihlásení používatelia s oprávnením edit_posts; pri všetkých ostatných požiadavkách sa profiler na init vypne. performance.measurement pridáva hlavičky s hašom profilu a konfigurácie a tiež Performance_Measurement::snapshot() API.

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

Jediný prepínač pre predvolené nastavenia produkcie

Nastavenie performance.profile na speed odstráni z hlavičky výstup generátora, emotikonov, kanálov a objavovania, odstráni objavovanie oEmbed, vypne XML-RPC a pingbacky, odstráni všeobecné zdroje jadra pre frontend, obmedzí Heartbeat mimo editorov a pri prejdení kurzorom alebo zameraní vopred načíta odkazy na rovnakej doméne.

Predvolená hodnota je compat, ktorá nič nemení. Každá podradená hodnota prepíše profil, takže si môžete ponechať jedno správanie a použiť zvyšok profilu.

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

Obrázky, ktoré si zachovajú priestor

Obrázky témy sú mimo knižnice médií, preto WordPress nepozná ich rozmery. bs_media_image() načíta skutočné rozmery z vygenerovaného assets/media.json a vyhradí miesto podľa pomeru strán ešte pred načítaním súboru.

Zapnite performance.media.lazy a skutočné URL sa načíta až po správne veľkom zástupnom obrázku, keď sa obrázok priblíži k oblasti zobrazenia.

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

Jeden priečinok vyrovnávacej pamäte

Každý vygenerovaný súbor sa nachádza v cache.path a jeho kľúčom je identita prostredia.

Zostavenia s jedným súbežným vykonaním

Jedna požiadavka zostaví kľúč, ktorý ešte nie je vo vyrovnávacej pamäti. Ostatné počkajú, použijú posledné platné dátové zaťaženie alebo dostanú odpoveď 503 s hlavičkou Retry-After.

Dátové zaťaženia vhodné pre OPcache

Malé dátové zaťaženia vyrovnávacej pamäte sú obyčajné polia PHP, ktoré môže OPcache opätovne použiť zo zdieľanej pamäte. Väčšie zostávajú komprimované.

Vyrovnávacia pamäť vykresľovania

Značka bloku s rovnakými atribútmi a samostatne uzatváracou značkou sa vykreslí raz za požiadavku. Opakované výskyty sa načítajú z pamäte.

Zlúčená obnova možností

Nárazový zápis obsahu, napríklad pri importe, vyvolá jedinú obnovu uložených možností vyplnených polí.

Vyrovnávacie pamäte pre viacerých nájomcov

Použite filter cache/site_key na nastavenie hranice vlastného nájomcu a cache/context pre varianty toho istého webu počas behu.

Zostavené zdroje vo vyrovnávacej pamäti

Keď je assets.output nastavené na cache, zostavené zdroje opustia strom blokov, takže nasadenie prebehne z nemenného pracovného priestoru.

Rozdelené zostavenia

Static_Prerender_Batch_Renderer rozdeľuje zostavenie na stabilné časti N/TOTAL a volajúci môže vypočítať rovnaké rozdelenie.

Vloženie malých štýlových súborov priamo do stránky

assets.inlineLimit vkladá najmenšie štýlové súbory blokov priamo do stránky v rámci limitu bajtov a zachováva rovnaké poradie kaskády.

Štýly bloku CSS ako posledné v hlavičke

Štýly bloku CSS sa pridávajú tesne pred uzatváraciu značku head, za štýlové súbory témy a doplnkov.

Vynechanie nepoužitých zdrojov

Šablóna, ktorá nič nevráti, nenačíta žiadne zdroje. Nastavenie assets.enqueue na false ponechá správu všetkých zdrojov na vás.

Príkazy vyrovnávacej pamäte

Príkazy wp bs cache status, cleanup a clear kontrolujú, vyprázdňujú a čistia vyrovnávaciu pamäť počas behu. Príkaz wp bs prerender purge odstráni uložené stránky.

Čisté odstránenie

Príkaz wp bs teardown odstráni iba stav, ktorý patrí tejto inštalácii.

Háky výsledkov

Hlásenia cache/outcome a static_prerender/outcome informujú o zásahoch, zostaveniach, neúspešných zásahoch a zlyhaniach a posielajú ich do vašich metrík.

Háčiky chýb

error/logged a error/exception odovzdávajú Blockstudio chyby externému loggeru alebo nástroju na sledovanie.

Dávkové vykresľovanie

Batch_Render::reset() vymaže stav požiadavky medzi dokumentmi spracovanými v jednom procese. render/dependencies uvádza súbory jednotlivých blokov.

Plus

Oficiálna súprava rozšírení

Prémiové šablóny webov, systémové pokyny pre AI a súkromná komunita Discord. Jednorazový nákup, aktualizácie na celý život.

  • 500+ šablón stránok
  • Systémové pokyny pre AI
  • Doživotné aktualizácie
  • Súkromná komunita Discord