Pāriet uz saturu

WordPress kā statiska HTML apkalpošana

Lielākā daļa mārketinga vai dokumentācijas vietnes lapu visiem anonīmajiem apmeklētājiem ir vienādas. WordPress joprojām tiek inicializēts, ielādē katru spraudni, palaiž tēmu un renderē blokus katram pieprasījumam. Lapu kešatmiņas spraudnis var palīdzēt, taču tas ir vēl viens komponents ar saviem noteikumiem par drošu datu glabāšanu.

Blockstudio piedāvā statisku iepriekšējo renderēšanu, kas jāiespējo atsevišķi. Tā savā kešatmiņas direktorijā saglabā pilnus anonīmus HTML dokumentus un, ja atļausiet, apkalpo tos no advanced-cache.php drop-in pirms WordPress inicializēšanas. Viss tiek konfigurēts failā blockstudio.json.

Šajā pamācībā soli pa solim tiek ieslēgta šī funkcija, parādīts, kā pārbaudīt, kas tiek un netiek saglabāts kešatmiņā, izskaidrots viens noteikums, kas aizsargā pieteikušos apmeklētājus, un beigās parādīts CDN iestatījums, kas saglabā kešatmiņā tikai to, ko izcelsmes serveris atzīmē kā kešojamu.

Kā tiek apkalpots pieprasījums

Ja iepriekšējā renderēšana ir iespējota, atbilstošs pieprasījums var beigties vienā no trim veidiem:

  1. Agrīns trāpījums. Drop-in atrod saglabāto dokumentu savā maršrutu kartē un nosūta to pa daļām pirms WordPress ielādes. Atbilde satur X-Blockstudio-Static-Prerender: HIT-EARLY.
  2. Trāpījums. Tiek inicializēts WordPress, un brīdī, kad tiek izpildīts template_redirect, Blockstudio atrod svaigu saglabātu dokumentu un nosūta to veidnes renderēšanas vietā. Atbilde satur X-Blockstudio-Static-Prerender: HIT.
  3. Neveiksmīgs trāpījums. WordPress renderē lapu parastajā veidā. Ja apmeklētājs ir anonīms un rezultāts ir pilns HTML dokuments ar statusu 200, Blockstudio saglabā to nākamajam pieprasījumam.

Pieprasījumi, kas neatbilst nosacījumiem, kešatmiņu neizmanto vispār.

1. darbība: iespējojiet profilu un kešatmiņu

Sāciet ar veiktspējas profilu un iepriekšējo renderēšanu, bet atstājiet agrīno apkalpošanu izslēgtu:

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

Katras daļas funkcija:

  • profile: "speed" ieslēdz ražošanas vides saskarnes noklusējuma iestatījumus: tiek noņemts liekais kods galvenē, oEmbed atklāšana, XML-RPC un vispārīgie pamata saskarnes resursi; pēc pieprasījuma tiek sākta vienas izcelsmes saišu iepriekšēja ielāde. Vispirms pārbaudiet pamata saskarnes resursu noņemšanas iestatījumu, jo lapa, kas no tiem ir atkarīga, acīmredzami nedarbosies. Profila vērtības var aizstāt ar pakārtotām vērtībām.
  • staticPrerender.enabled reģistrē izpildlaika vidi. Kamēr tā ir false, funkcija neraksta failus un nereģistrē pieprasījumu āķus.
  • ttl ir saglabāta dokumenta maksimālais vecums sekundēs (noklusējums: 86400).
  • dynamicPaths uzskaita ceļu prefiksus, kuriem vienmēr jārenderējas tiešsaistē.
  • warm ieplāno fona kešatmiņas atjaunotāju, kas ik pēc interval sekundēm no jauna renderē novecojušus publiskos URL.

Rindiņa $schema aptver katru atslēgu, tāpēc redaktors ar JSON shēmas atbalstu atzīmē kļūdu, piemēram, "ttl": 0 (minimālā vērtība ir 1).

2. darbība: noskaidrojiet, kuri pieprasījumi atbilst nosacījumiem

Blockstudio konservatīvi izvērtē, ko saglabāt. Šie pieprasījumi vienmēr apiet kešatmiņu:

  • viss, izņemot GET
  • jebkurš URL ar vaicājuma virkni
  • wp-admin, wp-json, wp-login.php, xmlrpc.php, Ajax un cron
  • plūsmu, meklēšanas un priekšskatījuma ceļi
  • pieprasījumi ar X-WP-Nonce galveni
  • ceļi mapē dynamicPaths
  • apmeklētāji ar sīkdatni wordpress_logged_in_*, wp-postpass_* vai comment_author_email_*, izņemot gadījumu, kad ir ieslēgts serveLoggedIn

Dinamiskie ceļi tiek salīdzināti pēc ceļa robežām. Ar iepriekš minēto konfigurāciju:

Pieprasījums Apiet kešatmiņu
/pricing/ nē
/account/orders/ jā
/accounting/ nē
/checkout jā
/pricing/?utm_source=x jā
/blog/feed/ jā

Saglabāšanas laikā tiek paturēts tikai pilns dokuments: atbildei jāsākas ar <!doctype html vai <html, tās statusam jābūt 200, un tajā nedrīkst būt atteikšanās marķiera. Veidne, kuru nekad nevajadzētu saglabāt, var izvadīt marķieri jebkurā lapas vietā:

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

Kļūdu lapas nekad netiek saglabātas, tāpēc tematizētu 404 nekad nevar atkārtoti parādīt kā veiksmīgu atbildi.

3. darbība: pārbaudiet trāpījumus

Apmeklējiet dažas lapas privātā logā un pēc tam noskaidrojiet, kas ir saglabāts Blockstudio:

Apvalks
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 un bytes palielinās, dokumentiem uzkrājoties; queue rāda atjaunotāja neapstrādāto darbu sarakstu, bet diagnostics ietver trāpījumu, neveiksmīgu trāpījumu, būvēšanas un kļūmju skaitītājus katram tvērumam. Lai pārbaudītu atsevišķu lapu, pieprasiet to divreiz kā anonīms apmeklētājs un meklējiet galveni:

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

Otrajā atbildē ir X-Blockstudio-Static-Prerender: HIT. Izmantojiet GET, kā norādīts iepriekš: curl -I nosūta HEAD pieprasījumu, kas vienmēr apiet kešatmiņu.

4. darbība: apkalpojiet saturu, pirms tiek inicializēts WordPress

Kad trāpījumi izskatās pareizi, iestatiet "earlyServe": true. Pēc tam Blockstudio pārvalda trīs nelielus stāvokļa elementus: drop-in wp-content/advanced-cache.php, koplietojamu wp-content/blockstudio-static-prerender-map.php maršrutu karti un WP_CACHE deklarāciju failā wp-config.php. Tie tiek instalēti nākamajā administrācijas pieprasījumā.

Daži noteikumi palīdz nodrošināt drošu darbību koplietotajā mitināšanā un vairāku vietņu vidē:

  • Blockstudio nekad nepārraksta ielāpu, karti vai WP_CACHE rindu, kas tam nepieder. Ja advanced-cache.php jau pieder citam kešatmiņas spraudnim, agrīnā apkalpošana paliek izslēgta.
  • Ja WP_CACHE jau ir definēts kā true, wp-config.php netiek mainīts. Resursdatoros, kuros wp-config.php nav rakstāms, definējiet to paši.
  • Pirms apkalpošanas gan ielāps, gan ceļš PHP pārbauda, vai joprojām pastāv dokumenta saitē norādītā satura jaucējkoda Tailwind stila lapa. Ja tās nav, pieprasījums tiek novirzīts uz WordPress, nevis apkalpots bez stiliem.
  • Multisite ierakstiem ir kopīga karte, taču tie tiek nodalīti pēc resursdatora, sākumceļa un vietnes ID.
  • Katrā dokumentā tiek saglabātas un katrā trāpījumā nosūtītas atkārtoti atbildes galvenes, kas norādītas replayHeaders — pēc noklusējuma Link. Tādējādi Link galvene, ko lapa sūta kopā ar header(), saglabājas arī agrīnās apkalpošanas laikā. Sīkdatņu un kešatmiņas galvenes nekad netiek nosūtītas atkārtoti.

Agrīnie trāpījumi ietver X-Blockstudio-Static-Prerender: HIT-EARLY. Izslēdzot earlyServe vai enabled, tiek noņemts stāvoklis, ko Blockstudio pārvalda, savukārt wp bs teardown to īpaši noņem instalācijās Composer, kurām nav deaktivizēšanas āķa.

Pieteikušies apmeklētāji un identisks marķējums

Pēc noklusējuma pieteikušies apmeklētāji vienmēr saņem aktuālu atveidojumu. Iestatot "serveLoggedIn": true, viņi var izmantot arī jau saglabātu dokumentu, tāpēc vietne ir tikpat ātra redaktoriem un klientiem kā anonīmiem apmeklētājiem.

Personalizētas atbildes nekad neveido kešatmiņas ierakstus: ja pieteicies apmeklētājs neatrod saglabātu dokumentu, lapa tiek atveidota aktuāli, bet rezultāts netiek saglabāts. Šo seku ir viegli nepamanīt. Ja serveLoggedIn ir ieslēgts, pieteicies apmeklētājs saņem anonīmo dokumentu, ja tāds ir, un personalizētu aktuālo atveidojumu tikai tad, ja tāda nav. Jebkurš veidnes atzars, kas atkarīgs no pašreizējā lietotāja, parādās tikai tad, ja dokumenta nav, tāpēc viena un tā pati lapa dažādos apmeklējumos mainās, un personalizētais atzars kešotajos maršrutos faktiski nekad netiek izmantots.

Tātad noteikums ir šāds: visos maršrutos ārpus dynamicPaths pieteikušos lietotāju marķējumam ir jābūt baitu pa baitam identiskam anonīmo lietotāju marķējumam. Tas nozīmē, ka veidnēs, kas tiek atveidotas statiskos maršrutos, nedrīkst būt is_user_logged_in() vai wp_get_current_user() atzaru:

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

Ir divi vienkārši risinājumi. Ja visa lapa ir personalizēta, piemēram, konta informācijas panelis, pārvietojiet maršrutu uz dynamicPaths. Vai arī atstājiet lapu statisku un atveidojiet personalizēto daļu kā dinamisku bloka salu, kas saglabātajā HTML nosūta kešatmiņai drošu vietturi un saņem īsto fragmentu paša apmeklētāja pieprasījumā:

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

Ceļvedī Personalizēti fragmenti kešotās lapās ir aprakstīts, kā izveidot šādu bloku.

Paraksta vai grafika invalidācija

invalidate nosaka, kā beidzas saglabāto dokumentu derīgums.

Aspekts signature (noklusējums) graph
Kas aizpilda kešatmiņu anonīmi pieprasījumi bez saglabāta dokumenta un kešatmiņas sildītājs jūsu būvēšanas solis un anonīmi pieprasījumi bez saglabāta dokumenta
Kas izbeidz ierakstu derīgumu TTL, ziņu saglabāšana, vietnes līmeņa izmaiņas jauna būvēšana; TTL ir maksimālais termiņš
Fona kešatmiņas sildītājs pieejams izslēgts
Piemērots parastām vietnēm vietnēm ar izvietošanas konveijeru

signature režīmam nav vajadzīgi papildu rīki. Saglabājot ziņu, sākumlapa un šīs ziņas pastāvīgā saite tiek iztīrīta no kešatmiņas vai tajā atkārtoti ielādēta, savukārt vietnes līmeņa izmaiņas, piemēram, tēmas maiņa, maina kešatmiņas identitāti.

graph režīms paredzēts deterministiskai izvietošanai. Būvēšana aprēķina plānu ar Static_Prerender_Runtime::build_plan(), atveido tikai skartos URL, reģistrē katru rezultātu un ar Static_Prerender_Early_Serve::install_artifact_entry() aktivizē pabeigto kopu atomiski. Ja kāda atsauktā dokumenta validācija neizdodas, iepriekšējā kopa paliek aktīva. Kartētie maršruti tiek apkalpoti no aktivizētā artefakta, līdz to aizstāj nākamā būvēšana, tāpēc wp-admin rediģētais saturs šajos maršrutos nonāk līdz ar nākamo izvietošanu. Šajā režīmā katra URL kešatmiņas sildītājs ir izslēgts, jo artefakti tiek būvēti un aktivizēti kā viena vienība. Tipiska produkcijas konfigurācija izskatās šādi:

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

30 dienu ttl tikai nosaka maksimālo vecumu apkalpotam dokumentam. Aktualitāti nodrošina izvietošana, kurā grafiks tiek būvēts no jauna. Būvēšanas API, sadalīšana daļās un iekšējais atveidošanas transports ir aprakstīti Statiskās priekšatveidošanas uzziņu ceļvedī.

Ievietojot priekšā CDN

Priekšatveidošana jau norāda, kuras atbildes ir droši kopīgot: tieši tās, kurām ir HIT galvene. Ļaujiet sākotnējam serverim to pārvērst par kešatmiņas galveni un ļaujiet CDN sekot sākotnējā servera norādēm. Ar nginx PHP-FPM priekšā:

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ārā izteiksme atbilst gan HIT, gan HIT-EARLY. Visām pārējām atbildēm mainīgais ir tukšs, un nginx nepievieno galveni ar tukšu vērtību, tāpēc pieprasījumi bez trāpījuma, dinamiskie ceļi un pieteikušos lietotāju atveidojumi neatstāj sākotnējā serverī kopīgotas kešatmiņas termiņu.

No CDN puses:

  • Kešojiet HTML tikai tad, ja sākotnējais serveris norāda kešatmiņas termiņu. Atspējojiet noklusējuma malas TTL atbildēm, kurām tāda nav.
  • Apejiet malas kešatmiņu tiem pašiem sīkfailiem, kurus Blockstudio uzskata par personalizējošiem (wordpress_logged_in_, wp-postpass_, comment_author_email_), kā arī jūsu dynamicPaths, wp-admin un wp-json.
  • Pēc katras izvietošanas, kurā mainās lapas, veidnes vai resursi, iztīriet CDN no kešatmiņas. Sākotnējā servera kešatmiņa mainās pati, bet mala par to neuzzina.

Ja izmantojat Tailwind kopā ar "output": "link", stila lapa URL satur satura jaucējvērtību, tāpēc šim ceļam var iestatīt ilgstošu nemaināmas kešatmiņas galveni.

Uzturēšanas komandas

Apvalks
wp bs prerender warm
wp bs prerender status
wp bs prerender purge
wp bs teardown

warm pievieno rindai novecojušus publiskos URL un katrā izpildē atveido līdz warm.concurrency no tiem, izvadot kopsavilkumu JSON. purge noņem pašreizējās vietnes saglabātos dokumentus un rindu. teardown noņem cron notikumus un šai instalācijai piederošo agrīnās apkalpošanas stāvokli, neaizskarot konfigurācijas failus.

Izvietojiet šādā secībā: vispirms profilēšanu, pēc tam priekšatveidošanu ar izslēgtu earlyServe un visbeidzot agrīno apkalpošanu, kad status un galvenes izskatās pareizi. Katru slāni var atsevišķi atcelt, atiestatot tā vērtību.

Nākamās darbības