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

[Statinis išankstinis atvaizdavimas](https://blockstudio.dev/lt/docs/production/static-prerendering/)

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

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

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.

[Ankstyvas pateikimas](https://blockstudio.dev/lt/docs/production/static-prerendering/#early-serving-and-atomic-deployment)

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.

[Parašo ir grafiko režimai](https://blockstudio.dev/lt/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']));
```

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

[CDN konfigūracija](https://blockstudio.dev/lt/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;
}
```

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

[Blokų salos](https://blockstudio.dev/lt/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"
      }
    }
  }
}
```

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

[Profiliavimo priemonė](https://blockstudio.dev/lt/docs/production/performance/#profiler)

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.

[Našumo profiliai](https://blockstudio.dev/lt/docs/production/performance/#performance-profiles)

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.

[Medija](https://blockstudio.dev/lt/docs/production/media/)

index.php

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

## [Vienas podėlio katalogas](https://blockstudio.dev/lt/docs/production/caching/)

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

## [Bendras vienkartinis komponavimas](https://blockstudio.dev/lt/docs/production/caching/#concurrency-and-retention)

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

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

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

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](https://blockstudio.dev/lt/docs/blocks/assets/registering/#load-order)

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

## [Praleiskite nenaudojamus išteklius](https://blockstudio.dev/lt/docs/blocks/assets/registering/#disable-enqueuing)

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

## [Talpyklos komandos](https://blockstudio.dev/lt/docs/dev/cli/)

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

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

## [Paketinis atvaizdavimas](https://blockstudio.dev/lt/docs/production/performance/#in-process-batch-rendering)

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ė

[Gaukite Plus](https://blockstudio.dev/lt/plus/)
