Cachning
Blockstudio innehåller beständiga filbaserade cachar. De är aktiverade som standard via inställningen cache.enabled och skrivs till:
wp-content/blockstudio/cache/
Den här konfigurerade roten innehåller körningens byggdata, förbyggda blockregistreringsdata, redigerarresurser, Tailwind CSS, renderade dokument, öfragment, statiska HTML, grafindex, varma köer och cachediagnostik. Det undviker att sökning, parsning, kompilering och rendering behöver upprepas, samtidigt som allt genererat körningstillstånd hålls inom en gräns som värden kan hantera.
Standardplatsen ligger avsiktligt utanför uploads, där låsta värdmiljöer kan blockera PHP-cachedata. Ändra platsen med cache.path; relativa sökvägar utgår från WP_CONTENT_DIR, medan absoluta sökvägar stöder särskilda skrivbara cachevolymer:
{
"cache": {
"enabled": true,
"path": "cache/blockstudio"
}
}
För miljöspecifik konfiguration använder du antingen inställningsfiltret eller filtret för den lösta katalogen:
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';
});
En ändring av sökvägen börjar med en kall cache. Gamla filer under wp-content/uploads/blockstudio/cache läses inte längre och kan tas bort.
Identitet och ogiltigförklaring
Varje omfattning ligger under en nätverks-/bloggidentitet och en fullständig körningsidentitet. Cacheposter ändras när deras indata ändras, bland annat bevakade blockfiler, fältfiler, resursberoenden, inställningar, det aktiva temat, aktiva tillägg, logiska sökinventeringar, WordPress, PHP och Blockstudio-versioner. Hashar för objektspecifika beroenden isolerar byggen med enbart ändringar från orelaterade objekt.
Logiska sökkällor bidrar också med sitt käll-ID, innehållsfingeravtryck och bevakningsindata. Alternativa körningsval kan lägga till ett värde för blockstudio/cache/context för att isolera alla cacheomfattningar. Värdar där klientgränsen skiljer sig från nätverks-/blogg-ID:n i WordPress kan filtrera blockstudio/cache/site_key; resultatet saneras innan det blir ett sökvägssegment.
Vid en varm förfrågan till frontend fyller Blockstudio körningsregistret innan sökkällor skapas. En giltig cacheträff hoppar därför över rekursiv källsökning, blockkonstruktion, fältparsning och upprepade genomgångar av cache-nyckelträdet.
Körningsnyttolasten lagrar också lösta sökvägar till blockresurser, storlekar, tidsstämplar och listor över modulformatmallar. Varma förfrågningar återanvänder dessa metadata i stället för att upprepa sökningar efter resurser i utdata och genomsökningar av modulens katalog för varje renderat block. Resursers URL och inaktiveringsfilter körs fortfarande för den aktuella förfrågan, och assets.inlineLimit behåller sin sidövergripande budget och kaskadordning. Inga metadata om resursutdata samlas in när assets.enqueue eller beständig cachelagring är inaktiverad. En inaktuell senast fungerande version går tillbaka till att lösa resurserna från disk.
Oförändrade inställningar som har lösts återanvänder också sitt fingeravtryck under begäran. När inställningarna läses in igen eller ändras blir det ogiltigt; föränderliga objekt- eller referensvärden hashberäknas på nytt i stället för att ett potentiellt inaktuellt fingeravtryck återanvänds.
I production och staging används en validerad ögonblicksbild av bevakningen i 20 sekunder innan Blockstudio hämtar statistik för filerna och katalogerna igen. Miljöerna local och development har noll som standard, så källändringar syns omedelbart. Ändra intervallet med:
add_filter('blockstudio/cache/watch_debounce', function () {
return 30;
});
Debounce-funktionen kan fördröja automatisk identifiering av källändringar med högst det konfigurerade antalet sekunder. Nödvändiga kompilerade resurser, cachade icke-tomma råresurser och modulformatmallar kontrolleras fortfarande vid varje cacheträff. Om en fil tas bort ogiltigförklaras körningsnyttolasten omedelbart i stället för att inaktuella resursmetadata visas tills tidsfönstret löper ut. Ställ in debounce-värdet på 0 när en produktionslik miljö också används för aktiv filredigering.
Cache-nyttolaster skyddas av PHP-filer. Små nyttolaster använder vanliga arrayer när skrivprocessen har aktivt delat OPcache-minne och målet inte är undantaget. OPcache kan då återanvända den kompilerade arrayen vid senare inläsningar; om den returnerade datan ändras används fortfarande PHP vanliga copy-on-write-beteende.
Utan delat OPcache-minne förblir nyttolaster komprimerad serialiserad data. Detta gäller också när OPcache är fullt, när dess API inte är tillgänglig eller är begränsad, eller när dess svartlista eller opcache.max_file_size undantar filen. OPcache med enbart filcache väljer inte formatet med vanliga arrayer. Se PHP OPcache-konfigurationen för dessa värdkontroller.
Standardformatet med vanliga arrayer har en gräns på 1 MiB, mätt mot både den serialiserade datan och den genererade källkoden i PHP. Större nyttolaster förblir komprimerade för att undvika kompileringskostnader för stora arrayer när en CLI-process utan OPcache läser en cache som fyllts av webbservrar.
Små vanliga filer måste fortfarande tolkas av en sådan läsare, och nyskrivna filer kan behöva kompileras under opcache.file_update_protection.
Filtret blockstudio/cache/compress åsidosätter formatet för varje omfång, till exempel när WP-CLI fyller cachefiler åt webbservrar med OPcache aktiverat. Om false returneras åsidosätts även storleksgränsen: gör det bara om alla läsare kan hantera den genererade PHP-filen. Om zlib inte är tillgängligt är vanlig PHP fortfarande reservlösningen.
Samtidighet och lagringstid
Kalla cache-nycklar använder ett single-flight-lås. En förfrågan bygger nyttolasten medan samtidiga förfrågningar väntar på det atomiskt publicerade resultatet, i stället för att upprepa samma sök- eller kompileringsarbete. Atomisk publicering förhindrar partiella objekt. Om en uppdatering misslyckas finns ett giltigt, inaktuellt senast fungerande objekt kvar, felet går att observera och nästa förfrågan kan återhämta sig.
Körningsomfattningar behåller som standard 20 publicerade nyttolaster. Justera gränsen per omfattning när en integration avsiktligt skapar fler cachekontexter:
add_filter(
'blockstudio/cache/max_files_per_scope',
function (int $maximum, string $scope): int {
return 'runtime' === $scope ? 50 : $maximum;
},
10,
2
);
Lagringshanteringen tar aldrig bort en fil som den installerade kartan för tidig leverans hänvisar till, och filtret blockstudio/cache/protected_paths markerar ytterligare sökvägar som rensningen måste lämna orörda.
Oanvända namnrymder samlas in automatiskt i stället för att ansamlas vid varje aktivering av tillägg och varje uppdatering av PHP eller WordPress. Ett distributionskodstycke som tidigare använde glob för den gamla cachekatalogen Tailwind bör anropa Blockstudio\Runtime_Cache::purge('tailwind') i stället.
En namnrymd avvecklas när körningsidentiteten ändras, till exempel efter en uppdatering av kärnan WordPress. Vid den första rensningsomgången som hittar den avvecklad skrivs en markör för .retired till den, och trädet samlas in när cache.namespaceGrace sekunder har gått sedan dess (ett dygn som standard). Om trädet skrivs igen under tiden börjar respitperioden om. Varken den aktuella namnrymden för en omfattning eller en namnrymd vars aktiverade artefakt fortfarande levereras via kartan för tidig leverans samlas in; respitperioden för den senare börjar när nästa aktivering flyttar kartposten någon annanstans. Sidor som cachats utanför WordPress fortsätter att länka till de innehållshashade stilmallar som användes vid renderingen. Därför bör en webbplats som levererar tailwind.output: "link"-sidor via CDN eller en lång webbläsarcache ange en respitperiod som motsvarar den längsta tid som en sådan kopia kan finnas kvar:
{
"cache": {
"namespaceGrace": 777600
}
}
När en uppgraderad installation innehåller den platta katalogen cache/runtime från före 7.6 byter Blockstudio namn på den atomiskt så att den flyttas bort från den aktiva sökvägen. Ett WP-Cron-jobb tar sedan bort högst 500 filsystemsposter per omgång. På så sätt undviks att gamla nyttolaster och .build.lock-träd tar upp diskutrymme, utan att förfrågan som upptäcker en stor katalog behöver ta bort den rekursivt. Rensningen körs endast när cache.enabled är aktivt; ändra storleken på varje omgång med blockstudio/cache/legacy_cleanup_batch_size om värden behöver mindre eller större omgångar.
Inaktivera de beständiga cacharna i blockstudio.json:
{
"cache": {
"enabled": false
}
}
Eller via ett filter:
add_filter('blockstudio/settings/cache/enabled', '__return_false');
Renderingscachen i minnet per förfrågan som beskrivs under Prestanda är avsiktligt separat, men dess beständiga artefakter använder samma filsystemsgräns.
Tömma en äldre låskö
Versioner före 7.6.14 lämnade kvar en fil av typen .build.lock för varje innehållsändring, och en webbplats med hög trafik kan ha hundratusentals sådana filer. Efter uppgraderingen tar WP-Cron bort dem automatiskt i begränsade omgångar. Om du vill tömma kön direkt och ge värden en siffra kör du CLI:
wp bs cache status
wp bs cache cleanup
status räknar återstående äldre lås och rapporterar när nästa omgång körs. cleanup kör omgångar tills inget inaktivt återstår och samlar sedan in cache-namnrymder där respitperioden har gått ut. Lås som är nyare än en timme eller fortfarande hålls av en pågående förfrågan lämnas till nästa omgång. Ta aldrig bort låsfiler manuellt medan webbplatsen tar emot trafik; ett aktivt lås är det som hindrar samtidiga förfrågningar från att bygga parallellt.
wp bs cache clear rensar hela körningscachen för den aktuella webbplatsen, eller en omfattning i alla namnrymder med --scope=runtime. Nästa förfrågan bygger från en kall cache, så kör kommandot när trafiken är låg.
Cache för Tailwind
Tailwinds kompilerade CSS-cache använder den gemensamma körningsroten under dess nätverks-/webbplats-/körningsnamnrymd och omfattningen tailwind. Som standard lagrar den upp till 1,000 poster i 30 dagar, tillräckligt för att behålla nycklar på sidnivå för en hel webbplats i stället för att ta bort dem efter ett litet antal rutter.
Tailwind återanvänder också en varm kompilator för samma CSS-indata i långlivade processer och sparar kompilatorns konstruktionstillstånd mellan processer. Kalla uppsättningar av sidkandidater kompileras fortfarande separat, men ramverkets parser behöver inte byggas om varje gång.
Använd de här filtren för att ändra lagringstiden:
add_filter('blockstudio/tailwind/cache_max_files', function () {
return 1500;
});
add_filter('blockstudio/tailwind/cache_max_age', function () {
return 14 * DAY_IN_SECONDS;
});
Minimiåldern är en timme.
Cachefiler innehållshashas, och en cachad sida länkar till dem en i taget med URL. Därför kan rensningen och en lagrad sida vara oense om vilka filer som fortfarande behövs. Innan förrenderade dokument levereras kontrolleras att den länkade stilmallen finns, så en borttagen fil leder till en omrendering i stället för en sida utan stilar. Om cache_max_files höjs över antalet unika sidnycklar kan omrenderingen undvikas helt.
Den anonyma HTML-cachen som finns under samma rot.