Przejdź do treści

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.

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

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

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.

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.

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.

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.

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.

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.

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.

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

Jeden katalog pamięci podręcznej

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

Kompilacje w trybie single-flight

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

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

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ść

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

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

Pomijanie nieużywanych zasobów

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

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

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

Renderowanie wsadowe

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