Liigu sisu juurde

Vahemällu salvestamine

Blockstudio sisaldab püsivaid failipõhiseid vahemälusid. Need on vaikimisi sisse lülitatud sätte cache.enabled kaudu ja kirjutatakse asukohta:

Kood
wp-content/blockstudio/cache/

See üks seadistatud juurkataloog sisaldab käitusaja koosteväljundeid, eelehitatud plokkide registreerimisandmeid, redaktori varasid, Tailwind CSS, renderdatud dokumente, saarefragmente, staatilisi HTML, graafiindekseid, sooje järjekordi ja vahemälu diagnostikat. Nii välditakse avastamise, parsimise, kompileerimise ja renderdamise kordamist, hoides kogu genereeritud käitusoleku ühe hosti hallatava piiri sees.

Vaikimisi asub see sihilikult väljaspool uploads, kus tugevdatud turvalisusega hostid võivad blokeerida PHP vahemäluandmed. Muuda asukohta sättega cache.path; suhtelised teed lahendatakse kataloogist WP_CONTENT_DIR, absoluutsed teed võimaldavad kasutada spetsiaalseid kirjutatavaid vahemälu köiteid:

JSON
{
  "cache": {
    "enabled": true,
    "path": "cache/blockstudio"
  }
}

Keskkonnapõhise konfiguratsiooni jaoks kasuta kas sätte filtrit või lahendatud kataloogi filtrit:

PHP
add_filter('blockstudio/settings/cache/path', function () {
    return '/srv/wordpress-cache/blockstudio';
});

add_filter('blockstudio/cache/dir', function (string $directory): string {
    return WP_CONTENT_DIR . '/cache/blockstudio';
});

Tee muutmine alustab tühja vahemäluga. Vanu faile asukohas wp-content/uploads/blockstudio/cache enam ei loeta ja need võib eemaldada.

Identiteet ja kehtetuks muutmine

Iga ulatus on pesastatud võrgu/blogi identiteedi ja täieliku käitusidentiteedi alla. Vahemälukirjed muutuvad koos sisenditega, sealhulgas jälgitavate plokifailide, väljafailide, varasõltuvuste, sätete, aktiivse teema, aktiivsete pluginate, loogiliste avastusinventaride, WordPress, PHP ja Blockstudio versioonidega. Üksusepõhised sõltuvusräsi väärtused eraldavad ainult muutunud üksuste koosted sõltumatutest objektidest.

Loogilised avastusallikad lisavad samuti oma lähte-ID, sisu sõrmejälje ja jälgimissisendid. Alternatiivsed käitusvalikud võivad kõigile vahemälu ulatustele eraldamiseks lisada väärtuse blockstudio/cache/context. Hostid, mille rentniku piir erineb WordPress võrgu/blogi ID-dest, saavad filtreerida väärtust blockstudio/cache/site_key; tulemus puhastatakse enne teekonnaosaks muutmist.

Sooja esilehe päringu korral laadib Blockstudio käitusregistri enne avastusallikate loomist. Kehtiva vahemälutabamuse korral jäävad rekursiivne allikate avastamine, plokkide koostamine, väljade parsimine ja korduvad vahemäluklahvi puu läbimised vahele.

Käitusaegne andmekoorem salvestab ka lahendatud ploki varade rajad, suurused, ajatemplid ja moodulite laaditabelite loendid. Soojad päringud kasutavad seda metaandmestikku uuesti, selle asemel et teha iga renderdatud ploki jaoks varade väljundi otsinguid ja moodulite kataloogide skannimisi. Varade URL ja keelamise filtrid käivituvad endiselt jooksva päringu ajal ning assets.inlineLimit järgib leheülest eelarvet ja kaskaadijärjestust. Varade väljundi metaandmeid ei koguta, kui assets.enqueue või püsiv vahemällu salvestamine on keelatud. Aegunud viimase eduka järgu ehitis leiab oma varad uuesti kettalt.

Muutmata lahendatud seaded kasutavad päringu jooksul uuesti ka oma sõrmejälge. Ümberlaadimine või seadete muutmine muudab selle kehtetuks; muudetavate objektide või viidete väärtuste sõrmejäljed arvutatakse uuesti, selle asemel et kasutada võimalikku aegunud sõrmejälge.

production ja staging keskkondades usaldatakse valideeritud jälgimishetktõmmist 20 sekundit, enne kui Blockstudio kontrollib uuesti selle faile ja katalooge. Keskkondade local ja development vaikeväärtus on null, et lähtefailide muudatused oleksid kohe nähtavad. Muuda intervalli järgmiselt:

PHP
add_filter('blockstudio/cache/watch_debounce', function () {
    return 30;
});

Viivitus võib automaatset lähtekoodi muudatuste tuvastamist edasi lükata kõige rohkem seadistatud sekundite arvu võrra. Nõutud kompileeritud varasid, vahemällu salvestatud mittetühje toorvarasid ja moodulite stiililehti kontrollitakse siiski iga vahemälutabamuse korral. Kustutamine muudab käitusaja andmestiku kohe kehtetuks, selle asemel et aegumiseni aegunud varade metaandmeid väljastada. Määrake viivituseks 0, kui tootmisele sarnast keskkonda kasutatakse ka aktiivseks failide muutmiseks.

Vahemälu andmestikud on kaitstud PHP failid. Väikesed andmestikud kasutavad lihtsaid massiive, kui kirjutaval protsessil on aktiivne OPcache’i ühismälu ja sihtkoht pole välistatud. OPcache saab seejärel hilisematel kaasamistel kompileeritud massiivi uuesti kasutada; tagastatud andmete muutmisel kehtib endiselt PHP tavaline kopeerimise-kirjutamisel käitumine.

Kui ühismäluga OPcache puudub, jäävad andmestikud tihendatud serialiseeritud andmeteks. See kehtib ka siis, kui OPcache on täis, selle API pole saadaval või on piiratud või selle mustnimekiri või opcache.max_file_size välistab faili. Ainult failivahemälu kasutav OPcache ei vali lihtsa massiivi vormingut. Vaadake OPcache’i konfiguratsiooni PHP nende hosti taseme juhtelementide kohta.

Vaikimisi lihtsa massiivi vormingu ülempiir on 1 MiB, arvestades nii serialiseeritud andmeid kui ka genereeritud PHP lähtekoodi. Suuremad andmestikud jäävad tihendatuks, et vältida suurte massiivide kompileerimise kulu, kui CLI protsess, millel OPcache puudub, loeb veebitöötajate soojendatud vahemälu. Väikesed lihtfailid tuleb sellisel lugejal siiski parsida ning äsja kirjutatud failid võivad vajada kompileerimist opcache.file_update_protection ajal.

blockstudio/cache/compress filter tühistab vormingu skoobi kaupa, näiteks kui WP-CLI soojendab OPcache’iga veebitöötajate jaoks vahemälufaile. false tagastamine tühistab ka suurusepiirangu: tehke seda ainult siis, kui iga lugeja suudab genereeritud PHP faili käsitleda. Kui zlib pole saadaval, jäävad lihtsad PHP varuvariandiks.

Samaaegsus ja säilitamine

Külmade vahemäluklahvide puhul kasutatakse ühe töötlusega lukku. Üks päring koostab andmed, samal ajal kui samaaegsed päringud ootavad aatomiliselt avaldatud tulemust, selle asemel et korrata avastamist või kompileerimist. Aatomiline avaldamine väldib osalisi objekte. Värskenduse ebaõnnestumisel jääb kehtiv viimane hea objekt kättesaadavaks, tõrge on jälgitav ja järgmine päring saab taastuda.

Käitusulatustes säilitatakse vaikimisi 20 avaldatud andmekogumit. Muuda limiiti ulatuse kaupa, kui integratsioon loob sihilikult rohkem vahemälukontekste:

PHP
add_filter(
    'blockstudio/cache/max_files_per_scope',
    function (int $maximum, string $scope): int {
        return 'runtime' === $scope ? 50 : $maximum;
    },
    10,
    2
);

Säilitamine ei eemalda kunagi faili, millele paigaldatud varase teenindamise kaart viitab, ning filter blockstudio/cache/protected_paths märgib lisateed, mida puhastamine peab puutumata jätma.

Kasutamata nimeruumid kogutakse automaatselt, selle asemel et need kuhjuksid iga plugina aktiveerimise ning PHP või WordPress uuenduse järel. Juurutusjupike, mis kasutas vanas Tailwind vahemälukataloogis failide leidmiseks mustrit, peaks selle asemel kutsuma välja Blockstudio\Runtime_Cache::purge('tailwind').

Nimeruum aegub, kui käitusidentiteet muutub, näiteks pärast WordPress tuumiku uuendust. Esimene puhastuskäik, mis leiab selle aegununa, kirjutab sinna märgise .retired ning puu kogutakse kokku, kui sellest hetkest on möödunud cache.namespaceGrace sekundit (vaikimisi üks päev). Kui puusse vahepeal uuesti kirjutatakse, algab ajapikendus uuesti. Kokku ei koguta ulatuse praegust nimeruumi ega nimeruumi, millest varase teenindamise kaart endiselt aktiveeritud artefakti teenindab; viimase ajapikendus algab siis, kui järgmine aktiveerimine viib kaardikirje mujale. Väljaspool WordPress vahemällu salvestatud lehed viitavad endiselt sisu räsi põhjal nimetatud laaditabelitele, millega need renderdati, seega peaks sait, mis teenindab tailwind.output: "link" lehti CDN kaudu või pika brauserivahemäluga, määrama ajapikenduse pikimale ajale, mille jooksul selline koopia võib säilida:

JSON
{
  "cache": {
    "namespaceGrace": 777600
  }
}

Kui uuendatud paigaldus sisaldab versioonieelse 7.6 tasast kataloogi cache/runtime, nimetab Blockstudio selle aktiivsest teest aatomiliselt ümber. Seejärel eemaldab WP-Cron töö kuni 500 failisüsteemikirjet igas etapis. Nii vabastatakse kettaruum vanadest andmetest ja .build.lock puudest, ilma et suure kataloogi avastanud päring peaks seda rekursiivselt kustutama. Puhastus käivitub ainult siis, kui cache.enabled on aktiivne; muuda selle tööpartii suurust väärtusega blockstudio/cache/legacy_cleanup_batch_size, kui host vajab väiksemaid või suuremaid etappe.

Lülita püsivad vahemälud välja failis blockstudio.json:

JSON
{
  "cache": {
    "enabled": false
  }
}

Või filtri kaudu:

PHP
add_filter('blockstudio/settings/cache/enabled', '__return_false');

Jaotises Jõudlus kirjeldatud päringupõhine renderdusvahemälu on sihilikult eraldi, kuid selle püsivad artefaktid kasutavad sama failisüsteemi piiri.

Pärandlukkude järjekorra tühjendamine

Enne versiooni 7.6.14 jätsid väljalasked iga sisumuudatuse kohta maha ühe faili .build.lock ning hõivatud saidil võib neid olla sadu tuhandeid. Pärast uuendamist eemaldab WP-Cron need ise piiratud suurusega partiidena. Kui soovid järjekorra kohe tühjendada ja hostile selle kohta numbri anda, käivita CLI:

Shell
wp bs cache status
wp bs cache cleanup

status loendab järelejäänud pärandlukud ja teatab, millal järgmine partii käivitub. cleanup käivitab partiisid, kuni ühtegi kasutuseta lukku pole, seejärel kogub kokku vahemälunimeruumid, mille ajapikendus on möödunud. Alla tunni vanused lukud või töötava päringu käes olevad lukud jäetakse järgmise korra jaoks alles. Ära kustuta lukufaile käsitsi ajal, mil sait teenindab liiklust; hõivatud lukk on valimismehhanism, mis hoiab ära samaaegsete päringute paralleelse koostamise.

wp bs cache clear tühjendab praeguse saidi kogu käitusvahemälu või ühe ulatuse kõigis nimeruumides, kasutades väärtust --scope=runtime. Järgmine päring alustab tühja vahemäluga, seega käivita see väikese liikluse ajal.

Tailwind vahemälu

Tailwind kompileeritud CSS vahemälu kasutab jagatud käitusjuurt oma võrgu/saidi/käituskeskkonna nimeruumis ja tailwind ulatust. Vaikimisi säilitab see 30 päeva kuni 1,000 kirjet, millest piisab kogu saidi lehepõhiste võtmete hoidmiseks, selle asemel et need väheste marsruutide järel välja tõrjuda.

Tailwind kasutab pika elueaga protsessides sama CSS sisendi jaoks uuesti ka sooja kompilaatorit ning säilitab protsesside vahel kompilaatori loomise oleku. Külmade lehekandidaatide kogumid kompileeritakse endiselt eraldi, kuid raamistiku parserit ei pea iga kord uuesti looma.

Kasuta neid filtreid säilitamise muutmiseks:

PHP
add_filter('blockstudio/tailwind/cache_max_files', function () {
    return 1500;
});

add_filter('blockstudio/tailwind/cache_max_age', function () {
    return 14 * DAY_IN_SECONDS;
});

Minimaalne vanus on üks tund.

Vahemälufailid on sisu räsi põhjal nimetatud ja vahemällu salvestatud leht lingib neile ükshaaval URL, mistõttu kustutamine ja salvestatud leht võivad eri meelt olla selle suhtes, millised failid on endiselt vajalikud. Eelrenderdatud dokumente kontrollitakse enne esitamist nende lingitud laaditabeli suhtes, seega kustutatud fail põhjustab renderdamise kordamist, mitte stiilita lehte. Väärtuse cache_max_files suurendamine lehepõhiste eri võtmete arvust suuremaks väldib kordusrenderdamist täielikult.

Staatiline eelrenderdamine

Anonüümne vahemälu HTML, mis asub samas juurkataloogis.