Serwowanie WordPress jako statycznego HTML
Większość stron marketingowych i dokumentacji wygląda tak samo dla każdego niezalogowanego odwiedzającego. WordPress nadal uruchamia się, ładuje wszystkie wtyczki, obsługuje motyw i renderuje bloki przy każdym żądaniu. Wtyczka buforująca strony może pomóc, ale to kolejny element systemu z własnymi zasadami dotyczącymi tego, co można bezpiecznie zapisywać.
Blockstudio oferuje opcjonalne statyczne renderowanie wstępne. Zapisuje kompletne dokumenty HTML dla niezalogowanych użytkowników we własnym katalogu bufora i — jeśli na to zezwolisz — serwuje je z wtyczki advanced-cache.php drop-in przed uruchomieniem WordPress. Całą konfigurację ustawia się w blockstudio.json.
Ten przewodnik krok po kroku włącza tę funkcję, pokazuje, jak sprawdzić, co jest buforowane, wyjaśnia jedną zasadę ochrony zalogowanych użytkowników, a na koniec przedstawia konfigurację CDN, która buforuje wyłącznie strony oznaczone przez serwer źródłowy jako możliwe do buforowania.
Jak obsługiwane jest żądanie
Po włączeniu renderowania wstępnego kwalifikujące się żądanie kończy się na jeden z trzech sposobów:
- Wczesne trafienie. Wtyczka drop-in znajduje zapisany dokument w mapie tras i przesyła go przed załadowaniem WordPress. Odpowiedź zawiera
X-Blockstudio-Static-Prerender: HIT-EARLY. - Trafienie. Uruchamia się WordPress, a w momencie
template_redirectBlockstudio znajduje aktualny zapisany dokument i wysyła go zamiast renderować szablon. Odpowiedź zawieraX-Blockstudio-Static-Prerender: HIT. - Chybienie. WordPress renderuje stronę normalnie. Jeśli odwiedzający nie jest zalogowany, a wynik jest kompletnym dokumentem HTML o statusie 200, Blockstudio zapisuje go na potrzeby następnego żądania.
Żądania, które nie spełniają warunków, w ogóle nie korzystają z bufora.
Krok 1: Włącz profil i bufor
Zacznij od profilu wydajności i renderowania wstępnego, pozostawiając wczesne serwowanie wyłączone:
{
"$schema": "https://blockstudio.dev/schema/blockstudio",
"performance": {
"profile": "speed",
"staticPrerender": {
"enabled": true,
"ttl": 86400,
"earlyServe": false,
"dynamicPaths": ["/account", "/checkout", "/login"],
"warm": {
"enabled": true,
"interval": 900,
"concurrency": 4
}
}
}
}
Działanie poszczególnych ustawień:
profile: "speed"włącza domyślne ustawienia produkcyjne frontendu: zbędne elementy nagłówka, wykrywanie oEmbed, XML-RPC i ogólne zasoby frontendu rdzenia są usuwane, a zamiary użytkownika powodują wstępne pobieranie linków do tej samej domeny. Usuwanie zasobów frontendu rdzenia to ustawienie, które należy sprawdzić w pierwszej kolejności, ponieważ strona, która od nich zależy, przestanie działać w widoczny sposób. Każda wartość podrzędna zastępuje ustawienie profilu.staticPrerender.enabledrejestruje środowisko uruchomieniowe. Gdy ma wartośćfalse, funkcja nie zapisuje plików ani nie rejestruje hooków żądań.ttlto maksymalny wiek zapisanego dokumentu w sekundach (domyślnie86400).dynamicPathszawiera prefiksy ścieżek, które zawsze muszą być renderowane na bieżąco.warmplanuje zadanie w tle, które ponownie renderuje nieaktualne publiczne adresy URL cointervalsekund.
Linia $schema obejmuje wszystkie klucze, więc edytor obsługujący schemat JSON zgłosi błędną wartość, taką jak "ttl": 0 (minimum to 1).
Krok 2: Sprawdź, co kwalifikuje się do buforowania
Blockstudio zachowuje ostrożność przy zapisywaniu danych. Te żądania zawsze omijają bufor:
- wszystkie żądania inne niż
GET - każde URL z ciągiem zapytania
wp-admin,wp-json,wp-login.php,xmlrpc.php, Ajax i cron- kanały, wyszukiwanie i podgląd ścieżek
- żądania z nagłówkiem
X-WP-Nonce - ścieżki w obrębie
dynamicPaths - odwiedzający z plikiem cookie
wordpress_logged_in_*,wp-postpass_*lubcomment_author_email_*, chyba że włączonoserveLoggedIn
Ścieżki dynamiczne są dopasowywane według granic ścieżek. Przy powyższej konfiguracji:
| Żądanie | Pominięte |
|---|---|
/pricing/ |
nie |
/account/orders/ |
tak |
/accounting/ |
nie |
/checkout |
tak |
/pricing/?utm_source=x |
tak |
/blog/feed/ |
tak |
Po stronie zapisu przechowywany jest tylko kompletny dokument: odpowiedź musi zaczynać się od <!doctype html lub <html, mieć status 200 i nie zawierać znacznika rezygnacji. Szablon, którego nie należy nigdy zapisywać, może umieścić ten znacznik w dowolnym miejscu strony:
<!-- blockstudio:no-cache -->
Strony błędów nigdy nie są zapisywane, więc stylizowana strona 404 nigdy nie zostanie odtworzona jako poprawna odpowiedź.
Krok 3: Sprawdź trafienia
Odwiedź kilka stron w oknie prywatnym, a następnie zapytaj Blockstudio, co zawiera bufor:
wp bs prerender status
{
"enabled": true,
"invalidate": "signature",
"identity": "e6cdd3fcda14ad6ded85a763bd01a33b",
"cacheRoot": ".../wp-content/blockstudio/cache/sites/.../static-prerender",
"files": 0,
"bytes": 0,
"records": 0,
"queue": {
"pending": 0,
"processing": 0,
"done": 0,
"unique": 0,
"bytes": 0
},
...
"diagnostics": []
}
files i bytes zwiększają się wraz z zapisywaniem dokumentów, queue pokazuje zaległe zadania procesu wstępnego podgrzewania, a diagnostics zawiera liczniki trafień, chybień, kompilacji i błędów dla poszczególnych zakresów. Aby sprawdzić pojedynczą stronę, zażądaj jej dwukrotnie jako niezalogowany użytkownik i poszukaj nagłówka:
curl -s -o /dev/null -D - https://example.com/pricing/ | grep -i x-blockstudio-static-prerender
Druga odpowiedź zawiera X-Blockstudio-Static-Prerender: HIT. Użyj GET, jak wyżej: curl -I wysyła żądanie HEAD, które zawsze omija bufor.
Krok 4: Serwuj przed uruchomieniem WordPress
Gdy trafienia wyglądają prawidłowo, ustaw "earlyServe": true. Blockstudio przejmuje wtedy zarządzanie trzema niewielkimi elementami stanu: wtyczką wp-content/advanced-cache.php drop-in, współdzieloną mapą tras wp-content/blockstudio-static-prerender-map.php oraz deklaracją WP_CACHE w wp-config.php. Zostaną zainstalowane przy następnym żądaniu administratora.
Kilka zasad zapewnia bezpieczeństwo na hostingu współdzielonym i w instalacji multisite:
- Blockstudio nigdy nie nadpisuje mechanizmu wczesnego serwowania, mapy ani wiersza
WP_CACHE, których nie jest właścicielem. Jeśli inna wtyczka do buforowania jest już właścicielemadvanced-cache.php, wczesne serwowanie pozostaje wyłączone. - Jeśli
WP_CACHEjest już zdefiniowane jakotrue,wp-config.phppozostaje bez zmian. Na hostingach, na którychwp-config.phpnie można zapisywać, zdefiniuj je samodzielnie. - Przed serwowaniem zarówno mechanizm wczesnego serwowania, jak i ścieżka PHP sprawdzają, czy arkusz stylów Tailwind o nazwie zawierającej skrót treści, do którego linkuje dokument, nadal istnieje. Jeśli nie, żądanie trafia do WordPress zamiast serwować stronę bez stylów.
- Wpisy Multisite korzystają ze wspólnej mapy, ale są od siebie odseparowane według hosta, ścieżki głównej i identyfikatora witryny.
- Nagłówki odpowiedzi wymienione w
replayHeaders, domyślnieLink, są zapisywane wraz z każdym dokumentem i wysyłane ponownie przy każdym trafieniu, dzięki czemu nagłówekLinkwysyłany przez stronę za pomocąheader()jest zachowywany podczas wczesnego serwowania. Nagłówki plików cookie i pamięci podręcznej nigdy nie są odtwarzane.
Trafienia z wczesnego serwowania zawierają X-Blockstudio-Static-Prerender: HIT-EARLY. Wyłączenie
earlyServe lub enabled usuwa stan, którym zarządza Blockstudio, a
wp bs teardown usuwa go jawnie w instalacjach Composer, które nie mają
haka dezaktywacji.
Zalogowani odwiedzający i identyczny znacznik
Domyślnie zalogowani odwiedzający zawsze otrzymują renderowanie na żywo. Ustawienie
"serveLoggedIn": true pozwala im korzystać również z istniejącego zapisanego dokumentu,
dzięki czemu witryna działa równie szybko dla redaktorów i klientów, jak dla anonimowych
odwiedzających.
Spersonalizowane odpowiedzi nigdy nie tworzą wpisów w pamięci podręcznej: przy braku trafienia zalogowany użytkownik otrzymuje renderowanie na żywo, które nie jest zapisywane. Łatwo przeoczyć konsekwencję. Gdy serveLoggedIn jest włączone, zalogowany odwiedzający otrzymuje dokument dla anonimowych użytkowników, jeśli taki istnieje, a spersonalizowane renderowanie na żywo tylko wtedy, gdy go nie ma. Każda gałąź szablonu zależna od bieżącego użytkownika pojawia się wyłącznie przy braku trafienia, więc ta sama strona zmienia się między wizytami, a spersonalizowana gałąź jest w praktyce martwa na trasach z pamięcią podręczną.
Wynikająca z tego zasada: na każdej trasie poza dynamicPaths znacznik zalogowanego użytkownika
musi być identyczny bajt po bajcie ze znacznikiem anonimowego użytkownika. Oznacza to, że w szablonach
renderowanych na trasach statycznych nie mogą występować gałęzie is_user_logged_in() ani wp_get_current_user():
<?php // Do not do this on a static route. ?>
<?php if ( is_user_logged_in() ) : ?>
<a href="/account/">Hi, <?php echo esc_html( wp_get_current_user()->display_name ); ?></a>
<?php else : ?>
<a href="/login/">Sign in</a>
<?php endif; ?>
Są dwa proste rozwiązania. Przenieś trasę do dynamicPaths, gdy cała strona jest osobista, na przykład panel konta. Albo pozostaw stronę statyczną i wyrenderuj część osobistą jako dynamiczną wyspę bloku, która umieszcza bezpieczny dla pamięci podręcznej symbol zastępczy w zapisanym HTML i pobiera rzeczywisty fragment w żądaniu danego odwiedzającego:
<?php echo bs_block( array( 'name' => 'acme/greeting' ) ); ?>
Przewodnik Spersonalizowane fragmenty na stronach z pamięcią podręczną opisuje budowę tego bloku.
Unieważnianie sygnatury lub grafu
invalidate określa sposób wygasania zapisanych dokumentów.
| Aspekt | signature (domyślnie) |
graph |
|---|---|---|
| Kto wypełnia pamięć podręczną | anonimowe braki trafień i mechanizm rozgrzewający | etap kompilacji i anonimowe braki trafień |
| Co powoduje wygaśnięcie wpisów | TTL, zapisy postów, zmiany na poziomie witryny | nowa kompilacja; TTL wyznacza górną granicę |
| Mechanizm rozgrzewający w tle | dostępny | wyłączony |
| Dla kogo | zwykłe witryny | witryny z potokiem wdrożeniowym |
Tryb signature nie wymaga żadnych narzędzi. Zapisanie posta czyści pamięć podręczną lub ponownie ją rozgrzewa dla strony głównej i bezpośredniego odnośnika do tego posta, a zmiany na poziomie witryny, takie jak zmiana motywu, obracają tożsamość pamięci podręcznej.
Tryb graph służy do deterministycznych wdrożeń. Kompilacja oblicza plan za pomocą
Static_Prerender_Runtime::build_plan(), renderuje tylko zmienione adresy URL,
zapisuje każdy wynik i aktywuje gotowy zestaw atomowo za pomocą
Static_Prerender_Early_Serve::install_artifact_entry(). Jeśli walidacja któregokolwiek odwołującego się dokumentu nie powiedzie się, poprzedni zestaw pozostaje aktywny. Mapowane trasy są serwowane z aktywowanego artefaktu do czasu zastąpienia go przez następną kompilację, więc treści edytowane w wp-admin trafiają na te trasy przy kolejnym wdrożeniu. Mechanizm rozgrzewający dla URL jest w tym trybie wyłączony, ponieważ artefakty są kompilowane i aktywowane jako jedna całość. Typowa konfiguracja produkcyjna wygląda tak:
{
"performance": {
"profile": "speed",
"staticPrerender": {
"enabled": true,
"invalidate": "graph",
"ttl": 2592000,
"earlyServe": true,
"serveLoggedIn": true,
"dynamicPaths": [
"/account",
"/cart",
"/checkout",
"/login",
"/reset-password"
]
}
}
}
30-dniowy ttl ogranicza jedynie maksymalny wiek serwowanego dokumentu. Świeżość zapewnia wdrożenie, które ponownie kompiluje graf. Kompilacja API, podział na fragmenty i wewnętrzny transport renderowania są opisane w dokumencie Odniesienie do prerenderowania statycznego.
Umieszczanie CDN z przodu
Prerenderowanie wskazuje już, które odpowiedzi można bezpiecznie udostępniać: dokładnie te, które zawierają nagłówek HIT. Niech serwer źródłowy przekształci go w nagłówek pamięci podręcznej, a CDN niech podąża za serwerem źródłowym. W przypadku nginx z PHP-FPM z przodu:
map $upstream_http_x_blockstudio_static_prerender $edge_cache_control {
"~^HIT" "public, s-maxage=604800";
default "";
}
server {
listen 80;
server_name example.com;
root /var/www/html;
index index.php;
location / {
try_files $uri $uri/ /index.php?$args;
}
location ~ \.php$ {
include fastcgi_params;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
fastcgi_pass unix:/run/php/php-fpm.sock;
add_header Cache-Control $edge_cache_control;
}
}
Wyrażenie regularne pasuje zarówno do HIT, jak i HIT-EARLY. Dla każdej innej
odpowiedzi zmienna jest pusta, a nginx nie dodaje nagłówka z pustą wartością, więc braki trafień, dynamiczne ścieżki i renderowania dla zalogowanych użytkowników nie otrzymują od serwera źródłowego wspólnego czasu przechowywania w pamięci podręcznej.
Po stronie CDN:
- Zapisuj w pamięci podręcznej HTML tylko wtedy, gdy serwer źródłowy wysyła czas przechowywania w pamięci podręcznej. Wyłącz domyślny TTL na brzegu sieci dla odpowiedzi, które go nie mają.
- Pomijaj pamięć podręczną na brzegu sieci dla tych samych plików cookie Blockstudio, które traktuje jako osobiste (
wordpress_logged_in_,wp-postpass_,comment_author_email_), oraz dla twoichdynamicPaths,wp-adminiwp-json. - Czyść CDN po każdym wdrożeniu zmieniającym strony, szablony lub zasoby. Pamięć podręczna serwera źródłowego obraca się samoczynnie; warstwa brzegowa nie wie, że powinna to zrobić.
Jeśli używasz Tailwind z "output": "link", arkusz stylów URL ma hash treści, więc tę ścieżkę można serwować z długim, niezmiennym nagłówkiem pamięci podręcznej.
Polecenia konserwacyjne
wp bs prerender warm
wp bs prerender status
wp bs prerender purge
wp bs teardown
warm dodaje nieaktualne publiczne adresy URL do kolejki i renderuje do warm.concurrency z nich podczas jednego uruchomienia, wyświetlając podsumowanie JSON. purge usuwa zapisane dokumenty bieżącej witryny i jej kolejkę. teardown usuwa zdarzenia cron oraz stan wczesnego serwowania należący do tej instalacji, pozostawiając pliki konfiguracyjne bez zmian.
Wdrażaj w tej kolejności: najpierw profil, potem prerenderowanie z wyłączonym earlyServe, a następnie wczesne serwowanie, gdy status i nagłówki będą wyglądać poprawnie. Każdą warstwę można wycofać niezależnie, przywracając jej poprzednią wartość.
Następne kroki
- Odniesienie do prerenderowania statycznego: kompilowanie grafów, aktywacja artefaktów, okres przechowywania i mechanizmy obserwowalności.
- Wydajność: co zmienia profil
speedi jak to zmierzyć. - Buforowanie: katalog pamięci podręcznej, w którym znajdują się wszystkie zapisane dokumenty.
- Spersonalizowane fragmenty na stronach z pamięcią podręczną: treści dla poszczególnych odwiedzających na trasach statycznych.
- Wdrażanie witryny Blockstudio: miejsce synchronizacji stron, czyszczenia pamięci podręcznej i rozgrzewania w procesie wydania.