# 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ä.

[Staattinen esirenderöinti](https://blockstudio.dev/fi/docs/production/static-prerendering/)

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](https://blockstudio.dev/fi/docs/blocks/hooks/php/#blockstudio-static_prerender-request_bypass)

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](https://blockstudio.dev/fi/docs/production/static-prerendering/#early-serving-and-atomic-deployment)

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.

[Varhainen toimitus](https://blockstudio.dev/fi/docs/production/static-prerendering/#early-serving-and-atomic-deployment)

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.

[Allekirjoitus- ja graafitilat](https://blockstudio.dev/fi/docs/production/static-prerendering/#signature-and-graph-modes)

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.

[CDN-määritys](https://blockstudio.dev/fi/guides/static-prerendering/#putting-a-cdn-in-front)

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.

[Lohkosaarekkeet](https://blockstudio.dev/fi/docs/blocks/islands/)

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.

[Profilointi](https://blockstudio.dev/fi/docs/production/performance/#profiler)

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.

[Suorituskykyprofiilit](https://blockstudio.dev/fi/docs/production/performance/#performance-profiles)

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.

[Media](https://blockstudio.dev/fi/docs/production/media/)

index.php

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

## [Yksi välimuistihakemisto](https://blockstudio.dev/fi/docs/production/caching/)

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

## [Yksi koonti kerrallaan](https://blockstudio.dev/fi/docs/production/caching/#concurrency-and-retention)

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](https://blockstudio.dev/fi/docs/production/performance/#render-cache)

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](https://blockstudio.dev/fi/docs/general/settings/#assets)

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](https://blockstudio.dev/fi/docs/blocks/assets/registering/#inline-small-stylesheets)

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

## [Lohkon CSS viimeiseksi head-osaan](https://blockstudio.dev/fi/docs/blocks/assets/registering/#load-order)

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](https://blockstudio.dev/fi/docs/blocks/assets/registering/#disable-enqueuing)

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

## [Välimuistikomennot](https://blockstudio.dev/fi/docs/dev/cli/)

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](https://blockstudio.dev/fi/docs/blocks/hooks/php/#error-handling)

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

## [Eräkohtainen renderöinti](https://blockstudio.dev/fi/docs/production/performance/#in-process-batch-rendering)

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ö

[Hanki Plus](https://blockstudio.dev/fi/plus/)
