Pereiti prie turinio

WordPress kaip statinė HTML paslauga

Dauguma rinkodaros ar dokumentacijos svetainės puslapių visiems neprisijungusiems lankytojams yra vienodi. WordPress vis tiek paleidžiamas, įkelia kiekvieną įskiepį, vykdo temą ir atvaizduoja blokus kiekvienai užklausai. Puslapių talpyklos įskiepis gali padėti, bet tai dar vienas komponentas su savomis saugaus saugojimo taisyklėmis.

Blockstudio turi pasirenkamą statinį išankstinį generavimą. Jis išsaugo visus neprisijungusiems skirtus HTML dokumentus atskirame talpyklos kataloge ir, jei leidžiate, pateikia juos iš advanced-cache.php įskiepio dar prieš paleidžiant WordPress. Viskas konfigūruojama blockstudio.json.

Šiame vadove žingsnis po žingsnio įjungiama ši funkcija, parodoma, kaip patikrinti, kas saugoma talpykloje, paaiškinama vienintelė taisyklė, apsauganti prisijungusius lankytojus, o pabaigoje pateikiama CDN sąranka, kuri talpykloje saugo tik tai, ką šaltinis pažymi kaip tinkamą saugoti.

Kaip pateikiama užklausa

Įjungus išankstinį generavimą, tinkama užklausa baigiasi vienu iš trijų būdų:

  1. Ankstyvasis talpyklos pataikymas. Įskiepis randa išsaugotą dokumentą maršrutų žemėlapyje ir perduoda jį dar prieš įkeliant WordPress. Atsakyme yra X-Blockstudio-Static-Prerender: HIT-EARLY.
  2. Talpyklos pataikymas. WordPress paleidžiamas, o ties template_redirect Blockstudio randa naują išsaugotą dokumentą ir jį pateikia, užuot atvaizdavęs šabloną. Atsakyme yra X-Blockstudio-Static-Prerender: HIT.
  3. Talpyklos praleidimas. WordPress puslapį atvaizduoja įprastai. Jei lankytojas neprisijungęs, rezultatas yra visas HTML dokumentas, o būsena – 200, Blockstudio išsaugo jį kitai užklausai.

Netinkamos užklausos talpyklos apskritai nepasiekia.

1 žingsnis: įjunkite profilį ir talpyklą

Pradėkite nuo našumo profilio ir išankstinio generavimo, išjungę ankstyvąjį pateikimą:

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

Ką daro kiekviena dalis:

  • profile: "speed" įjungia produkcinės aplinkos priekinės dalies numatytąsias nuostatas: pašalinami antraštės pertekliniai duomenys, oEmbed aptikimas, XML-RPC ir bendrieji pagrindinės sistemos priekinės dalies ištekliai, o tos pačios kilmės nuorodos iš anksto įkeliamos esant naudotojo ketinimui. Pirmiausia patikrinkite pagrindinės sistemos priekinės dalies išteklių šalinimo nustatymą, nes nuo jų priklausantis puslapis gali akivaizdžiai sugesti. Antrinio lygio reikšmės perrašo profilį.
  • staticPrerender.enabled užregistruoja vykdymo aplinką. Kai funkcija false, ji nekuria failų ir neregistruoja užklausų kablių.
  • ttl yra maksimalus saugomo dokumento amžius sekundėmis (numatytoji reikšmė 86400).
  • dynamicPaths nurodo kelių prefiksus, kuriuos visada reikia atvaizduoti dinamiškai.
  • warm suplanuoja foninį talpyklos užpildymo procesą, kuris kas interval sekundžių iš naujo atvaizduoja nebeaktualius viešus URL.

Eilutė $schema apima visus raktus, todėl redaktorius su JSON schemų palaikymu aptinka klaidą, pvz., "ttl": 0 (mažiausia reikšmė yra 1).

2 žingsnis: sužinokite, kas tinkama talpyklai

Blockstudio atsargiai renkasi, ką saugoti. Šios užklausos visada apeina talpyklą:

  • visos užklausos, išskyrus GET
  • bet kuris URL su užklausos eilute
  • wp-admin, wp-json, wp-login.php, xmlrpc.php, Ajax ir cron
  • sklaidos kanalų, paieškos ir peržiūros keliai
  • užklausos su X-WP-Nonce antrašte
  • keliai po dynamicPaths
  • lankytojai, turintys wordpress_logged_in_*, wp-postpass_* arba comment_author_email_* slapuką, nebent įjungta serveLoggedIn

Dinaminiai keliai nustatomi pagal kelio ribas. Esant pirmiau nurodytai konfigūracijai:

Užklausa Apeinama talpykla
/pricing/ ne
/account/orders/ taip
/accounting/ ne
/checkout taip
/pricing/?utm_source=x taip
/blog/feed/ taip

Saugoma tik visas dokumentas: atsakymas turi prasidėti <!doctype html arba <html, jo būsena turi būti 200, jame neturi būti atsisakymo žymeklio. Šablonas, kurio niekada negalima saugoti, gali bet kurioje puslapio vietoje išvesti žymeklį:

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

Klaidų puslapiai niekada nesaugomi, todėl stilizuotas 404 niekada negali būti pateiktas kaip sėkmingas atsakymas.

3 žingsnis: patikrinkite pataikymus

Apsilankykite keliuose puslapiuose privačiame lange, tada paprašykite Blockstudio parodyti, kas saugoma:

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

files ir bytes didėja saugant dokumentus, queue rodo laukiančius talpyklos užpildymo darbus, o diagnostics pateikia atskirus skaitiklius pagal sritį: pataikymų, praleidimų, kūrimų ir nesėkmių. Norėdami patikrinti vieną puslapį, pateikite jo užklausą du kartus kaip neprisijungęs lankytojas ir ieškokite antraštės:

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

Antrajame atsakyme yra X-Blockstudio-Static-Prerender: HIT. Naudokite GET, kaip nurodyta pirmiau: curl -I siunčia HEAD užklausą, kuri visada apeina talpyklą.

4 žingsnis: pateikite anksčiau, nei paleidžiamas WordPress

Kai pataikymai atrodo teisingi, nustatykite "earlyServe": true. Tada Blockstudio valdo tris nedidelius būsenos elementus: wp-content/advanced-cache.php įskiepį, bendrą wp-content/blockstudio-static-prerender-map.php maršrutų žemėlapį ir WP_CACHE deklaraciją faile wp-config.php. Jie įdiegiami kitos administravimo užklausos metu.

Kelios taisyklės užtikrina saugų veikimą bendrojo prieglobos plano aplinkoje ir kelių svetainių tinkle:

  • Blockstudio niekada neperrašo papildinio, susiejimo žemėlapio ar WP_CACHE eilutės, kurios nevaldo. Jei advanced-cache.php jau priklauso kitam podėlio įskiepiui, ankstyvasis pateikimas lieka išjungtas.
  • Jei WP_CACHE jau apibrėžtas kaip true, wp-config.php paliekamas nepakeistas. Jei priegloboje wp-config.php neįrašomas, apibrėžkite jį patys.
  • Prieš pateikdami turinį, ir papildinys, ir kelias PHP patikrina, ar vis dar yra dokumento susiejamo turinio maiša pažymėtas Tailwind stilių failas. Jei jo nėra, užklausa perduodama WordPress, kad puslapis nebūtų pateiktas be stilių.
  • Multisite įrašai naudoja vieną susiejimo žemėlapį, bet yra atskirti pagal prieglobos vardą, pagrindinį kelią ir svetainės ID.
  • Kiekvienas dokumentas išsaugomas su atsakymo antraštėmis, nurodytomis replayHeaders; numatytoji reikšmė yra Link. Jos vėl siunčiamos kiekvieno apsilankymo metu, todėl header() siunčiama Link antraštė išlieka ir ankstyvojo pateikimo metu. Slapukų ir podėlio antraštės niekada nepersiunčiamos.

Ankstyvosios užklausos turi X-Blockstudio-Static-Prerender: HIT-EARLY. Išjungus earlyServe arba enabled, vieną kartą pašalinama Blockstudio valdoma būsena, o wp bs teardown ją pašalina aiškiai tuose Composer įdiegimuose, kuriuose nėra išjungimo kablio.

Prisijungę lankytojai ir identiškas žymėjimas

Pagal numatytuosius nustatymus prisijungę lankytojai visada gauna tiesiogiai sugeneruotą turinį. Nustačius "serveLoggedIn": true, jie taip pat gali naudoti jau išsaugotą dokumentą, todėl redaktoriams ir klientams svetainė veikia taip pat greitai kaip anoniminiams lankytojams.

Suasmeninti atsakymai niekada nesukuria podėlio įrašų: jei prisijungusio lankytojo turinio nėra, jis sugeneruojamas tiesiogiai ir neišsaugomas. Šią pasekmę lengva pražiūrėti. Kai įjungta serveLoggedIn, prisijungęs lankytojas gauna anoniminį dokumentą, jei toks yra, o suasmenintą tiesiogiai sugeneruotą turinį – tik jei jo nėra. Bet kuri šablono šaka, priklausanti nuo dabartinio naudotojo, suveikia tik tada, kai turinio nėra, todėl tas pats puslapis skirtingų apsilankymų metu keičiasi, o suasmeninta šaka podėlyje laikomuose maršrutuose faktiškai niekada nesuveikia.

Iš to kyla ši taisyklė: kiekviename maršrute už dynamicPaths ribų prisijungusiems ir anoniminiams lankytojams skirtas žymėjimas turi būti identiškas baitas į baitą. Tai reiškia, kad šablonuose, kurie pateikiami statiniuose maršrutuose, negali būti is_user_logged_in() ar wp_get_current_user() šakų:

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

Yra du paprasti sprendimai. Jei visas puslapis suasmenintas, perkelkite maršrutą į dynamicPaths, pavyzdžiui, paskyros skydelį. Arba palikite puslapį statinį ir asmeninę dalį pateikite kaip dinaminį bloko elementą: išsaugotame HTML jis pateikia podėliui saugią rezervuotąją vietą, o tikrąją iškarpą gauna atskiroje lankytojo užklausoje:

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

Vadove Suasmenintos iškarpos podėlyje laikomuose puslapiuose aprašoma, kaip sukurti tokį bloką.

Parašo arba grafiko invalidavimas

invalidate nustato, kaip baigiasi išsaugotų dokumentų galiojimas.

Savybė signature (numatytasis) graph
Kas užpildo podėlį anoniminės užklausos be įrašų ir podėlio apšildymo procesas jūsų kūrimo procesas ir anoniminės užklausos be įrašų
Dėl ko baigiasi įrašų galiojimas TTL, įrašų išsaugojimas, svetainės lygmens pakeitimai naujas kūrimas, o TTL yra viršutinė riba
Foninis podėlio apšildymas galimas išjungtas
Tinka įprastoms svetainėms svetainėms su diegimo procesu

signature režimui nereikia jokių įrankių. Išsaugojus įrašą, pradinis puslapis ir to įrašo nuolatinė nuoroda pašalinami iš podėlio arba jame atnaujinami, o pakeitus svetainės lygmens nustatymus, pavyzdžiui, temą, pasikeičia podėlio tapatybė.

graph režimas skirtas deterministiniams diegimams. Kūrimo procesas apskaičiuoja planą naudodamas Static_Prerender_Runtime::build_plan(), pateikia tik paveiktus URL adresus, įrašo kiekvieną rezultatą ir aktyvuoja visą užbaigtą rinkinį vienu veiksmu su Static_Prerender_Early_Serve::install_artifact_entry(). Jei nepavyksta patikrinti kurio nors nurodyto dokumento, ankstesnis rinkinys lieka aktyvus. Susieti maršrutai pateikiami iš aktyvuoto artefakto, kol kitas kūrimas jį pakeičia, todėl turinys, redaguotas per wp-admin, tuos maršrutus pasiekia su kitu diegimu. Šiuo režimu vienam URL skirtas podėlio apšildymas išjungtas, nes artefaktai kuriami ir aktyvuojami kaip vienas vienetas. Įprasta gamybinės aplinkos konfigūracija atrodo taip:

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

30 dienų ttl tik apriboja, kiek senas gali būti pateikiamas dokumentas. Naujausias turinys gaunamas diegimo metu atkūrus grafą. Kūrimo API, skaidymas į dalis ir vidinis pateikimo transportas aprašyti Statinio išankstinio pateikimo nuorodoje.

Priekyje pridėkite CDN

Išankstinio pateikimo procesas jau nurodo, kuriais atsakymais saugu dalytis: būtent tais, kurie turi HIT antraštę. Leiskite serveriui ją paversti podėlio antrašte, o CDN sekite serverio nurodymais. Kai priešais PHP-FPM naudojamas nginx:

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

Reguliarioji išraiška atitinka ir HIT, ir HIT-EARLY. Visų kitų atsakymų atveju kintamasis tuščias, o nginx neprideda antraštės su tuščia reikšme, todėl užklausos be podėlio įrašo, dinaminiai keliai ir prisijungusių naudotojų turinys negauna bendro podėlio galiojimo trukmės iš serverio.

CDN pusėje:

  • Podėlyje laikykite HTML tik tada, kai serveris nurodo podėlio galiojimo trukmę. Išjunkite numatytąjį briaunos TTL atsakymams, kuriems tokia trukmė nenurodyta.
  • Apeikite briauną tiems patiems slapukams, kuriuos Blockstudio laiko suasmeninimo požymiu (wordpress_logged_in_, wp-postpass_, comment_author_email_), taip pat jūsų dynamicPaths, wp-admin ir wp-json.
  • Po kiekvieno diegimo, pakeičiančio puslapius, šablonus ar išteklius, išvalykite CDN. Pradinio serverio podėlis atsinaujina pats, o briauna apie tai nežino.

Jei naudojate Tailwind su "output": "link", stiliaus failas URL identifikuojamas pagal turinį, todėl šiam keliui galima nustatyti ilgalaikę nekintamo podėlio antraštę.

Priežiūros komandos

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

warm į eilę įtraukia pasenusius viešuosius URL adresus ir per vykdymą pateikia iki warm.concurrency jų, išspausdindama JSON suvestinę. purge pašalina dabartinės svetainės išsaugotus dokumentus ir eilę. teardown pašalina cron įvykius ir šio diegimo valdomą ankstyvo pateikimo būseną, o konfigūracijos failų neliečia.

Diekite šia tvarka: pirmiausia profilį, tada išankstinį pateikimą su išjungtu earlyServe, o galiausiai ankstyvą pateikimą, kai status ir antraštės atrodo tinkamai. Kiekvieną sluoksnį galima atskirai grąžinti į ankstesnę būseną, atkūrus ankstesnę jo reikšmę.

Tolesni veiksmai