Przejdź do treści

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:

  1. 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.
  2. Trafienie. Uruchamia się WordPress, a w momencie template_redirect Blockstudio znajduje aktualny zapisany dokument i wysyła go zamiast renderować szablon. Odpowiedź zawiera X-Blockstudio-Static-Prerender: HIT.
  3. 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:

JSON
{
  "$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.enabled rejestruje środowisko uruchomieniowe. Gdy ma wartość false, funkcja nie zapisuje plików ani nie rejestruje hooków żądań.
  • ttl to maksymalny wiek zapisanego dokumentu w sekundach (domyślnie 86400).
  • dynamicPaths zawiera prefiksy ścieżek, które zawsze muszą być renderowane na bieżąco.
  • warm planuje zadanie w tle, które ponownie renderuje nieaktualne publiczne adresy URL co interval sekund.

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_* lub comment_author_email_*, chyba że włączono serveLoggedIn

Ś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:

HTML
<!-- 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:

Powłoka
wp bs prerender status
JSON
{
    "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:

Powłoka
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ścicielem advanced-cache.php, wczesne serwowanie pozostaje wyłączone.
  • Jeśli WP_CACHE jest już zdefiniowane jako true, wp-config.php pozostaje bez zmian. Na hostingach, na których wp-config.php nie 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ślnie Link, są zapisywane wraz z każdym dokumentem i wysyłane ponownie przy każdym trafieniu, dzięki czemu nagłówek Link wysył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
<?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
<?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:

JSON
{
  "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:

Nginx
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 twoich dynamicPaths, wp-admin i wp-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

Powłoka
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