Mezipaměť
Blockstudio zahrnuje trvalé mezipaměti založené na souborech. Ve výchozím nastavení jsou povolené prostřednictvím nastavení cache.enabled a zapisují se do:
wp-content/blockstudio/cache/
Tento jediný nakonfigurovaný kořenový adresář uchovává datové části sestavení běhového prostředí, předem sestavená registrační data bloků, prostředky editoru, Tailwind CSS, vykreslené dokumenty, fragmenty ostrovů, statické HTML, indexy grafů, fronty pro zahřátí a diagnostiku mezipaměti. Díky tomu se neopakuje vyhledávání, parsování, kompilace ani vykreslování a veškerý generovaný stav běhového prostředí zůstává v jediné hranici spravované hostitelem.
Výchozí umístění je záměrně mimo uploads, kde mohou hostitelé s přísnějším zabezpečením blokovat datové části mezipaměti PHP. Umístění změňte pomocí cache.path; relativní cesty se vztahují k WP_CONTENT_DIR, zatímco absolutní cesty umožňují používat vyhrazené svazky s oprávněním k zápisu:
{
"cache": {
"enabled": true,
"path": "cache/blockstudio"
}
}
Pro konfiguraci podle prostředí použijte filtr nastavení nebo filtr vyřešeného adresáře:
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';
});
Změna cesty znamená začátek se studenou mezipamětí. Staré soubory v wp-content/uploads/blockstudio/cache se už nečtou a lze je odstranit.
Identita a zneplatnění
Každý rozsah je vnořený pod identitu sítě/blogu a úplnou identitu běhového prostředí. Záznamy mezipaměti se mění při změně vstupů, včetně sledovaných souborů bloků, souborů polí, závislostí prostředků, nastavení, aktivního motivu, aktivních pluginů, inventářů logického vyhledávání, WordPress, PHP a verzí Blockstudio. Otisky závislostí jednotlivých položek oddělují sestavení pouze se změněnými položkami od nesouvisejících objektů.
Logické zdroje vyhledávání přispívají také svým ID zdroje, otiskem obsahu a vstupy pro sledování. Alternativní výběry běhového prostředí mohou přidat hodnotu blockstudio/cache/context, která odděluje všechny rozsahy mezipaměti.
Hostitelé, jejichž hranice tenanta se liší od ID sítě/blogu WordPress, mohou filtrovat blockstudio/cache/site_key; výsledek se před převedením na segment cesty normalizuje.
Při požadavku na frontend v zahřátém stavu Blockstudio načte registr běhového prostředí ještě před vytvořením zdrojů vyhledávání. Platný zásah do mezipaměti tak přeskočí rekurzivní vyhledávání zdrojů, sestavování bloků, parsování polí a opakované procházení stromů klíčů mezipaměti.
Obsah za běhu také ukládá vyřešené cesty k prostředkům bloků, jejich velikosti a časová razítka i seznamy stylů modulů. Při zahřívacích požadavcích se tato metadata znovu použijí, takže se pro každý vykreslený blok nemusí opakovat vyhledávání výstupů prostředků ani skenování adresářů modulů. Filtry prostředků URL a pro jejich vypnutí se přesto spustí pro aktuální požadavek a assets.inlineLimit zachovává rozpočet pro celou stránku i pořadí kaskády. Pokud jsou vypnuté assets.enqueue nebo trvalá mezipaměť, neshromažďují se žádná metadata výstupů prostředků. Neaktuální poslední úspěšné sestavení načte prostředky přímo z disku.
Nezměněná vyhodnocená nastavení také v rámci požadavku znovu používají svůj fingerprint. Opětovné načtení nebo změna nastavení jej zneplatní; měnitelné hodnoty objektů nebo referencí se znovu zahashují, místo aby se znovu použil potenciálně zastaralý fingerprint.
V prostředích production a staging se ověřenému snímku sledování důvěřuje 20 sekund; poté Blockstudio znovu zkontroluje soubory a adresáře. V prostředích local a development je výchozí hodnota nula, aby se změny zdrojů projevily okamžitě. Interval změňte pomocí:
add_filter('blockstudio/cache/watch_debounce', function () {
return 30;
});
Debounce může automatickou detekci změn zdrojů zpozdit nejvýše o
nastavený počet sekund. Povinné zkompilované assety, uložené neprázdné surové
assety a styly modulů se kontrolují při každém zásahu do cache. Smazání
kteréhokoli z nich okamžitě zneplatní runtime payload, místo aby se až do vypršení
časového okna poskytovala zastaralá metadata assetů. Debounce nastavte na 0, pokud se
prostředí podobné produkčnímu používá také k aktivní úpravě souborů.
Payloady cache se ukládají do souborů PHP. Malé payloady používají běžná pole, pokud má zapisující proces aktivní sdílenou paměť OPcache a cílové umístění není vyloučeno. OPcache pak může při dalších načteních znovu použít zkompilované pole; úpravy vrácených dat přitom nadále využívají obvyklé chování copy-on-write v PHP.
Bez sdílené paměti OPcache zůstávají datové části komprimovanými serializovanými daty. To platí také tehdy, když je OPcache plná, její API není k dispozici nebo je omezený, případně když soubor vylučuje její seznam blokovaných souborů nebo opcache.max_file_size. OPcache používající pouze souborovou mezipaměť nevybírá formát prostých polí. Informace o těchto nastaveních na úrovni hostitele najdete v konfiguraci PHP OPcache.
Výchozí formát běžných polí je omezen na 1 MiB, přičemž se měří serializovaná data i
vygenerovaný zdrojový kód PHP. Větší payloady zůstávají komprimované,
aby se předešlo nákladům na kompilaci velkých polí, když proces CLI bez OPcache načítá
cache naplněnou webovými workery.
I malé běžné soubory je při takovém čtení potřeba parsovat a nově zapsané soubory
může být nutné zkompilovat během opcache.file_update_protection.
Filtr blockstudio/cache/compress přepisuje formát pro každý rozsah, například když WP-CLI naplňuje soubory cache pro webové workery s povolenou OPcache. Vrácení hodnoty false také obchází limit velikosti: použijte jej pouze tehdy, když každý čtenář zvládne zpracovat vygenerovaný soubor PHP. Pokud není dostupná zlib, zůstávají záložním řešením běžná data PHP.
Současné požadavky a uchovávání
Klíče studené mezipaměti používají zámek typu single-flight. Jeden požadavek sestaví datovou část a souběžné požadavky čekají na atomicky zveřejněný výsledek, místo aby opakovaly stejné vyhledávání či kompilaci. Atomické zveřejnění zabraňuje vzniku neúplných objektů. Když aktualizace selže, platný poslední dobrý objekt zůstává dostupný, chyba je zaznamenána a další požadavek ji může napravit.
Rozsahy běhového prostředí ve výchozím nastavení uchovávají 20 zveřejněných datových částí. Limit lze upravit pro každý rozsah, pokud integrace záměrně vytváří více kontextů mezipaměti:
add_filter(
'blockstudio/cache/max_files_per_scope',
function (int $maximum, string $scope): int {
return 'runtime' === $scope ? 50 : $maximum;
},
10,
2
);
Uchovávání nikdy neodstraní soubor, na který odkazuje nainstalovaná mapa předčasného poskytování; filtr blockstudio/cache/protected_paths označuje další cesty, které se při pročišťování musí zachovat.
Nepoužívané jmenné prostory se shromažďují automaticky, místo aby se hromadily při každé aktivaci pluginu a aktualizaci PHP nebo WordPress. Úryvek konfigurace nasazení, který dříve prohledával starý adresář mezipaměti Tailwind pomocí globu, by měl místo toho volat Blockstudio\Runtime_Cache::purge('tailwind').
Jmenný prostor se vyřadí, když se změní identita běhového prostředí, například po aktualizaci jádra WordPress. Při prvním úklidu, který jej najde vyřazený, se do něj zapíše značka .retired a strom se odstraní až po uplynutí cache.namespaceGrace sekund (ve výchozím nastavení jednoho dne) od jejího zápisu. Pokud se do stromu mezitím znovu zapisuje, ochranná lhůta začíná znovu. Neodstraní se aktuální jmenný prostor rozsahu ani prostor, ze kterého mapa předčasného poskytování stále poskytuje aktivovaný artefakt; ochranná lhůta u druhého z nich začne po příští aktivaci, která přesune položku mapy jinam. Stránky uložené mimo WordPress nadále odkazují na šablony stylů s hashem obsahu, s nimiž byly vykresleny. Proto by web, který poskytuje stránky tailwind.output: "link" prostřednictvím CDN nebo dlouhé mezipaměti prohlížeče, měl nastavit ochrannou lhůtu tak, aby odpovídala nejdelší době, po kterou může taková kopie existovat:
{
"cache": {
"namespaceGrace": 777600
}
}
Pokud upgradovaná instalace obsahuje starý plochý adresář cache/runtime z doby před verzí 7.6, Blockstudio jej atomicky přejmenuje mimo aktivní cestu. Úloha WP-Cron pak v každém průchodu odstraní nejvýše 500 položek systému souborů. Tím se zabrání tomu, aby staré datové části a stromy .build.lock zabíraly disk, aniž by požadavek, který odhalí velký adresář, musel rekurzivně mazat jeho obsah. Úklid probíhá pouze při aktivním cache.enabled; velikost dávky lze změnit pomocí blockstudio/cache/legacy_cleanup_batch_size, pokud hostitel potřebuje menší nebo větší dávky.
Trvalé mezipaměti vypnete v blockstudio.json:
{
"cache": {
"enabled": false
}
}
Nebo pomocí filtru:
add_filter('blockstudio/settings/cache/enabled', '__return_false');
Mezipaměť vykreslování v paměti pro jednotlivé požadavky popsaná v části Výkon je záměrně oddělená, její trvalé artefakty však používají stejné umístění v systému souborů.
Vyprázdnění fronty starých zámků
Verze před 7.6.14 zanechávaly po každé změně obsahu jeden soubor .build.lock a vytížený web jich může mít stovky tisíc. Po upgradu je WP-Cron automaticky odstraňuje v omezených dávkách. Chcete-li frontu vyprázdnit hned a předat hostiteli číselný výsledek, spusťte CLI:
wp bs cache status
wp bs cache cleanup
status spočítá zbývající staré zámky a oznámí, kdy se spustí další dávka. cleanup spouští dávky, dokud nezůstanou žádné neaktivní zámky, a poté shromáždí jmenné prostory mezipaměti, jejichž ochranná lhůta uplynula. Zámky mladší než hodinu nebo zámky stále držené běžícím požadavkem se ponechají na další průchod. Během provozu webu nikdy nemažte soubory zámků ručně; držený zámek zajišťuje, že souběžné požadavky nesestavují data paralelně.
wp bs cache clear vyprázdní celou mezipaměť běhového prostředí aktuálního webu, případně jeden rozsah ve všech jmenných prostorech pomocí --scope=runtime. Další požadavek bude vše sestavovat od začátku, proto příkaz spusťte při nízkém provozu.
Mezipaměť Tailwind
Zkompilovaná mezipaměť CSS od Tailwind používá sdílený kořenový adresář běhového prostředí v jmenném prostoru síť/web/běhové prostředí a rozsahu tailwind. Ve výchozím nastavení uchovává až 1,000 položek po dobu 30 dnů, což stačí na zachování klíčů jednotlivých stránek celého webu, místo aby se odstranily po několika málo cestách.
Tailwind také opakovaně používá zahřátý kompilátor pro stejný vstup CSS v dlouho běžících procesech a uchovává stav jeho sestavení mezi procesy. Sady kandidátů studených stránek se stále kompilují samostatně, ale při každém spuštění už není nutné znovu sestavovat parser frameworku.
Pomocí těchto filtrů změňte uchovávání:
add_filter('blockstudio/tailwind/cache_max_files', function () {
return 1500;
});
add_filter('blockstudio/tailwind/cache_max_age', function () {
return 14 * DAY_IN_SECONDS;
});
Minimální stáří je jedna hodina.
Soubory mezipaměti mají hash obsahu a stránka v mezipaměti na každý odkazuje pomocí URL, takže informace o odstranění souboru a uložená stránka se mohou lišit v tom, které soubory jsou stále potřeba. Před vykreslením se u předem vykreslených dokumentů ověřuje odkazovaná šablona stylů, takže odstranění souboru vyžádá nové vykreslení, nikoli zobrazení stránky bez stylů. Zvýšením hodnoty cache_max_files nad počet různých klíčů jednotlivých stránek se novému vykreslení zcela vyhnete.
Statické předběžné vykreslování
Anonymní mezipaměť HTML umístěná pod stejným kořenovým adresářem.