Preskoči na vsebino

Prikaz WordPress kot statičnega HTML

Večina strani na spletnem mestu za trženje ali dokumentacijo je enakih za vse neprijavljene obiskovalce. WordPress se kljub temu zažene, naloži vse vtičnike, izvede temo in ob vsaki zahtevi upodobi bloke. Vtičnik za predpomnjenje strani lahko pomaga, vendar prinaša dodatno komponento z lastnimi pravili o tem, kaj je varno shraniti.

Blockstudio ponuja izbirno statično predizrisovanje. Celotne dokumente HTML za neprijavljene obiskovalce shranjuje v lastnem imeniku predpomnilnika in jih, če to dovolite, prikazuje iz dodatka advanced-cache.php, še preden se zažene WordPress. Vse je nastavljeno v blockstudio.json.

V tem vodiču boste funkcijo vklopili po korakih, izvedeli, kako preveriti, kaj se predpomni, spoznali edino pravilo za zaščito prijavljenih obiskovalcev in na koncu nastavili CDN, ki predpomni samo vsebino, ki jo izvorni strežnik označi kot primerno za predpomnjenje.

Kako se obravnava zahteva

Ko je predizrisovanje omogočeno, se primerna zahteva zaključi na enega od treh načinov:

  1. Zgodnji zadetek. Dodatek v zemljevidu poti poišče shranjeni dokument in ga pošlje, še preden se naloži WordPress. Odgovor vsebuje X-Blockstudio-Static-Prerender: HIT-EARLY.
  2. Zadetek. WordPress se zažene, nato pa Blockstudio ob template_redirect poišče svež shranjeni dokument in ga pošlje namesto upodabljanja predloge. Odgovor vsebuje X-Blockstudio-Static-Prerender: HIT.
  3. Zgrešitev. WordPress običajno upodobi stran. Če obiskovalec ni prijavljen in je rezultat celoten dokument HTML s stanjem 200, ga Blockstudio shrani za naslednjo zahtevo.

Zahteve, ki niso primerne, se sploh ne dotaknejo predpomnilnika.

1. korak: Omogočite profil in predpomnilnik

Začnite s profilom zmogljivosti in predizrisovanjem, pri čemer naj bo zgodnje prikazovanje izklopljeno:

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

Kaj počne posamezni del:

  • profile: "speed" vklopi privzete nastavitve produkcijskega vmesnika: odstranijo se odvečni elementi v glavi, odkrivanje oEmbed, XML-RPC in generična osnovna sredstva vmesnika, povezave z istega izvora pa se vnaprej naložijo ob nameri. Najprej preverite odstranitev osnovnih sredstev, saj se napaka na strani, ki je od njih odvisna, jasno pokaže. Vsaka podrejena vrednost preglasi profil.
  • staticPrerender.enabled registrira izvajalno okolje. Ko je false, funkcija ne zapisuje datotek in ne registrira kavljev zahtev.
  • ttl je najdaljša starost shranjenega dokumenta v sekundah (privzeto 86400).
  • dynamicPaths vsebuje predpone poti, ki se morajo vedno upodobiti sproti.
  • warm načrtuje orodje za osveževanje v ozadju, ki vsakih interval sekund znova upodobi zastarele javne URL-je.

V vrstici $schema so zajeti vsi ključi, zato urejevalnik s podporo za shemo JSON označi napako, kot je "ttl": 0 (najmanjša vrednost je 1).

2. korak: Preverite, katere zahteve so primerne

Blockstudio je pri shranjevanju previden. Te zahteve vedno zaobidejo predpomnilnik:

  • vse zahteve, razen GET
  • vsak URL z nizom poizvedbe
  • wp-admin, wp-json, wp-login.php, xmlrpc.php, Ajax in cron
  • viri, iskanje in poti predogledov
  • zahteve z glavo X-WP-Nonce
  • poti znotraj dynamicPaths
  • obiskovalci s piškotkom wordpress_logged_in_*, wp-postpass_* ali comment_author_email_*, razen če je omogočen serveLoggedIn

Ujemanje dinamičnih poti upošteva meje poti. Pri zgornji nastavitvi:

Zahteva Zaobidena
/pricing/ ne
/account/orders/ da
/accounting/ ne
/checkout da
/pricing/?utm_source=x da
/blog/feed/ da

Pri shranjevanju se ohrani samo celoten dokument: odgovor se mora začeti z <!doctype html ali <html, imeti mora stanje 200 in ne sme vsebovati oznake za izključitev iz predpomnjenja. Predloga, ki je nikoli ne želite shraniti, lahko oznako izpiše kjer koli na strani:

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

Strani z napako se nikoli ne shranijo, zato prikaz s temo 404 ne more biti nikoli znova prikazan kot uspešen.

3. korak: Preverite zadetke

V zasebnem oknu obiščite nekaj strani, nato pa Blockstudio vprašajte, kaj vsebuje predpomnilnik:

Lupina
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 in bytes se večata z dodajanjem shranjenih dokumentov, queue prikazuje čakalno vrsto orodja za osveževanje, diagnostics pa vsebuje števce zadetkov, zgrešitev, gradenj in napak za posamezen obseg. Če želite preveriti posamezno stran, jo kot neprijavljen obiskovalec zahtevajte dvakrat in poiščite glavo:

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

Drugi odgovor vsebuje X-Blockstudio-Static-Prerender: HIT. Uporabite GET kot zgoraj: curl -I pošlje zahtevo HEAD, ki vedno zaobide predpomnilnik.

4. korak: Prikaz pred zagonom WordPress

Ko so zadetki videti pravilni, nastavite "earlyServe": true. Nato Blockstudio upravlja tri majhne dele stanja: dodatek wp-content/advanced-cache.php, skupni zemljevid poti wp-content/blockstudio-static-prerender-map.php in deklaracijo WP_CACHE v wp-config.php. Namestijo se ob naslednji skrbniški zahtevi.

Nekaj pravil zagotavlja varnost na gostovanju v skupni rabi in v večmestnih namestitvah:

  • Blockstudio nikoli ne prepiše dodatka, zemljevida ali vrstice WP_CACHE, ki niso v njegovi lasti. Če je advanced-cache.php že v lasti drugega vtičnika za predpomnjenje, je zgodnje pošiljanje izklopljeno.
  • Če je WP_CACHE že definiran kot true, ostane wp-config.php nespremenjen. Na gostiteljih, kjer wp-config.php ni zapisljiv, ga določite sami.
  • Pred pošiljanjem tako dodatek kot pot PHP preverita, ali slogovna datoteka Tailwind z zgoščeno vsebino, na katero se dokument sklicuje, še obstaja. Če je ni, se zahteva preusmeri na WordPress, namesto da bi bil dokument poslan brez slogov.
  • Vnosi v večmestni namestitvi si delijo en zemljevid, vendar so ločeni glede na gostitelja, domačo pot in ID mesta.
  • Glave odgovora, navedene v replayHeaders (privzeto Link), se shranijo z vsakim dokumentom in znova pošljejo ob vsakem zadetku, zato se glava Link, ki jo stran pošlje z header(), ohrani tudi pri zgodnjem pošiljanju. Piškotki in predpomnilniške glave se nikoli ne pošljejo znova.

Zgodnji zadetki vsebujejo X-Blockstudio-Static-Prerender: HIT-EARLY. Izklop earlyServe ali enabled odstrani stanje, ki ga upravlja Blockstudio, wp bs teardown pa ga izrecno odstrani pri namestitvah Composer, ki nimajo kljuke za deaktivacijo.

Prijavljeni obiskovalci in enaka označevalna koda

Privzeto prijavljeni obiskovalci vedno prejmejo sprotno izrisano stran. Nastavitev "serveLoggedIn": true jim omogoča tudi uporabo že shranjenega dokumenta, zato je spletno mesto za urednike in stranke enako hitro kot za anonimne obiskovalce.

Personalizirani odzivi nikoli ne ustvarijo vnosov v predpomnilniku: ob zgrešenem zadetku se prijavljenemu obiskovalcu stran izriše sproti in se ne shrani. To zlahka spregledamo. Ko je serveLoggedIn vklopljen, prijavljeni obiskovalec prejme anonimni dokument, če obstaja, personalizirana sprotno izrisana stran pa samo, če ga ni. Veja predloge, ki je odvisna od trenutnega uporabnika, se izvede le ob zgrešenem zadetku, zato se ista stran med obiski spreminja, personalizirana veja pa na predpomnjenih poteh praktično nikoli ne pride do izraza.

Iz tega sledi pravilo: na vsaki poti zunaj dynamicPaths mora biti označevalna koda za prijavljene uporabnike bajtno enaka anonimni. To pomeni, da v predlogah, ki se izrišejo na statičnih poteh, ne sme biti vej is_user_logged_in() ali 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; ?>

Težavo lahko odpravite na dva preprosta načina. Če je celotna stran osebna, na primer nadzorna plošča računa, premaknite pot v dynamicPaths. Druga možnost je, da stran ohranite statično, osebni del pa izrišete kot dinamični blok: shranjeni HTML vsebuje nadomestno vsebino, varno za predpomnjenje, pravi odlomek pa se pridobi v ločeni zahtevi obiskovalca:

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

Vodnik Personalizirani odlomki na predpomnjenih straneh opisuje izdelavo takšnega bloka.

Razveljavljanje podpisa ali grafa

invalidate določa, kdaj shranjeni dokumenti potečejo.

Vidik signature (privzeto) graph
Kdo napolni predpomnilnik anonimni zgrešeni zadetki in ogrevalnik vaš korak gradnje ter anonimni zgrešeni zadetki
Kaj povzroči potek vnosov TTL, shranjevanje objav, spremembe na ravni spletnega mesta nova gradnja, pri čemer je TTL zgornja meja
Ogrevalnik v ozadju na voljo izklopljen
Primerno za običajna spletna mesta spletna mesta z uvajalnim cevovodom

Način signature ne zahteva dodatnih orodij. Shranjevanje objave počisti ali znova ogreje domačo stran in stalno povezavo te objave, spremembe na ravni spletnega mesta, kot je zamenjava teme, pa zamenjajo identiteto predpomnilnika.

Način graph je namenjen determinističnim uvajanjem. Gradnja z Static_Prerender_Runtime::build_plan() izračuna načrt, izriše samo prizadete URL-je, zabeleži vsak rezultat in z Static_Prerender_Early_Serve::install_artifact_entry() atomsko aktivira dokončan nabor. Če preverjanje katerega koli navedenega dokumenta ne uspe, ostane aktiven prejšnji nabor. Preslikane poti se strežejo iz aktiviranega artefakta, dokler ga ne zamenja naslednja gradnja, zato vsebina, urejena v wp-admin, doseže te poti z naslednjo uvedbo. Ogrevalnik na ravni URL je v tem načinu izklopljen, ker se artefakti zgradijo in aktivirajo kot celota. Tipična produkcijska postavitev je videti takole:

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

30-dnevni ttl zgolj omejuje starost dokumenta, ki ga je mogoče servirati. Svežino zagotovi uvedba, ki znova zgradi graf. Gradnja API, razdeljevanje na segmente in notranji prenos izrisov so opisani v Referenci za statično predizrisovanje.

Postavitev CDN spredaj

Predizrisovanje že določi, katere odzive je varno deliti: natanko tiste, ki vsebujejo glavo HIT. Naj izvorni strežnik to pretvori v glavo predpomnilnika, CDN pa naj sledi izvornemu strežniku. Z nginxom 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;
    }
}

Regularni izraz ujame tako HIT kot HIT-EARLY. Pri vseh drugih odzivih je spremenljivka prazna, nginx pa ne doda glave s prazno vrednostjo. Zato zgrešeni zadetki, dinamične poti in izrisi za prijavljene uporabnike ostanejo brez skupnega trajanja predpomnjenja na izvornem strežniku.

Na strani CDN:

  • HTML predpomni samo, kadar izvorni strežnik pošlje trajanje predpomnjenja. Za odzive brez njega onemogoči privzeti TTL roba omrežja.
  • Obidi rob omrežja za iste piškotke, ki jih Blockstudio obravnava kot osebne (wordpress_logged_in_, wp-postpass_, comment_author_email_), ter za vaše dynamicPaths, wp-admin in wp-json.
  • Po vsaki uvedbi, ki spremeni strani, predloge ali sredstva, počisti CDN. Predpomnilnik izvornega strežnika se zamenja sam, rob omrežja pa ne ve, da bi se moral.

Če uporabljaš Tailwind z "output": "link", je slogovna datoteka URL zgoščena glede na vsebino, zato lahko to pot strežeš z dolgotrajno nespremenljivo glavo predpomnilnika.

Ukazi za vzdrževanje

Lupina
wp bs prerender warm
wp bs prerender status
wp bs prerender purge
wp bs teardown

warm doda zastarele javne URL-je v čakalno vrsto in pri vsakem zagonu izriše največ warm.concurrency teh strani ter izpiše povzetek JSON. purge odstrani shranjene dokumente in čakalno vrsto za trenutno spletno mesto. teardown odstrani dogodke cron in stanje za zgodnje serviranje, ki ju upravlja ta namestitev, konfiguracijske datoteke pa pusti nedotaknjene.

Uvajaj v tem vrstnem redu: najprej profil, nato predizrisovanje z izklopljenim earlyServe, zatem zgodnje serviranje, ko sta status in glave pravilno nastavljena. Vsako plast lahko razveljaviš samostojno tako, da vrednost nastaviš nazaj.

Naslednji koraki