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.
{
"performance": {
"staticPrerender": {
"enabled": true,
"ttl": 3600,
"earlyServe": true,
"dynamicPaths": ["/account", "/checkout"]
}
}
}<!-- blockstudio:no-cache -->
<p class="stock">
<?php echo esc_html( $a['label'] ); ?>
</p>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.
# 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 teardowncurl -sI https://blockstudio.dev/ | grep -i x-blockstudio
# x-blockstudio-static-prerender: HIT-EARLYAktualność 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.
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']));use Blockstudio\Static_Prerender_Early_Serve;
use Blockstudio\Static_Prerender_Runtime;
$entry = Static_Prerender_Runtime::artifact_entry($targetUrls);
Static_Prerender_Early_Serve::install_artifact_entry(
$entry,
Static_Prerender_Runtime::cache_root_path()
);
$counts = Static_Prerender_Early_Serve::last_promotion();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.
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;
}{
"cache": {
"namespaceGrace": 777600
},
"tailwind": {
"enabled": true,
"output": "link"
}
}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.
{
"name": "acme/cart-count",
"title": "Cart count",
"blockstudio": {
"island": {
"mode": "dynamic",
"attributes": ["productId"],
"loading": "visible",
"event": "cart:updated",
"cache": {
"ttl": 60,
"per": "user"
}
}
}
}<div class="cart-count-placeholder">
Loading cart...
</div>window.dispatchEvent(new Event('cart:updated'));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.
{
"dev": {
"perf": true
},
"performance": {
"measurement": {
"enabled": true,
"headers": true,
"timings": true
}
}
}use Blockstudio\Performance_Measurement;
$snapshot = Performance_Measurement::snapshot();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.
{
"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.
<?php
echo bs_media_image([
'src' => 'assets/images/hero.webp',
'alt' => 'Hero',
'eager' => true,
]);{
"performance": {
"media": {
"lazy": true,
"skeleton": true,
"metadata": true,
"rootMargin": "300px"
}
}
}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.
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