# Statycznie, gdy to możliwe

Strony renderowane wstępnie i domyślne ustawienia produkcyjne skonfigurowane w blockstudio.json.

## Renderuj strony anonimowe wstępnie

Statyczne renderowanie wstępne jest domyślnie wyłączone. Włącz `performance.staticPrerender`, a Blockstudio będzie przechowywać każdy kompletny dokument HTML przekazany anonimowemu odwiedzającemu, a następnie odpowie kolejnemu anonimowemu odwiedzającemu, korzystając z tej kopii.

Żądania, które muszą być obsługiwane na bieżąco, nigdy go nie używają: żądania inne niż GET, ciągi zapytania, panel administracyjny, REST, Ajax, cron, kanały, wyszukiwanie, podglądy, strony zawierające nonce, każda ścieżka w `dynamicPaths` oraz zalogowani użytkownicy, chyba że włączono `serveLoggedIn`.

[Wstępne renderowanie statyczne](https://blockstudio.dev/pl/docs/production/static-prerendering/)

blockstudio.json

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

## Domyślnie wyłączone

Nic się nie zmieni, dopóki blockstudio.json nie wskaże tej funkcji.

## Ścieżki dynamiczne

Ścieżka dynamiczna /account obejmuje /account/orders, ale nie /accounting.

## Znacznik wyłączenia

Komentarz blockstudio:no-cache wyklucza każdą odpowiedź z pamięci podręcznej.

## Zalogowani użytkownicy

Dzięki serveLoggedIn zalogowani użytkownicy odczytują zapisane strony; ich własne strony nigdy nie są zapisywane.

## [Własne pomijanie](https://blockstudio.dev/pl/docs/blocks/hooks/php/#blockstudio-static_prerender-request_bypass)

Filtr static_prerender/request_bypass nie pozwala zapisywać w pamięci stron dla wskazanych przez Ciebie żądań, na przykład zawierających ciasteczko koszyka.

## Kolejka wstępnego generowania

Trwała kolejka ponownie renderuje nieaktualne strony w ustawionych przez Ciebie odstępach czasu.

## [Trasy o małym ruchu](https://blockstudio.dev/pl/docs/production/static-prerendering/#early-serving-and-atomic-deployment)

Trasy spoza wdrożonej mapy również są obsługiwane z wyprzedzeniem, gdy tylko WordPress je wyrenderuje i zapisze.

## Kontrola arkusza stylów

Zapisana strona, której powiązany arkusz stylów Tailwind zniknął, jest renderowana ponownie i nigdy nie zostaje wyświetlona bez stylów.

## Obsługiwane przed uruchomieniem WordPress

Gdy `earlyServe` jest włączone, Blockstudio instaluje wtyczkę typu drop-in `advanced-cache.php`, która strumieniuje zapisaną stronę, zanim zostaną załadowane WordPress, wtyczki lub motyw. Nigdy nie nadpisuje drop-inu, mapy tras ani linii `WP_CACHE`, której nie utworzyło.

Ta witryna z niego korzysta. 8 października 2026 strony blockstudio.dev odpowiadały z `x-blockstudio-static-prerender: HIT-EARLY`, nagłówkiem wysyłanym przez drop-in.

[Wczesne serwowanie](https://blockstudio.dev/pl/docs/production/static-prerendering/#early-serving-and-atomic-deployment)

Terminal

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

## Aktualność po każdej zmianie

Domyślny tryb `signature` zapełnia pamięć podręczną przy nietrafieniu anonimowego użytkownika i odświeża ją po zmianach na poziomie witryny. Zapisanie lub usunięcie wpisu czyści jego stronę i stronę główną albo umieszcza je w kolejce do ponownego renderowania, gdy włączone jest wstępne generowanie.

Tryb `graph` służy narzędziom wdrożeniowym. Zapisuje pliki odczytane przez każdą stronę, dzięki czemu kompilacja renderuje ponownie tylko trasy, których pliki uległy zmianie, a następnie aktywuje nowy zestaw jako jeden artefakt. Jeśli plik, do którego istnieje odwołanie, nie przejdzie walidacji, poprzedni artefakt pozostaje aktywny.

Instalacja artefaktu porównuje bajty i atomowo podmienia zmienione dokumenty. `last_promotion()` informuje, ile tras wdrożono, zastąpiono, pominięto lub zachowano, dzięki czemu wdrożenie może to zarejestrować i porównać identyfikator aktywnej kompilacji.

[Tryby sygnatury i grafu](https://blockstudio.dev/pl/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']));
```

## Za CDN

Nagłówek prerenderowania już wskazuje, które odpowiedzi można bezpiecznie udostępniać. Powiąż `HIT` i `HIT-EARLY` z czasem życia `Cache-Control` na serwerze źródłowym, buforuj tylko odpowiedzi z tym nagłówkiem, a dla ciasteczek `wordpress_logged_in_`, `wp-postpass_` i `comment_author_email_` oraz Twoich `dynamicPaths`, `wp-admin` i `wp-json` pomijaj węzeł brzegowy.

Strony buforowane na węźle brzegowym nadal odwołują się do arkusza stylów z hashem zawartości, z którym zostały wyrenderowane. Ustaw `cache.namespaceGrace` na najdłuższy czas życia takiej kopii, a wycofane arkusze stylów pozostaną na dysku do jego upływu.

[Konfiguracja CDN](https://blockstudio.dev/pl/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;
}
```

## Jeden aktywny blok na buforowanej stronie

Ustaw `blockstudio.island` na `dynamic`, a buforowana strona będzie zawierać element zastępczy zamiast bloku. Przeglądarka zbiera wszystkie dynamiczne wyspy na stronie i pobiera ich fragmenty w jednym zbiorczym żądaniu; każdy fragment jest podpisany nazwą bloku i jego dozwolonymi atrybutami.

`hydrate` zachowuje pełną wartość HTML na stronie i wysyła tylko zdarzenie montowania. Dynamiczne wyspy mogą czekać, aż staną się widoczne, odświeżać się po wystąpieniu zdarzenia okna oraz buforować fragmenty dla użytkownika lub globalnie.

[Wyspy bloków](https://blockstudio.dev/pl/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"
      }
    }
  }
}
```

## Sprawdź, na co przypada czas renderowania

Dodaj `?blockstudio-perf` do dowolnego frontendowego URL, aby panel wyświetlał czasy renderowania każdego bloku, liczbę wywołań oraz fazy transformacji, szablonu i komponentów. Te same czasy są przekazywane w nagłówkach `Server-Timing`, które działają również wtedy, gdy CDN buforuje HTML.

Wynik widzą tylko zalogowani użytkownicy z `edit_posts`, a dla wszystkich pozostałych żądań profiler jest wyłączany na poziomie `init`. `performance.measurement` dodaje nagłówki z profilem i hashem konfiguracji oraz `Performance_Measurement::snapshot()` API.

[Profiler](https://blockstudio.dev/pl/docs/production/performance/#profiler)

blockstudio.json

```
{
  "dev": {
    "perf": true
  },
  "performance": {
    "measurement": {
      "enabled": true,
      "headers": true,
      "timings": true
    }
  }
}
```

## Jeden przełącznik dla ustawień produkcyjnych

Ustawienie `performance.profile` na `speed` usuwa z sekcji head informacje o generatorze, emoji, kanałach i wykrywaniu, wyłącza wykrywanie oEmbed, wyłącza XML-RPC i pingbacki, usuwa ogólne zasoby frontendu WordPressa, ogranicza Heartbeat poza edytorami oraz wstępnie pobiera odnośniki do tej samej domeny po najechaniu kursorem lub uzyskaniu fokusu.

Domyślnie ustawiona jest wartość `compat`, która niczego nie zmienia. Każda wartość podrzędna zastępuje profil, więc możesz zachować jedno działanie i zmienić pozostałe.

[Profile wydajności](https://blockstudio.dev/pl/docs/production/performance/#performance-profiles)

blockstudio.json

```
{
  "performance": {
    "profile": "speed",
    "preload": {
      "links": "off"
    }
  }
}
```

## Obrazy, które zachowują swoje miejsce

Obrazy motywu znajdują się poza biblioteką mediów, więc WordPress nie zna ich rozmiarów. `bs_media_image()` odczytuje rzeczywiste wymiary z wygenerowanego `assets/media.json` i rezerwuje proporcje obrazu, zanim plik zostanie załadowany.

Włącz `performance.media.lazy`, a właściwy URL pozostanie za prawidłowo dopasowanym elementem zastępczym, dopóki obraz nie znajdzie się blisko widocznego obszaru.

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

index.php

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

## [Jeden katalog pamięci podręcznej](https://blockstudio.dev/pl/docs/production/caching/)

Każdy wygenerowany plik znajduje się w cache.path, a jego kluczem jest tożsamość środowiska uruchomieniowego.

## [Kompilacje w trybie single-flight](https://blockstudio.dev/pl/docs/production/caching/#concurrency-and-retention)

Jedno żądanie buduje brakujący klucz pamięci podręcznej. Pozostałe czekają, korzystają z ostatniego poprawnego ładunku albo otrzymują 503 z nagłówkiem Retry-After.

## Ładunki przyjazne dla OPcache

Małe ładunki pamięci podręcznej są zwykłymi tablicami PHP, które OPcache może ponownie wykorzystywać z pamięci współdzielonej. Większe pozostają skompresowane.

## [Pamięć podręczna renderowania](https://blockstudio.dev/pl/docs/production/performance/#render-cache)

Tag bloku bez treści, mający te same atrybuty, jest renderowany raz na żądanie. Kolejne użycia korzystają z pamięci.

## Łączne odświeżanie opcji

Seria zapisów treści, na przykład import, powoduje jedno odświeżenie zapisanych, wypełnionych opcji pól.

## Pamięci podręczne dla wielu dzierżawców

Użyj filtrów cache/site_key, aby określić granicę własnego dzierżawcy, oraz cache/context dla wariantów środowiska wykonawczego tej samej witryny.

## [Skompilowane zasoby w pamięci podręcznej](https://blockstudio.dev/pl/docs/general/settings/#assets)

Gdy assets.output ma wartość cache, skompilowane zasoby opuszczają drzewo bloków, dzięki czemu wdrożenie odbywa się z niezmiennej kopii roboczej.

## Kompilacje podzielone na fragmenty

Static_Prerender_Batch_Renderer dzieli kompilację na stabilne fragmenty N/TOTAL, a wywołujący może obliczyć ten sam podział.

## [Wstawianie małych arkuszy stylów w treść](https://blockstudio.dev/pl/docs/blocks/assets/registering/#inline-small-stylesheets)

assets.inlineLimit wstawia najmniejsze arkusze stylów bloków bezpośrednio w treść, w ramach limitu bajtów i z zachowaniem tej samej kolejności kaskady.

## [Blok CSS na końcu sekcji head](https://blockstudio.dev/pl/docs/blocks/assets/registering/#load-order)

Blok CSS jest dodawany tuż przed zamykającym tagiem head, za arkuszami stylów motywu i wtyczek.

## [Pomijanie nieużywanych zasobów](https://blockstudio.dev/pl/docs/blocks/assets/registering/#disable-enqueuing)

Szablon, który niczego nie zwraca, nie dołącza żadnych zasobów. assets.enqueue false przekazuje Ci pełną kontrolę nad każdym zasobem.

## [Polecenia pamięci podręcznej](https://blockstudio.dev/pl/docs/dev/cli/)

Polecenia wp bs cache status, cleanup i clear sprawdzają, opróżniają i czyszczą pamięć podręczną środowiska wykonawczego. wp bs prerender purge usuwa zapisane strony.

## Czyste usuwanie

wp bs teardown usuwa tylko stan należący do tej instalacji.

## Haki wyników

cache/outcome i static_prerender/outcome raportują trafienia, kompilacje, braki i błędy w Twoich metrykach.

## [Hooki błędów](https://blockstudio.dev/pl/docs/blocks/hooks/php/#error-handling)

error/logged i error/exception przekazują błędy Blockstudio do zewnętrznego loggera lub narzędzia do śledzenia.

## [Renderowanie wsadowe](https://blockstudio.dev/pl/docs/production/performance/#in-process-batch-rendering)

Batch_Render::reset() czyści stan żądania między dokumentami w jednym procesie. render/dependencies wyświetla pliki każdego bloku.

Plus

## Oficjalny zestaw rozszerzeń

Wysokiej jakości szablony witryn, systemowe instrukcje AI i prywatna społeczność Discord. Jednorazowy zakup, dożywotnie aktualizacje.

- 500+ szablonów stron
- Instrukcje systemowe AI
- Dożywotnie aktualizacje
- Prywatna społeczność Discord

[Uzyskaj Plus](https://blockstudio.dev/pl/plus/)
