Siirry sisältöön

Staattinen aina kun mahdollista

Esirenderöidyt sivut ja tuotannon oletusasetukset määritetään kohteessa blockstudio.json.

Esirenderöi anonyymit sivut

Staattinen esirenderöinti on oletuksena pois päältä. Ota käyttöön performance.staticPrerender, niin Blockstudio tallentaa jokaisen anonyymille kävijälle toimitetun kokonaisen HTML-dokumentin ja vastaa sitten seuraavalle anonyymille kävijälle tätä kopiota käyttäen.

Pyyntöjä, jotka on käsiteltävä reaaliajassa, ei koskaan ohjata sen kautta: muut kuin GET-pyynnöt, kyselymerkkijonot, ylläpito, REST, Ajax, cron, syötteet, haut, esikatselut, nonce-tunnisteen sisältävät sivut, kaikki polut hakemiston dynamicPaths alla sekä sisäänkirjautuneet kävijät, ellei serveLoggedIn ole käytössä.

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

Oletuksena pois päältä

Mikään ei muutu, ennen kuin blockstudio.json määrittää toiminnon.

Dynaamiset polut

Dynaaminen polku /account kattaa polun /account/orders, mutta ei polkua /accounting.

Käytöstä poiston merkki

blockstudio:no-cache-kommentti pitää kaikki vastaukset pois välimuistista.

Sisäänkirjautuneet kävijät

Kun serveLoggedIn on käytössä, he näkevät tallennetut sivut, mutta heidän omia sivujaan ei koskaan tallenneta.

Mukautettu ohitus

static_prerender/request_bypass-suodatin pitää nimeämäsi pyynnöt, kuten ostoskorievästeen sisältävät pyynnöt, tallennettujen sivujen ulkopuolella.

Lämmitysjono

Pysyvä jono renderöi vanhentuneet sivut uudelleen määrittämälläsi aikavälillä.

Pitkän hännän reitit

Myös käyttöönottokartan ulkopuoliset reitit tarjoillaan nopeasti, kun WordPress on renderöinyt ja tallentanut ne.

Tyylitiedoston tarkistus

Tallennettu sivu, jonka linkitetty Tailwind-tyylitiedosto puuttuu, renderöidään uudelleen; sivua ei koskaan tarjoilla ilman tyylejä.

Toimitetaan ennen kuin WordPress käynnistyy

Kun earlyServe on käytössä, Blockstudio asentaa advanced-cache.php-drop-inin, joka toimittaa tallennetun sivun ennen kuin WordPress, lisäosat tai teema latautuvat. Se ei koskaan korvaa drop-inia, reittikarttaa tai WP_CACHE-riviä, jota se ei itse kirjoittanut.

Tämä sivusto käyttää sitä. Lokakuun 8. päivänä 2026 blockstudio.dev-sivut vastasivat tunnisteella x-blockstudio-static-prerender: HIT-EARLY, jonka drop-in lähettää otsakkeessa.

Pääte
# 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

Päivittyy jokaisen muutoksen jälkeen

Oletustilassa signature välimuisti täyttyy anonyymin kävijän välimuistiosuman puuttuessa ja päivittyy sivustotason muutosten jälkeen. Julkaisun tallentaminen tai poistaminen tyhjentää kyseisen julkaisun ja etusivun välimuistin tai asettaa ne uudelleenrenderöitäviksi, kun lämmitys on käytössä.

graph-tila on tarkoitettu julkaisutyökaluille. Se tallentaa kunkin sivun lukemat tiedostot, joten koonti renderöi uudelleen vain niiden tiedostot muuttaneet reitit ja ottaa sitten uuden kokonaisuuden käyttöön yhtenä artefaktina. Jos viitattu tiedosto ei läpäise validointia, edellinen artefakti pysyy käytössä.

Artefaktin asennus vertaa tavut ja vaihtaa muuttuneet dokumentit atomisesti. last_promotion() ilmoittaa, kuinka monta reittiä otettiin käyttöön, korvattiin, ohitettiin tai säilytettiin, jotta käyttöönotto voidaan kirjata ja aktiivisen koontitunnuksen kanssa vertailla.

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

CDNn takana

Esirenderöinnin otsake kertoo jo, mitkä vastaukset voi jakaa turvallisesti. Määritä HIT ja HIT-EARLY alkuperäpalvelimella Cache-Control-elinkaareen, välimuistita vain ne, joissa sellainen on, ja ohita reunapalvelin evästeille wordpress_logged_in_, wp-postpass_ ja comment_author_email_ sekä omille evästeillesi dynamicPaths, wp-admin ja wp-json.

Reunavälimuistissa olevat sivut linkittävät edelleen sisällön tiivisteellä nimettyyn tyylitiedostoon, jolla ne renderöitiin. Nosta cache.namespaceGrace pisimpään aikaan, jonka tällainen kopio voi olla käytössä, niin vanhat tyylitiedostot säilyvät levyllä sen ajan umpeutumiseen asti.

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

Yksi reaaliaikainen lohko välimuistitetulla sivulla

Määritä blockstudio.island arvoksi dynamic, niin välimuistitetulla sivulla lohkon tilalla on paikkamerkki. Selain kerää sivun kaikki dynaamiset saarekkeet ja hakee niiden osat yhdellä eräpyynnöllä. Kunkin osan allekirjoitus sisältää lohkon nimen ja sen sallittujen attribuuttien luettelon.

hydrate säilyttää koko HTML-sisällön sivulla ja lähettää vain mount-tapahtuman. Dynaamiset saarekkeet voivat odottaa näkyviin tuloaan, päivittyä ikkunatapahtuman käynnistyessä ja välimuistittaa osia käyttäjäkohtaisesti tai maailmanlaajuisesti.

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

Katso, mihin renderöintiaika kuluu

Lisää ?blockstudio-perf mihin tahansa käyttöliittymän URL-elementtiin, niin paneelissa näkyvät lohkojen renderöintiajat, kutsumäärät sekä muunnos-, malli- ja komponenttivaiheet. Samat ajoitustiedot lisätään myös Server-Timing-otsakkeisiin, jotka toimivat silloinkin, kun CDN välimuistittaa HTMLn.

Tuloksen näkevät vain kirjautuneet käyttäjät, joilla on edit_posts, ja kaikissa muissa pyynnöissä profilointi poistetaan käytöstä kohdassa init. performance.measurement lisää profiili- ja määritystiivisteotsakkeet sekä Performance_Measurement::snapshot() APIn.

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

Yksi kytkin tuotannon oletusasetuksille

Kun performance.profile-asetukseksi valitaan speed, otsakkeesta poistetaan generaattori-, emoji-, syöte- ja hakemistotiedot, oEmbed-haku poistetaan käytöstä, XML-RPC ja pingbackit poistetaan käytöstä, WordPressin yleiset käyttöliittymän resurssit poistetaan, Heartbeatin toimintaa rajoitetaan editorien ulkopuolella ja saman alkuperän linkit esiladataan osoittimen ollessa niiden päällä tai niiden saadessa kohdistuksen.

Oletusarvo on compat, joka ei muuta mitään. Kukin lapsiarvo ohittaa profiilin, joten voit säilyttää yhden toiminnan ja ottaa muut käyttöön.

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

Kuvat, joille varataan tila

Teeman kuvat eivät ole mediakirjastossa, joten WordPress ei tiedä niiden kokoa. bs_media_image() lukee todelliset mitat luodusta assets/media.json-tiedostosta ja varaa kuvasuhteen mukaisen tilan ennen tiedoston latautumista.

Ota käyttöön performance.media.lazy, niin varsinainen URL pysyy oikean kokoisen paikkamerkin takana, kunnes kuva lähestyy näkymäaluetta.

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

Yksi välimuistihakemisto

Kaikki luodut tiedostot sijaitsevat hakemistossa cache.path, ja niiden avaimena on suoritusajan tunniste.

Yksi koonti kerrallaan

Yksi pyyntö rakentaa kylmän välimuistiavaimen. Muut odottavat, käyttävät uudelleen viimeisintä kelvollista hyötykuormaa tai saavat 503-vastauksen, jossa on Retry-After.

OPcache-ystävälliset hyötykuormat

Pienet välimuistin hyötykuormat ovat tavallisia PHP-taulukoita, jotka OPcache voi käyttää uudelleen jaetusta muistista. Suuremmat pysyvät pakattuina.

Renderöintivälimuisti

Itsensä sulkeva lohkomerkintä samoilla attribuuteilla renderöidään kerran pyyntöä kohti. Toistot haetaan muistista.

Yhdistetty valintojen päivitys

Sisältökirjoitusten ryöppy, kuten tuonti, muuttuu yhdeksi välimuistissa olevien täytettyjen kenttävalintojen päivitykseksi.

Monivuokralaisvälimuistit

Suodata cache/site_key omalle vuokralaisrajallesi ja cache/context saman sivuston ajonaikaisille muunnelmille.

Käännetyt resurssit välimuistissa

Kun assets.output on asetettu arvoon cache, käännetyt resurssit poistuvat lohkopuusta, joten käyttöönotto onnistuu muuttumattomasta työkopiosta.

Jaetut koonnit

Static_Prerender_Batch_Renderer jakaa koonnin vakaisiin N/TOTAL-osioihin, ja kutsuja voi laskea saman osituksen.

Lisää pienet tyylitiedostot sisäisesti

assets.inlineLimit lisää pienimmät lohkojen tyylitiedostot sisäisesti tavurajan puitteissa ja samassa CSS-kaskadin järjestyksessä.

Lohkon CSS viimeiseksi head-osaan

Lohkon CSS lisätään juuri ennen sulkevaa head-tunnistetta teeman ja lisäosien tyylitiedostojen jälkeen.

Ohita käyttämättömät resurssit

Tyhjän tuloksen palauttava malli ei lisää resursseja jonoon. assets.enqueue false jättää kaikki resurssit sinun vastuullesi.

Välimuistikomennot

wp bs cache status, cleanup ja clear tarkastelevat, tyhjentävät ja poistavat ajonaikaisen välimuistin. wp bs prerender purge poistaa tallennetut sivut.

Siisti poistaminen

wp bs teardown poistaa vain tämän asennuksen omistaman tilan.

Tuloksen käsittelykoukut

cache/outcome- ja static_prerender/outcome-raportit näyttävät osumien, koontiversioiden, ohitusten ja virheiden määrät mittareissasi.

Virhekäsittelijät

error/logged ja error/exception välittävät Blockstudio-virheet ulkoiseen lokitus- tai seurantapalveluun.

Eräkohtainen renderöinti

Batch_Render::reset() tyhjentää pyyntötilan asiakirjojen välillä yhdessä prosessissa. render/dependencies luettelee kunkin lohkon tiedostot.

Plus

Virallinen laajennuspaketti

Premium-sivupohjia, tekoälyn järjestelmäohjeita ja yksityinen Discord-yhteisö. Kertamaksu, elinikäiset päivitykset.

  • 500+ sivustomallia
  • Tekoälyn järjestelmäohjeet
  • Elinikäiset päivitykset
  • Yksityinen Discord-yhteisö