Statyczne prerenderowanie
Statyczne prerenderowanie to opcjonalna anonimowa pamięć podręczna HTML. Odpowiedź, którą można buforować, musi być kompletnym dokumentem HTML i może wyłączyć buforowanie za pomocą <!-- blockstudio:no-cache -->. Blockstudio pomija żądania inne niż GET, ciągi zapytania, panel administracyjny WordPress, REST, Ajax, cron, kanały, wyniki wyszukiwania poza bazą wyszukiwania w głównej ścieżce witryny (np. /search/term/), nagłówki podglądu i kanwy, żądania zawierające nonce, zadeklarowane dynamiczne ścieżki, pliki cookie haseł i komentarzy oraz domyślnie żądania zalogowanych użytkowników. Strona, której ścieżka zawiera jedynie segment search lub preview głębiej, np. /docs/blocks/preview/, jest buforowana tak jak każda inna strona.
{
"performance": {
"staticPrerender": {
"enabled": true,
"ttl": 3600,
"invalidate": "graph",
"earlyServe": true,
"serveLoggedIn": false,
"dynamicPaths": ["/account", "/checkout"],
"replayHeaders": ["Link"],
"warm": {
"enabled": true,
"interval": 900,
"concurrency": 4,
"transport": "http"
}
}
}
}
Zalogowani użytkownicy mogą korzystać z istniejącego trafienia tylko wtedy, gdy serveLoggedIn ma wartość true; spersonalizowane odpowiedzi nigdy nie tworzą wpisów w pamięci podręcznej. Dynamiczne ścieżki uwzględniają granice ścieżek, więc /account pasuje do /account/orders, ale nie do /accounting.
Gdy funkcja jest wyłączona, nie zapisuje plików, nie instaluje drop-inu ani nie rejestruje haków żądań lub administracyjnych. earlyServe: false również nie rejestruje wywołania zwrotnego Early Serve dla panelu administracyjnego, a warm.enabled: false nie rejestruje wywołania zwrotnego cron ani harmonogramu. Wyłączenie którejkolwiek z tych funkcji usuwa wcześniej należący do niej stan jeden raz; kolejne żądania nie sprawdzają już systemu plików ani nie wykonują kontroli czyszczenia cron.
Wyłączanie w danym środowisku
Każdą z powyższych wartości można również ustawić za pomocą filtra ustawień. Blockstudio uruchamia się przed aktywnym motywem, z wtyczki albo z autoloadera Composer motywu, dlatego po załadowaniu motywu ponownie odczytuje ustawienia środowiska uruchomieniowego i decyduje o hakach statycznego prerenderowania w after_setup_theme. Filtr dodany przez wtyczkę lub w pliku functions.php motywu zaczyna więc działać:
add_filter('blockstudio/settings/performance/staticPrerender/enabled', function ($enabled) {
return 'local' === wp_get_environment_type() ? false : $enabled;
});
Wyłączenie funkcji w ten sposób działa tak samo jak wyłączenie jej w blockstudio.json: nie są rejestrowane żadne haki żądań, treści, administracyjne ani cron, a wpis Early Serve witryny wcześniej obsługiwanej z wyprzedzeniem zostaje usunięty jeden raz. Filtr dodany później, na przykład w init, nie zmienia tego, które haki są rejestrowane.
Tryby sygnatury i grafu
Tryb signature tworzy odpowiedź z kluczem tożsamości po zwykłym chybieniu anonimowego żądania. Jest wygodny dla standardowych witryn WordPress i zmienia klucz po zmianach na poziomie witryny.
Tryb graph służy do deterministycznej integracji z procesem budowania i wdrażania. Wywołaj Static_Prerender_Runtime::build_plan() z aktywnymi źródłowymi adresami URL, renderuj tylko affectedUrls, a następnie zapisz każdy wynik za pomocą persist_built_response() lub persist_skipped_response(). Plan porównuje wspólne pliki i dokładne skróty zależności każdej strony. Usunięte adresy URL i nieużywane HTML są usuwane przez garbage_collect().
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']
);
}
$targets = array_keys($plan['live']);
Static_Prerender_Runtime::garbage_collect($targets);
Opcjonalne argumenty hosta i strony głównej docelowej przepisują trasy na potrzeby wdrożenia bez używania ścieżki pierwszej strony jako katalogu głównego witryny. Narzędzia wsadowe mogą używać Static_Prerender_Batch_Renderer::render() i stabilnych fragmentów N/TOTAL; opcje fragmentów obsługują Static_Prerender_Batch_Renderer::parse_shard() i select_shard(), dzięki czemu wywołujący może obliczyć ten sam podział, którego użyłby renderer. W trakcie budowania Static_Prerender_Batch_Renderer::is_rendering() określa, czy bieżące żądanie to renderowanie wsadowe, a nie wizyta użytkownika, więc szablon może pominąć działania, których nie należy wykonywać podczas budowania. Transport internal zapewnia ogólny filtr blockstudio/static_prerender/render_internal; opcjonalny mechanizm awaryjny HTTP używa standardowego nagłówka rozgrzewania pamięci podręcznej.
Co śledzi tryb grafu
Przy domyślnym transporcie HTTP, Static_Prerender_Batch_Renderer::render() wysyła do każdego żądania rozgrzewającego podpisany token, a żądanie zgłasza odczytane pliki: załadowany szablon WordPress, szablon każdego wyrenderowanego bloku Blockstudio, pliki szablonów i zasobów, pliki dodane przez blockstudio/render/dependencies oraz — w przypadku zsynchronizowanej strony — jej pliki definicji, szablonu, treści i układu. Raport jest zapisywany w katalogu pamięci podręcznej witryny, który renderer i serwer WWW już współdzielą z wyrenderowanym HTML. Przy następnym budowaniu build_plan() ponownie oblicza skróty tych plików i oznacza tylko trasy, których pliki się zmieniły, a także nowe trasy, trasy po upływie ich ttl oraz wszystkie trasy w przypadku zmiany wspólnego pliku (blockstudio.json, theme.json, style.css, functions.php, header.php, footer.php, wszystko w inc/, parts/ i templates/, a także źródła dołączonych zasobów UI z Blockstudio). Wspólna sygnatura jest obliczana na podstawie źródeł, nigdy skompilowanego wyniku, więc pliki _dist kompilowane podczas pierwszego renderowania w danym procesie budowania jej nie zmieniają: artifact_entry() wyprowadza identyfikator procesu budowania z tej samej sygnatury, którą build_plan() odczytał przed renderowaniem.
Treści przechowywane wyłącznie w bazie danych nie są plikami i nie są śledzone: wpisy edytowane w panelu administracyjnym, opcje, wygenerowane wiersze czy ceny. Proces budowania, który musi uwzględnić takie zmiany, przekazuje $force do build_plan() albo sam renderuje odpowiednie adresy URL. Transport internal rejestruje zależności zwracane przez jego filtr.
Wczesne serwowanie i wdrażanie atomowe
Po włączeniu earlyServe, Blockstudio zarządza małym wp-content/blockstudio-static-prerender-map.php, drop-inem advanced-cache.php oraz pojedynczą, dokładną deklaracją WP_CACHE. Drop-in odczytuje mapę tras dla danej witryny i przesyła kwalifikujące się trafienie, zanim uruchomi się WordPress, wtyczki lub motyw.
Blockstudio nigdy nie nadpisuje obcej mapy, drop-inu ani deklaracji WP_CACHE. Artefakty grafu sprawdzają poprawność każdego wskazanego pliku HTML przed podmianą mapy; jeśli walidacja się nie powiedzie, poprzedni graf pozostaje aktywny. Wpisy multisite współdzielą mapę, ale są od siebie odizolowane według hosta, ścieżki strony głównej i identyfikatora witryny. Wyłączenie funkcji lub dezaktywacja Blockstudio usuwa tylko wpis bieżącej witryny, a wspólne artefakty są usuwane dopiero po zniknięciu ostatniego należącego do niej wpisu.
Narzędzia wdrożeniowe mogą atomowo aktywować w pełni wyrenderowany graf:
$entry = Static_Prerender_Runtime::artifact_entry($targetUrls);
Blockstudio\Static_Prerender_Early_Serve::install_artifact_entry(
$entry,
Static_Prerender_Runtime::cache_root_path()
);
Konfiguracja pozostaje nadrzędna. install_artifact_entry() zwraca false, chyba że zarówno enabled, jak i earlyServe mają wartość true, więc wdrożenie nigdy nie zainstaluje mapy, drop-inu i deklaracji WP_CACHE, które kolejne żądanie z panelu administracyjnego ponownie usunie.
install_artifact_entry() zachowuje wartość build_id wpisu, dzięki czemu wdrożenie może porównać ją z wartością zwracaną później przez installed_map_entries(). Mapa jest plikiem PHP odczytywanym za pomocą include, a każdy zapis usuwa go z pamięci podręcznej kodów operacyjnych, dzięki czemu odczyt w tym samym procesie widzi nowy wpis, nawet gdy włączone jest opcache.enable_cli.
Zainstalowanie artefaktu przenosi jego dokumenty do dedykowanego zakresu artefaktu, którego nigdy nie dotyka przycinanie retencji, a pliki wskazane przez mapę są chronione przed eksmisją bez względu na miejsce przechowywania. Dzięki temu ruch renderowania na żywo nie może spowodować, że trasy z mapy wypadną z wczesnego serwowania. Klucz trasy nie jest w pełni adresowany zawartością, więc ponowne renderowanie może zmienić dokument bez zmiany jego klucza. Podczas instalacji porównywane są bajty, a różniący się dokument artefaktu jest atomowo zastępowany; identyczne dokumenty pozostają bez zmian, podobnie jak dokument artefaktu, którego kopia w magazynie zniknęła. Static_Prerender_Early_Serve::last_promotion() informuje, ile tras podczas ostatniej instalacji przeniesiono, zastąpiono, pominięto lub zachowano, więc wdrożenie może zapisać ten wynik w logu.
Zapisany dokument przypina zasoby procesu budowania, do których prowadzi przez URL, a te pliki mają własną retencję, więc jedno może przetrwać drugie. Przed serwowaniem zarówno pamięć podręczna PHP, jak i drop-in sprawdzają, czy powiązany arkusz stylów Tailwind, którego nazwa zawiera skrót zawartości, nadal istnieje na dysku. Dokument, któremu brakuje arkusza stylów, jest przekazywany do WordPress zamiast serwowany bez stylów; arkusz i dokument zostają wtedy opublikowane razem. To samo sprawdzenie odbywa się przed zapisaniem odpowiedzi, więc dokument, którego nie można było serwować, nigdy nie zostanie zapisany.
Żądanie, którego nagłówek Accept zawiera text/markdown, omija zarówno magazyn PHP, jak i drop-in, ponieważ zapisane dokumenty są HTML, a strona może odpowiedzieć na takie żądanie swoim źródłowym Markdown.
Serwowane dokumenty wysyłają więc Vary: Accept. Zaktualizowanie Blockstudio przepisuje starszy drop-in przy następnym zapisie mapy.
Zmapowane trasy grafu zawsze korzystają z aktywowanego artefaktu. Jeśli bezpiecznej, anonimowej trasy nie ma na tej mapie, ale WordPress zdążył ją już wyrenderować i utrwalić, Early Serve korzysta z zapasowego magazynu czasu działania z kluczem tożsamości, zanim uruchomi WordPress. Obsługuje to generowane trasy i trasy z długiego ogona poza celowo ograniczonym grafem wdrożenia. Mechanizm awaryjny korzysta z tożsamości aktywowanego grafu oraz tych samych reguł dotyczących hosta, normalizacji ścieżki, TTL, plików cookie, nagłówków, ciągu zapytania, dynamicznych ścieżek i pomijania kanałów co trasy z mapy. Znajduje wyłącznie dokumenty zapisane w magazynie czasu działania, który nigdy nie zawiera wyników wyszukiwania.
Nagłówki odpowiedzi
Zapisany dokument jest odtwarzany bez żądania, które go wygenerowało, więc nagłówek wysyłany przez motyw lub wtyczkę za pomocą header() byłby pomijany przy każdym trafieniu. Blockstudio zapisuje nagłówki wymienione w replayHeaders wraz z każdym dokumentem i wysyła je ponownie zarówno z pamięci podręcznej PHP, jak i z mechanizmu wczesnego serwowania. Domyślna wartość ["Link"] obejmuje nagłówki takie jak alternatywny adres Markdown (rel="alternate"; type="text/markdown"), rel="describedby" lub rel="canonical". Nazwy są dopasowywane bez uwzględniania wielkości liter, a filtr ustawień zmienia tę listę tak jak każdą inną wartość:
add_filter('blockstudio/settings/performance/staticPrerender/replayHeaders', function (array $headers): array {
$headers[] = 'X-Robots-Tag';
return $headers;
});
Ustaw replayHeaders na [], aby wyłączyć odtwarzanie nagłówków. Jawna lista zastępuje wartości domyślne, więc dodając inne nazwy nagłówków, uwzględnij Link, jeśli nadal chcesz odtwarzać nagłówki linków.
Nagłówki są przechwytywane w procesie renderującym stronę: z headers_list(), gdy zapisywane jest nietrafienie w pamięci podręcznej, oraz z samego żądania rozgrzewającego, gdy kompilacja lub mechanizm rozgrzewający renderuje stronę nad HTTP. Dlatego nagłówek dodawany samodzielnie przez serwer WWW i dodawany ponownie do każdego serwowanego dokumentu nigdy nie jest zapisywany. Tylko gdy renderowanie HTTP nie zapisze raportu, używane są nagłówki jego odpowiedzi. Transport internal zwraca je jako headers w wyniku, a persist_built_response() przyjmuje je jako ostatni argument — w postaci wierszy Name: value lub mapy nazw i wartości.
Są zapisywane w <key>.headers.json obok dokumentu, przechodzą razem z nim przez promocję artefaktów, zbieranie nieużywanych danych i przycinanie retencji, a także są usuwane, gdy ponowne renderowanie nie wysyła żadnych nagłówków. Nagłówki plików cookie, pamięci podręcznej i transportu nigdy nie są zapisywane ani odtwarzane, nawet jeśli znajdują się na liście: Set-Cookie, Cache-Control, Expires, Pragma, Age, ETag, Last-Modified, Vary, Content-Type, Content-Length, Content-Encoding, Transfer-Encoding, Location, Status, Date, a także nagłówki przeskokowe i uwierzytelniające. Serwowany dokument ustawia własne Content-Type i Vary.
Zapisane nagłówki są ponownie sprawdzane względem listy podczas wysyłania. Pamięć podręczna PHP odczytuje bieżące ustawienie; mechanizm wczesnego serwowania odczytuje kopię z wpisu mapy witryny, którą odświeża następna instalacja artefaktu lub synchronizacja mapy. Dokumenty zapisane przed aktualizacją nie mają pliku nagłówków i są serwowane dokładnie tak jak wcześniej, dopóki nie zostaną ponownie wyrenderowane.
Rozgrzewanie, konserwacja i obserwowalność
Kolejka rozgrzewania jest trwała, łączy równoczesne zadania URL, dopuszcza tylko jedno zadanie naraz i odzyskuje zadania z wygasłymi blokadami. Zmiany treści i witryny wymuszają zastępcze zadanie nawet wtedy, gdy bieżąca sygnatura się nie zmieniła; zadania cykliczne dodają tylko nieaktualne elementy. Każdy przebieg, zaplanowany lub uruchomiony przez wp bs prerender warm, renderuje maksymalnie warm.concurrency zadań. Tryb graph wyłącza rozgrzewanie dla poszczególnych URL, ponieważ artefakty grafu są budowane i aktywowane jako całość.
wp bs prerender warm
wp bs prerender status
wp bs prerender purge
wp bs prerender map status
wp bs prerender map prune --dry-run
status raportuje aktywną tożsamość, pliki, bajty, rekordy grafu, stan kolejki, raport mapy wczesnego serwowania oraz liczniki trafień, chybień, budowania i błędów dla poszczególnych zakresów.
Mapa wczesnego serwowania jest współdzielona przez wszystkie witryny w instalacji. map status (oraz Static_Prerender_Early_Serve::map_report()) wyświetla wpisy, których wczesne serwowanie nie może już użyć: wpisy orphaned dotyczące witryn, które już nie istnieją, oraz wpisy dead, których katalog został usunięty, a także liczbę dokumentów tras missing w pozostałych wpisach. map prune (Static_Prerender_Early_Serve::prune_map()) usuwa osierocone i nieaktywne wpisy przy blokadzie mapy i podaje przyczynę każdego usunięcia; --dry-run tylko wyświetla raport. Usunięcie ostatniego wpisu powoduje usunięcie mapy, drop-inu i deklaracji WP_CACHE. Usunięcie witryny z sieci multisite od razu usuwa jej wpisy, a czyszczenie pamięci podręcznej nigdy nie zbiera przestrzeni nazw, z której serwowany jest aktywowany artefakt. Wpisy stają się więc nieaktywne tylko wtedy, gdy ich pliki zostaną usunięte w inny sposób.
Obserwuj wyniki poszczególnych odpowiedzi za pomocą blockstudio/static_prerender/outcome, a wyniki wszystkich współdzielonych pamięci podręcznych — za pomocą blockstudio/cache/outcome.
Usuwanie
Instalacje bez haka dezaktywacji wtyczki, na przykład konfiguracje dołączone do Composer, mogą usunąć jednym poleceniem wszystko, czym zarządza ta funkcja:
wp bs teardown
Usuwa zdarzenia cron oraz stan statycznego prerenderowania należący do instalacji: wpis mapy bieżącej witryny, a po zniknięciu ostatniego należącego do niej wpisu także współdzielony drop-in i deklarację WP_CACHE. Pliki konfiguracyjne pozostają bez zmian, więc ponowne włączenie funkcji rozpoczyna się od czystego stanu.
Wdrażanie w środowisku produkcyjnym
Rozsądna kolejność wdrażania:
- Ustaw
performance.profilenaspeed, a następnie sprawdź wynik w sekcji head, kanały i wszystkie wtyczki korzystające z oEmbed lub XML-RPC. - Wygeneruj
assets/media.json, przenieś szablony dobs_media_image(), a następnie włączperformance.media.lazy. - Włącz
performance.staticPrerender, pozostawiającearlyServewyłączone, sprawdź trafienia za pomocąwp bs prerender status, a następnie włączearlyServe.
Wycofywanie zmian odbywa się oddzielnie dla każdej funkcji: ustawienie staticPrerender.enabled na false jednorazowo usuwa stan Early Serve i harmonogramy rozgrzewania należące do Blockstudio, a następnie pozostawia niezarejestrowane środowisko wykonawcze prerenderowania. Przywrócenie performance.profile do compat cofa profil. Pozostałe warstwy nie ulegają zmianie.
Profile, profiler i podstawowe techniki renderowania.
Jeden katalog pamięci podręcznej, w którym znajdują się wszystkie wygenerowane artefakty.