Ukladanie do vyrovnávacej pamäte
Blockstudio zahŕňa trvalé vyrovnávacie pamäte založené na súboroch. Predvolene sú povolené nastavením cache.enabled a zapisujú sa do:
wp-content/blockstudio/cache/
Tento nakonfigurovaný koreňový adresár spravuje dátové súbory zostavenia prostredia, predpripravené údaje registrácie blokov, prostriedky editora, Tailwind CSS, vykreslené dokumenty, fragmenty ostrovčekov, statické HTML, indexy grafov, teplé fronty a diagnostiku vyrovnávacej pamäte. Predchádza sa tak opakovanému vyhľadávaniu, parsovaniu, kompilácii a vykresľovaniu, pričom všetok generovaný stav prostredia zostáva v jednom rozsahu spravovanom hostiteľom.
Predvolené umiestnenie je zámerne mimo uploads, kde môžu zabezpečené hostiteľské systémy blokovať dáta vyrovnávacej pamäte PHP. Umiestnenie zmeňte pomocou cache.path; relatívne cesty sa určujú od WP_CONTENT_DIR, zatiaľ čo absolútne cesty podporujú vyhradené zväzky zapisovateľnej vyrovnávacej pamäte:
{
"cache": {
"enabled": true,
"path": "cache/blockstudio"
}
}
Na konfiguráciu špecifickú pre prostredie použite filter nastavenia alebo filter vyriešeného adresára:
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';
});
Zmena cesty začína s prázdnou vyrovnávacou pamäťou. Staré súbory v wp-content/uploads/blockstudio/cache sa už nečítajú a možno ich odstrániť.
Identita a zneplatnenie
Každý rozsah je vnorený pod identitu siete/blogu a úplnú identitu prostredia. Položky vyrovnávacej pamäte sa menia pri zmene vstupov vrátane sledovaných súborov blokov, súborov polí, závislostí prostriedkov, nastavení, aktívnej témy, aktívnych pluginov, logických inventárov vyhľadávania, verzií WordPress, PHP a Blockstudio. Haše závislostí špecifické pre jednotlivé položky izolujú zostavenia, ktoré zahŕňajú len zmenené objekty, od nesúvisiacich objektov.
Logické zdroje vyhľadávania tiež prispievajú svojím ID zdroja, odtlačkom obsahu a vstupmi na sledovanie. Alternatívne výbery prostredia môžu pridať hodnotu blockstudio/cache/context na izolovanie všetkých rozsahov vyrovnávacej pamäte.
Hostitelia, ktorých hranica nájomcu sa líši od ID siete/blogu WordPress, môžu filtrovať blockstudio/cache/site_key; výsledok sa pred použitím ako segment cesty očistí.
Pri teplej požiadavke z frontendu Blockstudio načíta register prostredia ešte pred vytvorením zdrojov vyhľadávania. Platný zásah do vyrovnávacej pamäte preto preskočí rekurzívne vyhľadávanie zdrojov, vytváranie blokov, parsovanie polí a opakované prechádzanie stromov kľúčov vyrovnávacej pamäte.
Údaje prostredia pri spustení ukladajú aj vyriešené cesty k prostriedkom blokov, veľkosti, časové značky a zoznamy štýlov modulov. Požiadavky s pripravenou vyrovnávacou pamäťou opätovne používajú tieto metadáta namiesto opakovaného vyhľadávania výstupov prostriedkov a skenovania adresárov modulov pri každom vykreslenom bloku. Filtre pre prostriedky URL a vypnutie sa naďalej spúšťajú pre aktuálnu požiadavku a assets.inlineLimit zachováva rozpočet pre celú stránku aj poradie kaskády. Metadáta výstupov prostriedkov sa nezbierajú, keď je vypnuté assets.enqueue alebo trvalé ukladanie do vyrovnávacej pamäte. Zastaraná posledná funkčná zostava načíta svoje prostriedky z disku.
Nevykonané zmeny v nastaveniach opätovne používajú svoj odtlačok v rámci požiadavky. Opätovné načítanie alebo zmena nastavení ho zneplatní; hodnoty meniteľných objektov alebo referencií sa znova hašujú namiesto opätovného použitia potenciálne zastaraného odtlačku.
V prostrediach production a staging sa overený snímok sledovania považuje za platný 20 sekúnd, kým Blockstudio znova nezistí stav súborov a adresárov. V prostrediach local a development je predvolená hodnota nula, aby sa zmeny zdrojových súborov prejavili okamžite. Interval zmeňte takto:
add_filter('blockstudio/cache/watch_debounce', function () {
return 30;
});
Debounce môže oddialiť automatické zisťovanie zmien zdrojových súborov najviac o nakonfigurovaný počet sekúnd. Požadované skompilované súbory, súbory s uloženými neprázdnymi nespracovanými zdrojmi a štýly modulov sa kontrolujú pri každom zásahu do vyrovnávacej pamäte. Odstránenie súboru okamžite zneplatní obsah prostredia, namiesto toho, aby sa až do uplynutia intervalu poskytovali zastarané metadáta súboru. Nastavte debounce na 0, ak sa prostredie podobné produkčnému používa aj na aktívnu úpravu súborov.
Obsah vyrovnávacej pamäte sa ukladá do súborov chránených PHP. Malé dáta sa ukladajú ako bežné polia, ak má zapisujúci proces aktívnu zdieľanú pamäť OPcache a cieľ nie je vylúčený. OPcache potom môže pri neskorších načítaniach znovu použiť skompilované pole; úprava vrátených dát sa naďalej riadi bežným správaním kopírovania pri zápise v PHP.
Bez zdieľanej pamäte OPcache zostávajú dátové časti komprimovanými serializovanými údajmi. Platí to aj vtedy, keď je OPcache plná, jej API nie je dostupná alebo je obmedzená, prípadne jej zoznam vylúčených súborov alebo opcache.max_file_size vylučuje súbor. OPcache používajúca iba vyrovnávaciu pamäť súborov nevyberá formát obyčajného poľa. Informácie o týchto nastaveniach na úrovni hostiteľa nájdete v konfigurácii OPcachePHP.
Predvolený formát bežných polí má limit 1 MiB, pričom sa posudzuje veľkosť serializovaných dát aj vygenerovaného zdrojového súboru PHP. Väčšie dáta zostávajú komprimované, aby sa predišlo nákladom na kompiláciu veľkých polí, keď proces CLI bez OPcache číta vyrovnávaciu pamäť pripravenú webovými pracovníkmi.
Aj malé súbory s bežnými poliami musí takýto proces pri čítaní analyzovať a novozapísané súbory môže byť potrebné skompilovať počas opcache.file_update_protection.
Filter blockstudio/cache/compress prepíše formát pre každý rozsah, napríklad keď proces WP-CLI pripravuje súbory vyrovnávacej pamäte pre webových pracovníkov s povolenou OPcache. Vrátenie hodnoty false tiež obchádza limit veľkosti: použite ho iba vtedy, keď každý proces čítajúci súbor dokáže spracovať vygenerovaný súbor PHP. Ak zlib nie je dostupná, záložnou možnosťou zostáva bežné PHP.
Súbežnosť a uchovávanie
Kľúče studenej vyrovnávacej pamäte používajú zámok s jedným vykonaním. Jedna požiadavka zostaví dáta, zatiaľ čo ostatné počkajú na ich atomicky zverejnený výsledok, namiesto opakovania rovnakého vyhľadávania alebo kompilácie. Atomické zverejnenie zabraňuje vzniku neúplných objektov. Ak obnovenie zlyhá, platný posledný dobrý objekt zostane dostupný, zlyhanie možno zistiť a ďalšia požiadavka môže obnovu zopakovať.
Rozsahy prostredia predvolene uchovávajú 20 zverejnených dátových objektov. Ak integrácia zámerne vytvára viac kontextov vyrovnávacej pamäte, upravte limit pre každý rozsah:
add_filter(
'blockstudio/cache/max_files_per_scope',
function (int $maximum, string $scope): int {
return 'runtime' === $scope ? 50 : $maximum;
},
10,
2
);
Uchovávanie nikdy neodstráni súbor, na ktorý odkazuje nainštalovaná mapa skorého poskytovania, a filter blockstudio/cache/protected_paths označuje ďalšie cesty, ktoré sa pri čistení musia zachovať.
Nepoužívané menné priestory sa zhromažďujú automaticky, namiesto toho, aby sa hromadili pri každej aktivácii pluginu alebo aktualizácii PHP či WordPress. Úryvok nasadenia, ktorý predtým vyhľadával súbory cez glob v starom adresári vyrovnávacej pamäte Tailwind, by mal namiesto toho zavolať Blockstudio\Runtime_Cache::purge('tailwind').
Menný priestor sa vyradí, keď sa zmení identita prostredia, napríklad po aktualizácii jadra WordPress. Pri prvom čistení, ktoré zistí jeho vyradenie, sa doň zapíše značka .retired a celý strom sa odstráni po uplynutí cache.namespaceGrace sekúnd (predvolene jeden deň). Ak sa medzitým do stromu znova zapisuje, ochranná lehota začne plynúť odznova. Neodstraňuje sa aktuálny menný priestor rozsahu ani menný priestor, z ktorého mapa skorého poskytovania stále poskytuje aktivovaný artefakt; ochranná lehota druhého z nich začne plynúť po ďalšej aktivácii, keď sa jeho položka mapy presunie inde. Stránky uložené mimo WordPress naďalej odkazujú na šablóny so štýlmi s hašovaným obsahom, s ktorými boli vykreslené, takže web, ktorý poskytuje stránky tailwind.output: "link" cez CDN alebo s dlhým ukladaním do vyrovnávacej pamäte prehliadača, by mal nastaviť ochrannú lehotu aspoň na najdlhší čas, počas ktorého môže takáto kópia existovať:
{
"cache": {
"namespaceGrace": 777600
}
}
Ak aktualizovaná inštalácia obsahuje plochý adresár cache/runtime spred verzie 7.6, Blockstudio ho atomicky premenuje a odstráni z aktívnej cesty. Úloha WP-Cron potom pri každom prechode odstráni najviac 500 položiek súborového systému. Staré dáta a stromy .build.lock tak nezaberajú miesto na disku, pričom požiadavka, ktorá zistí veľký adresár, ho nemusí rekurzívne odstraňovať. Čistenie prebieha iba vtedy, keď je aktívne cache.enabled; ak hostiteľ potrebuje menšie alebo väčšie dávky, zmeňte ich veľkosť pomocou blockstudio/cache/legacy_cleanup_batch_size.
Zakážte trvalé vyrovnávacie pamäte v blockstudio.json:
{
"cache": {
"enabled": false
}
}
Alebo pomocou filtra:
add_filter('blockstudio/settings/cache/enabled', '__return_false');
Vyrovnávacia pamäť vykresľovania v pamäti pre jednotlivé požiadavky opísaná v časti Výkon je zámerne oddelená, no jej trvalé artefakty používajú tú istú hranicu súborového systému.
Vyprázdnenie frontu starých zámkov
Verzie pred 7.6.14 zanechávali jeden súbor .build.lock po každej zmene obsahu a na vyťaženom webe sa ich môžu nahromadiť státisíce. Po aktualizácii ich WP-Cron automaticky odstraňuje v obmedzených dávkach. Ak chcete front vyprázdniť okamžite a oznámiť hostiteľovi počet, spustite CLI:
wp bs cache status
wp bs cache cleanup
status spočíta zostávajúce staré zámky a oznámi, kedy sa spustí ďalšia dávka. cleanup spúšťa dávky, kým nezostanú žiadne nečinné zámky, a potom zhromaždí menné priestory vyrovnávacej pamäte, ktorým uplynula ochranná lehota. Zámky mladšie ako hodinu alebo tie, ktoré stále drží bežiaca požiadavka, sa ponechajú na ďalší prechod. Nikdy neodstraňujte súbory zámkov ručne, keď web obsluhuje návštevnosť; držaný zámok je mechanizmus výberu, ktorý bráni súbežnému zostavovaniu požiadaviek.
wp bs cache clear vymaže celú vyrovnávaciu pamäť prostredia pre aktuálny web alebo jeden rozsah vo všetkých menných priestoroch pomocou --scope=runtime. Ďalšia požiadavka začne zostavovať od začiatku, preto to spustite pri nízkej návštevnosti.
Vyrovnávacia pamäť Tailwind
Skompilovaná vyrovnávacia pamäť CSS nástroja Tailwind používa zdieľaný koreňový adresár prostredia v mennom priestore sieť/web/prostredie a rozsahu tailwind. Predvolene uchováva až 1,000 položiek po dobu 30 dní, čo stačí na uchovanie kľúčov na úrovni stránok celého webu namiesto ich odstránenia po niekoľkých trasách.
Tailwind opakovane používa aj zahriaty kompilátor pre rovnaký vstup CSS v dlhodobo bežiacich procesoch a uchováva stav zostavenia kompilátora medzi procesmi. Súbory kandidátov studených stránok sa stále kompilujú samostatne, no pri každej kompilácii už netreba znova zostavovať parser frameworku.
Pomocou týchto filtrov zmeňte uchovávanie:
add_filter('blockstudio/tailwind/cache_max_files', function () {
return 1500;
});
add_filter('blockstudio/tailwind/cache_max_age', function () {
return 14 * DAY_IN_SECONDS;
});
Minimálny vek je jedna hodina.
Súbory vyrovnávacej pamäte majú hašovaný obsah a stránka odkazuje na každý z nich pomocou URL, takže pri odstránení súboru a uloženej stránky sa môže líšiť, ktoré súbory sú ešte potrebné. Pred poskytnutím sa pri vopred vykreslených dokumentoch kontroluje, či ich prepojená šablóna so štýlmi existuje, takže odstránený súbor spôsobí jedno opätovné vykreslenie namiesto stránky bez štýlov. Ak sa hodnota cache_max_files zvýši nad počet rôznych kľúčov na úrovni stránok, opätovnému vykresleniu sa úplne predíde.
Statické predbežné vykresľovanie
Anonymná vyrovnávacia pamäť HTML uložená v tom istom koreňovom adresári.