Přejít k obsahu

Poskytování WordPress jako statického HTML

Většina stránek na marketingovém webu nebo webu s dokumentací je pro všechny anonymní návštěvníky stejná. WordPress se přesto spouští, načítá všechny pluginy, spouští motiv a při každém požadavku vykresluje bloky. Plugin pro ukládání stránek do mezipaměti může pomoci, přidává ale další součást s vlastními pravidly pro bezpečné ukládání.

Blockstudio nabízí statické předvykreslení, které lze zapnout. Ukládá celé anonymní dokumenty HTML do vlastního adresáře mezipaměti a po povolení je poskytuje prostřednictvím vložky advanced-cache.php ještě před spuštěním WordPress. Vše se konfiguruje v blockstudio.json.

Tento průvodce vás krok za krokem provede zapnutím funkce, ukáže, jak zkontrolovat, co se ukládá a co ne, vysvětlí jediné pravidlo pro bezpečnost přihlášených návštěvníků a na závěr představí nastavení CDN, které ukládá do mezipaměti pouze to, co zdrojový server označí jako vhodné.

Jak se obsluhují požadavky

Když je předvykreslení zapnuté, způsobilý požadavek končí jedním ze tří způsobů:

  1. Okamžitá shoda. Vložka najde uložený dokument v mapě tras a odešle jej před načtením WordPress. Odpověď obsahuje X-Blockstudio-Static-Prerender: HIT-EARLY.
  2. Shoda. Spustí se WordPress a v template_redirect Blockstudio najde aktuální uložený dokument a odešle ho místo vykreslení šablony. Odpověď obsahuje X-Blockstudio-Static-Prerender: HIT.
  3. Neshoda. WordPress stránku vykreslí obvyklým způsobem. Pokud je návštěvník anonymní a výsledkem je úplný dokument HTML se stavem 200, Blockstudio jej uloží pro další požadavek.

Požadavky, které nesplňují podmínky, se mezipaměti vůbec nedotknou.

Krok 1: Zapněte profil a mezipaměť

Začněte výkonnostním profilem a předvykreslením, přičemž předčasné poskytování nechte vypnuté:

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
      }
    }
  }
}

Co dělají jednotlivé části:

  • profile: "speed" zapíná produkční výchozí nastavení frontendu: odstraňuje nadbytečné prvky hlavičky, vyhledávání oEmbed, XML-RPC a obecné prostředky frontendu jádra; odkazy na stejném webu se při záměru přednačítají. Odstranění prostředků frontendu jádra je první nastavení, které je třeba otestovat, protože stránky na nich závislé přestanou viditelně fungovat. Každá podřízená hodnota přepíše profil.
  • staticPrerender.enabled registruje prostředí za běhu. Dokud je false, funkce nevytváří žádné soubory ani neregistruje hooky požadavků.
  • ttl je maximální stáří uloženého dokumentu v sekundách (výchozí hodnota 86400).
  • dynamicPaths obsahuje předpony cest, které se vždy musí vykreslit aktuálně.
  • warm plánuje běh nástroje na pozadí, který každých interval sekund znovu vykreslí zastaralé veřejné adresy URL.

Řádek $schema pokrývá všechny klíče, takže editor s podporou schématu JSON označí chybu, jako je "ttl": 0 (minimum je 1).

Krok 2: Zjistěte, které požadavky splňují podmínky

Blockstudio ukládá obsah konzervativně. Tyto požadavky vždy obejdou mezipaměť:

  • vše kromě GET
  • libovolná URL s řetězcem dotazu
  • wp-admin, wp-json, wp-login.php, xmlrpc.php, Ajax a cron
  • kanály, vyhledávání a náhledy
  • požadavky s hlavičkou X-WP-Nonce
  • cesty pod dynamicPaths
  • návštěvníci s cookies wordpress_logged_in_*, wp-postpass_* nebo comment_author_email_*, pokud není zapnuté serveLoggedIn

Dynamické cesty se porovnávají podle hranic cest. S výše uvedenou konfigurací:

Požadavek Obejde mezipaměť
/pricing/ ne
/account/orders/ ano
/accounting/ ne
/checkout ano
/pricing/?utm_source=x ano
/blog/feed/ ano

Ukládají se pouze úplné dokumenty: odpověď musí začínat na <!doctype html nebo <html, musí mít stav 200 a nesmí obsahovat značku pro vyřazení z mezipaměti. Šablona, která se nikdy nemá ukládat, může značku vypsat kamkoli na stránce:

HTML
<!-- blockstudio:no-cache -->

Chybové stránky se nikdy neukládají, takže stylizovanou stránku 404 nelze nikdy znovu zobrazit jako úspěšnou odpověď.

Krok 3: Ověřte shody

Navštivte několik stránek v anonymním okně a poté se zeptejte Blockstudio, co uchovává:

Shell
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": []
}

Objemy files a bytes rostou s ukládáním dokumentů, queue zobrazuje nevyřízené úlohy nástroje na pozadí a diagnostics obsahuje počitadla shod, neshod, sestavení a chyb pro jednotlivé rozsahy. Chcete-li ověřit jednu stránku, požádejte o ni dvakrát jako anonymní návštěvník a vyhledejte hlavičku:

Shell
curl -s -o /dev/null -D - https://example.com/pricing/ | grep -i x-blockstudio-static-prerender

Druhá odpověď obsahuje X-Blockstudio-Static-Prerender: HIT. Použijte GET jako výše: curl -I odešle požadavek HEAD, který mezipaměť vždy obchází.

Krok 4: Poskytování před spuštěním WordPress

Jakmile shody vypadají správně, nastavte "earlyServe": true. Blockstudio pak spravuje tři malé části stavu: vložku wp-content/advanced-cache.php, sdílenou mapu tras wp-content/blockstudio-static-prerender-map.php a deklaraci WP_CACHE v wp-config.php. Nainstalují se při příštím požadavku v administraci.

Několik pravidel pomáhá zachovat bezpečnost na sdíleném hostingu a ve více webech:

  • Blockstudio nikdy nepřepíše doplněk, mapu ani řádek WP_CACHE, které nevlastní. Pokud advanced-cache.php již patří jinému pluginu pro ukládání do mezipaměti, včasné podávání zůstane vypnuté.
  • Pokud je WP_CACHE již definováno jako true, wp-config.php zůstane beze změny. Na hostitelích, kde není možné zapisovat do wp-config.php, jej definujte sami.
  • Před podáním doplněk i cesta PHP ověřují, zda stále existuje stylesheet Tailwind s obsahem určeným hashem, na který dokument odkazuje. Pokud neexistuje, požadavek se místo podání bez stylů předá do WordPress.
  • Položky Multisite sdílejí jednu mapu, ale jsou odděleny podle hostitele, domovské cesty a ID webu.
  • Hlavičky odpovědi uvedené v replayHeaders, ve výchozím nastavení Link, se ukládají s každým dokumentem a znovu se odesílají při každém zásahu. Hlavička Link, kterou stránka odešle s header(), tak přežije včasné podání. Hlavičky souborů cookie a mezipaměti se nikdy znovu neodesílají.

Předčasně obsloužené požadavky nesou X-Blockstudio-Static-Prerender: HIT-EARLY. Vypnutím earlyServe nebo enabled se jednou odstraní stav, který spravuje Blockstudio, a wp bs teardown jej explicitně odstraní pro instalace Composer, které nemají deaktivační hook.

Přihlášení návštěvníci a totožné značky HTML

Ve výchozím nastavení se přihlášeným návštěvníkům vždy zobrazí živě vykreslený obsah. Nastavení "serveLoggedIn": true jim umožní použít i již uložený dokument, takže web bude pro editory a zákazníky stejně rychlý jako pro anonymní návštěvníky.

Personalizované odpovědi nikdy nevytvářejí položky mezipaměti: při nenalezené položce se přihlášenému návštěvníkovi obsah vykreslí živě a neuloží se. Důsledek lze snadno přehlédnout. Když je serveLoggedIn zapnuté, přihlášený návštěvník dostane anonymní dokument, kdykoli existuje, a personalizovaně vykreslený obsah pouze tehdy, když neexistuje. Každá větev šablony závislá na aktuálním uživateli se projeví jen při nenalezené položce, takže se stejná stránka mezi návštěvami mění a personalizovaná větev je na trasách s mezipamětí prakticky nefunkční.

Z toho plyne toto pravidlo: na každé trase mimo dynamicPaths musí být značení HTML pro přihlášené uživatele bajtově totožné se značením pro anonymní uživatele. To znamená žádné větve is_user_logged_in() ani wp_get_current_user() v šablonách vykreslovaných na statických trasách:

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; ?>

Existují dvě čistá řešení. Pokud je celá stránka osobní, například nástěnka účtu, přesuňte trasu do dynamicPaths. Nebo stránku ponechte statickou a osobní část vykreslete jako dynamický blokový ostrov, který do uloženého HTML vloží zástupný obsah bezpečný pro mezipaměť a skutečný fragment načte v rámci vlastního požadavku návštěvníka:

PHP
<?php echo bs_block( array( 'name' => 'acme/greeting' ) ); ?>

Průvodce Personalized Fragments on Cached Pages popisuje vytvoření takového bloku.

Neplatnost podle podpisu nebo grafu

invalidate určuje, jak uložené dokumenty vyprší.

Aspekt signature (výchozí) graph
Kdo plní mezipaměť anonymní požadavky při nenalezení a předehřívač váš krok sestavení a anonymní požadavky při nenalezení
Co způsobuje vypršení položek TTL, uložení příspěvků, změny na úrovni webu nové sestavení, přičemž TTL je horní hranice
Předehřívač na pozadí k dispozici vypnutý
Vhodné pro běžné weby weby s nasazovacím procesem

Režim signature nevyžaduje žádné nástroje. Uložením příspěvku se vyprázdní mezipaměť nebo znovu předehřeje domovská stránka a trvalý odkaz příspěvku. Změny na úrovni webu, například přepnutí šablony, změní identitu mezipaměti.

Režim graph je určen pro deterministická nasazení. Sestavení pomocí Static_Prerender_Runtime::build_plan() vypočítá plán, vykreslí pouze dotčené URL, zaznamená každý výsledek a hotovou sadu atomicky aktivuje pomocí Static_Prerender_Early_Serve::install_artifact_entry(). Pokud selže ověření kteréhokoli odkazovaného dokumentu, předchozí sada zůstane aktivní. Mapované trasy se poskytují z aktivovaného artefaktu, dokud jej nenahradí další sestavení, takže se obsah upravený ve wp-admin na těchto trasách projeví až při dalším nasazení. V tomto režimu je předehřívač pro jednotlivé URL vypnutý, protože artefakty se sestavují a aktivují jako celek. Typické produkční uspořádání vypadá takto:

JSON
{
  "performance": {
    "profile": "speed",
    "staticPrerender": {
      "enabled": true,
      "invalidate": "graph",
      "ttl": 2592000,
      "earlyServe": true,
      "serveLoggedIn": true,
      "dynamicPaths": [
        "/account",
        "/cart",
        "/checkout",
        "/login",
        "/reset-password"
      ]
    }
  }
}

30denní ttl pouze omezuje stáří zobrazovaného dokumentu. O aktuálnost se stará nasazení, které znovu sestaví graf. Sestavení API, dělení na části a interní přenos vykreslování popisuje referenční příručka ke statickému předvykreslování.

Umístění CDN před web

Předvykreslení už určuje, které odpovědi lze bezpečně sdílet: právě ty, které obsahují hlavičku HIT. Nechte zdrojový server převést ji na hlavičku mezipaměti a nechte CDN řídit se zdrojovým serverem. S nginx před PHP-FPM:

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;
    }
}

Regulární výraz odpovídá hodnotám HIT i HIT-EARLY. U všech ostatních odpovědí zůstává proměnná prázdná a nginx nepřidá hlavičku s prázdnou hodnotou, takže požadavky při nenalezení, dynamické cesty a vykreslení pro přihlášené uživatele nemají na zdrojovém serveru nastavenou dobu sdíleného uložení do mezipaměti.

Na straně CDN:

  • Ukládejte HTML do mezipaměti pouze tehdy, když zdrojový server odešle dobu uložení do mezipaměti. Pro odpovědi bez této hodnoty zakažte výchozí TTL na okraji sítě.
  • Obcházejte okrajovou mezipaměť pro stejné soubory cookie, které Blockstudio považuje za osobní (wordpress_logged_in_, wp-postpass_, comment_author_email_), a také pro vaše dynamicPaths, wp-admin a wp-json.
  • Po každém nasazení, které změní stránky, šablony nebo prostředky, vyprázdněte mezipaměť CDN. Mezipaměť zdrojového serveru se mění sama, ale okrajová mezipaměť o tom neví.

Pokud používáte Tailwind s "output": "link", stylesheet URL má hash obsahu, takže tuto cestu lze obsluhovat s dlouhodobou neměnnou hlavičkou mezipaměti.

Příkazy pro údržbu

Shell
wp bs prerender warm
wp bs prerender status
wp bs prerender purge
wp bs teardown

warm zařazuje zastaralé veřejné URL do fronty a při každém běhu vykreslí až warm.concurrency z nich; vypíše souhrn JSON. purge odstraní uložené dokumenty a frontu aktuálního webu. teardown odstraní události cron i stav předčasného poskytování, který tato instalace spravuje, a soubory konfigurace ponechá beze změny.

Zavádějte v tomto pořadí: nejprve profilování, potom předvykreslování s vypnutým earlyServe a nakonec předčasné poskytování, až budou status i hlavičky v pořádku. Každou vrstvu lze samostatně vrátit změnou její hodnoty na původní.

Další kroky