Preskočiť na obsah

Poskytovanie WordPress ako statického HTML

Väčšina stránok na marketingových weboch alebo weboch s dokumentáciou vyzerá pre každého anonymného návštevníka rovnako. WordPress sa aj tak spúšťa, načíta každý doplnok, spustí tému a vykreslí bloky pri každej požiadavke. Pomôcť môže doplnok na ukladanie stránok do vyrovnávacej pamäte, no prináša ďalšiu pohyblivú časť s vlastnými pravidlami, čo je bezpečné ukladať.

Blockstudio ponúka voliteľné statické predbežné vykresľovanie. Ukladá kompletné anonymné dokumenty HTML do vlastného adresára vyrovnávacej pamäte a ak to povolíte, poskytuje ich z doplnkového súboru advanced-cache.php ešte pred spustením WordPress. Všetko sa nastavuje v blockstudio.json.

Táto príručka vás krok za krokom prevedie zapnutím funkcie, ukáže, ako overiť, čo sa ukladá do vyrovnávacej pamäte, vysvetlí jediné pravidlo na ochranu prihlásených návštevníkov a na záver predstaví nastavenie CDN, ktoré ukladá do vyrovnávacej pamäte len obsah označený pôvodným serverom ako vhodný na uloženie.

Ako sa obsluhuje požiadavka

Pri zapnutom predbežnom vykresľovaní sa vhodná požiadavka skončí jedným z troch spôsobov:

  1. Okamžitý zásah. Doplnkový súbor nájde uložený dokument v mape trás a odošle ho ešte pred načítaním WordPress. Odpoveď obsahuje X-Blockstudio-Static-Prerender: HIT-EARLY.
  2. Zásah. Spustí sa WordPress a vo fáze template_redirect Blockstudio nájde aktuálny uložený dokument a odošle ho namiesto vykreslenia šablóny. Odpoveď obsahuje X-Blockstudio-Static-Prerender: HIT.
  3. Neúspešné nájdenie. WordPress vykreslí stránku bežným spôsobom. Ak je návštevník anonymný a výsledkom je kompletný dokument HTML so stavom 200, Blockstudio ho uloží pre nasledujúcu požiadavku.

Požiadavky, ktoré nie sú vhodné, sa vyrovnávacej pamäte vôbec nedotknú.

Krok 1: Zapnutie profilu a vyrovnávacej pamäte

Najprv zapnite výkonnostný profil a predbežné vykresľovanie, pričom skoré poskytovanie nechajte 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
      }
    }
  }
}

Čo robí jednotlivá časť:

  • profile: "speed" zapne predvolené nastavenia produkčného frontendu: odstráni nadbytočný obsah hlavičky, zisťovanie oEmbed, XML-RPC a všeobecné základné prostriedky frontendu a pri zámere vopred načíta odkazy z tej istej domény. Najprv otestujte nastavenie na odstraňovanie základných prostriedkov frontendu, pretože stránka, ktorá na nich závisí, sa viditeľne pokazí. Hodnota ľubovoľného vnoreného nastavenia prepíše profil.
  • staticPrerender.enabled zaregistruje runtime. Kým je false, táto funkcia nezapisuje súbory ani neregistruje háčiky požiadaviek.
  • ttl je maximálny vek uloženého dokumentu v sekundách (predvolene 86400).
  • dynamicPaths uvádza prefixy ciest, ktoré sa musia vždy vykresľovať za behu.
  • warm naplánuje proces na pozadí, ktorý opätovne vykreslí neaktuálne verejné URL každých interval sekúnd.

Riadok $schema pokrýva všetky kľúče, takže editor s podporou schémy JSON označí chybu, ako je "ttl": 0 (minimum je 1).

Krok 2: Zistite, ktoré požiadavky sú vhodné

Blockstudio ukladá obsah obozretne. Tieto požiadavky vždy obídu vyrovnávaciu pamäť:

  • všetko okrem GET
  • ľubovoľné URL s reťazcom dotazu
  • wp-admin, wp-json, wp-login.php, xmlrpc.php, Ajax a cron
  • kanály, vyhľadávanie a náhľady stránok
  • požiadavky s hlavičkou X-WP-Nonce
  • cesty pod dynamicPaths
  • návštevníci s cookies wordpress_logged_in_*, wp-postpass_* alebo comment_author_email_*, ak nie je zapnuté serveLoggedIn

Dynamické cesty sa porovnávajú podľa hraníc ciest. Pri konfigurácii uvedenej vyššie:

Požiadavka Obíde vyrovnávaciu pamäť
/pricing/ nie
/account/orders/ áno
/accounting/ nie
/checkout áno
/pricing/?utm_source=x áno
/blog/feed/ áno

Pri ukladaní sa uchováva len kompletný dokument: odpoveď sa musí začínať <!doctype html alebo <html, musí mať stav 200 a nesmie obsahovať značku odmietnutia ukladania. Šablóna, ktorá sa nikdy nemá uložiť, môže túto značku vypísať kdekoľvek na stránke:

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

Chybové stránky sa nikdy neukladajú, takže tematicky upravená stránka 404 sa nikdy nemôže znova zobraziť ako úspešná.

Krok 3: Overenie zásahov

Navštívte niekoľko stránok v súkromnom okne a potom sa opýtajte Blockstudio, čo obsahuje:

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

Počet položiek v files a bytes rastie s ukladaním dokumentov, queue zobrazuje nevybavené úlohy procesu na pozadí a diagnostics obsahuje počítadlá zásahov, neúspešných nájdení, zostavení a zlyhaní pre jednotlivé oblasti. Ak chcete skontrolovať konkrétnu stránku, požiadajte o jej načítanie dvakrát ako anonymný návštevník a vyhľadajte hlavičku:

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

Druhá odpoveď obsahuje X-Blockstudio-Static-Prerender: HIT. Použite GET ako vyššie: curl -I odošle požiadavku HEAD, ktorá vždy obíde vyrovnávaciu pamäť.

Krok 4: Poskytovanie pred spustením WordPress

Keď zásahy vyzerajú správne, nastavte "earlyServe": true. Blockstudio potom spravuje tri malé časti stavu: doplnkový súbor wp-content/advanced-cache.php, zdieľanú mapu trás wp-content/blockstudio-static-prerender-map.php a deklaráciu WP_CACHE v wp-config.php. Nainštalujú sa pri nasledujúcej požiadavke administrácie.

Niekoľko pravidiel pomáha zaistiť bezpečnosť na zdieľanom hostingu a v prostredí s viacerými webmi:

  • Blockstudio nikdy neprepíše doplnok na skoré doručovanie, mapu ani riadok WP_CACHE, ktoré nevlastní. Ak advanced-cache.php už vlastní iný doplnok na ukladanie do cache, skoré doručovanie zostane vypnuté.
  • Ak je WP_CACHE už definované ako true, wp-config.php sa ponechá bez zmeny. Na hostiteľoch, kde sa do wp-config.php nedá zapisovať, ho definujte sami.
  • Pred doručením doplnok na skoré doručovanie aj cesta PHP skontrolujú, či stále existuje obsahovo hašovaný súbor štýlov Tailwind, na ktorý dokument odkazuje. Ak neexistuje, požiadavka sa presmeruje na WordPress namiesto doručenia stránky bez štýlov.
  • Položky multisite zdieľajú jednu mapu, no sú oddelené podľa hostiteľa, domovskej cesty a ID webu.
  • Hlavičky odpovede uvedené v replayHeaders, predvolene Link, sa ukladajú spolu s každým dokumentom a znova sa odosielajú pri každom načítaní z cache. Hlavička Link, ktorú stránka odosiela cez header(), tak pretrvá aj pri skorom doručovaní. Hlavičky súborov cookie a ukladania do cache sa nikdy znova neodosielajú.

Skoré požiadavky nesú X-Blockstudio-Static-Prerender: HIT-EARLY. Vypnutím earlyServe alebo enabled sa raz odstráni stav, ktorý vlastní Blockstudio, a wp bs teardown ho výslovne odstráni pri inštaláciách Composer, ktoré nemajú hák na deaktiváciu.

Prihlásení návštevníci a zhodné značky HTML

Prihlásení návštevníci štandardne vždy dostávajú živé vykreslenie. Nastavenie "serveLoggedIn": true im umožní použiť aj existujúci uložený dokument, takže web je pre redaktorov a zákazníkov rovnako rýchly ako pre anonymných návštevníkov.

Personalizované odpovede nikdy nevytvárajú položky vyrovnávacej pamäte: pri neprítomnosti uloženého dokumentu sa prihlásenému návštevníkovi stránka vykreslí naživo a neuloží sa. Ľahko sa pritom prehliadne dôsledok. Keď je zapnuté serveLoggedIn, prihlásený návštevník dostane anonymný dokument, ak existuje, a personalizované živé vykreslenie iba vtedy, keď neexistuje. Každá vetva šablóny závislá od aktuálneho používateľa sa prejaví len v prípade, keď dokument chýba, takže tá istá stránka sa medzi návštevami mení a personalizovaná vetva je na cachovaných trasách prakticky nefunkčná.

Z toho vyplýva pravidlo: na každej trase mimo dynamicPaths musia byť značky HTML pre prihlásených aj anonymných používateľov identické na úrovni bajtov. To znamená, že v šablónach vykresľovaných na statických trasách nesmú byť vetvy 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; ?>

Existujú dve jednoduché riešenia. Ak je celá stránka osobná, presuňte trasu do dynamicPaths, napríklad pri nástenke používateľského účtu. Alebo ponechajte stránku statickú a osobnú časť vykreslite ako dynamický ostrovček bloku, ktorý do uloženého HTML vloží zástupný obsah bezpečný pre vyrovnávaciu pamäť a skutočný úryvok načíta v rámci vlastnej požiadavky návštevníka:

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

Sprievodca Personalizované úryvky na cachovaných stránkach vytvorí tento blok.

Zneplatnenie podľa podpisu alebo grafu

invalidate určuje, ako uložené dokumenty expirujú.

Aspekt signature (predvolené) graph
Kto plní vyrovnávaciu pamäť anonymné požiadavky bez uloženého dokumentu a nástroj na prednačítanie váš krok zostavenia a anonymné požiadavky bez uloženého dokumentu
Čo spôsobuje expiráciu položiek TTL, uloženie príspevku, zmeny na úrovni webu nové zostavenie; hornú hranicu určuje TTL
Nástroj na prednačítanie na pozadí dostupný vypnutý
Vhodné pre bežné weby weby s procesom nasadzovania

Režim signature nevyžaduje žiadne nástroje. Uložením príspevku sa vymaže vyrovnávacia pamäť domovskej stránky a trvalého odkazu na príspevok alebo sa tieto stránky znova prednačítajú. Zmeny na úrovni webu, napríklad prepnutie témy, zmenia identitu vyrovnávacej pamäte.

Režim graph je určený na deterministické nasadzovanie. Zostavenie vypočíta plán pomocou Static_Prerender_Runtime::build_plan(), vykreslí iba dotknuté URL adresy, zaznamená každý výsledok a hotovú množinu aktivuje atomicky pomocou Static_Prerender_Early_Serve::install_artifact_entry(). Ak zlyhá kontrola platnosti ktoréhokoľvek odkazovaného dokumentu, predchádzajúca množina zostane aktívna. Mapované trasy sa obsluhujú z aktivovaného artefaktu až do jeho nahradenia pri ďalšom zostavení, takže obsah upravený v administrácii wp-admin sa na týchto trasách prejaví pri nasledujúcom nasadení. V tomto režime je prednačítanie pre každé URL vypnuté, pretože artefakty sa zostavujú a aktivujú ako jeden celok. Typické produkčné nastavenie vyzerá takto:

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

30-dňové ttl iba obmedzuje, ako starý môže byť zobrazovaný dokument. Aktuálnosť zabezpečuje nasadenie, ktoré znova zostaví graf. V sprievodcovi Odkaz na statické predvykreslenie nájdete informácie o zostavení, rozdelení grafu, internom prenose vykreslenia a API.

Umiestnenie CDN vpredu

Predvykreslenie už určuje, ktoré odpovede možno bezpečne zdieľať: práve tie, ktoré obsahujú hlavičku HIT. Nechajte pôvodný server previesť túto informáciu na hlavičku vyrovnávacej pamäte a nechajte CDN riadiť sa pôvodným serverom. Pri nginx pred 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árny výraz zodpovedá hodnotám HIT aj HIT-EARLY. Pri každej inej odpovedi je premenná prázdna a nginx nepridá hlavičku s prázdnou hodnotou. Požiadavky bez uloženého dokumentu, dynamické cesty a vykreslenia pre prihlásených používateľov preto na pôvodnom serveri nedostanú zdieľanú dobu uchovávania v pamäti.

Na strane CDN:

  • Cache HTML iba vtedy, keď pôvodný server odošle dobu uchovávania v pamäti. Pre odpovede bez nej vypnite predvolenú TTL na okrajovom serveri.
  • Obíďte okrajovú vyrovnávaciu pamäť pri rovnakých súboroch cookie, ktoré Blockstudio považuje za osobné (wordpress_logged_in_, wp-postpass_, comment_author_email_), a pri vašich dynamicPaths, wp-admin a wp-json.
  • Po každom nasadení, ktoré mení stránky, šablóny alebo prostriedky, vymažte CDN. Vyrovnávacia pamäť pôvodného servera sa obnoví sama, okrajová však nevie, že to má urobiť.

Ak používate Tailwind spolu s "output": "link", štýlový súbor URL má hash obsahu, takže túto cestu možno obsluhovať s dlhodobou nemennou hlavičkou vyrovnávacej pamäte.

Príkazy údržby

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

warm zaradí neaktuálne verejné URL adresy do frontu a pri každom spustení vykreslí najviac warm.concurrency z nich, pričom vypíše súhrn JSON. purge odstráni uložené dokumenty a front aktuálneho webu. teardown odstráni udalosti cron a stav skorého obslúženia, ktoré vlastní táto inštalácia, a ponechá konfiguračné súbory bez zmeny.

Postupujte v tomto poradí: najskôr profil, potom predvykreslenie s vypnutým earlyServe a napokon skoré obsluhovanie, keď budú status aj hlavičky vyzerať správne. Každú vrstvu možno samostatne vrátiť späť nastavením jej hodnoty na pôvodnú.

Ďalšie kroky