Memorizzazione nella cache
Blockstudio include cache persistenti basate su file. Sono abilitate per impostazione predefinita tramite l’impostazione cache.enabled e vengono scritte in:
wp-content/blockstudio/cache/
Questa radice configurata contiene payload delle build runtime, dati di registrazione precompilati dei blocchi, risorse dell’editor, Tailwind CSS, documenti renderizzati, frammenti delle isole, HTML statici, indici del grafo, code di riscaldamento e diagnostica della cache. In questo modo si evita di ripetere le operazioni di individuazione, analisi, compilazione e rendering, mantenendo tutto lo stato runtime generato entro un unico confine gestibile dall’host.
Per scelta, il valore predefinito si trova fuori da uploads, dove gli host con protezioni rafforzate potrebbero bloccare i payload della cache PHP. Modificate la posizione con cache.path; i percorsi relativi vengono risolti a partire da WP_CONTENT_DIR, mentre i percorsi assoluti supportano volumi di cache scrivibili dedicati:
{
"cache": {
"enabled": true,
"path": "cache/blockstudio"
}
}
Per una configurazione specifica dell’ambiente, usate il filtro dell’impostazione oppure quello della directory risolta:
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';
});
La modifica del percorso avvia una cache a freddo. I vecchi file in wp-content/uploads/blockstudio/cache non vengono più letti e possono essere rimossi.
Identità e invalidazione
Ogni ambito è annidato sotto un’identità di rete/blog e un’identità runtime completa. Le voci della cache cambiano quando cambiano i relativi input, inclusi i file di blocco monitorati, i file dei campi, le dipendenze delle risorse, le impostazioni, il tema attivo, i plugin attivi, gli inventari logici di individuazione, le versioni WordPress, PHP e Blockstudio. Gli hash delle dipendenze specifici degli elementi isolano le build con sole modifiche dagli oggetti non correlati.
Fonti logiche di individuazione contribuiscono anche con il loro ID sorgente, l’impronta digitale del contenuto e gli input monitorati. Selezioni runtime alternative possono aggiungere un valore blockstudio/cache/context per isolare tutti gli ambiti della cache. Gli host il cui confine tra tenant differisce dagli ID di rete/blog WordPress possono filtrare blockstudio/cache/site_key; il risultato viene sanificato prima di diventare un segmento del percorso.
Durante una richiesta frontend con cache calda, Blockstudio carica il registro runtime prima di creare le fonti di individuazione. Una cache valida evita quindi l’individuazione ricorsiva delle fonti, la creazione dei blocchi, l’analisi dei campi e le scansioni ripetute dell’albero per calcolare le chiavi della cache.
Il payload runtime memorizza anche i percorsi risolti degli asset dei blocchi, le dimensioni, i timestamp e gli elenchi dei fogli di stile dei moduli. Le richieste successive riutilizzano questi metadati invece di ripetere per ogni blocco renderizzato la ricerca degli output degli asset e la scansione delle directory dei moduli. I filtri per gli asset URL e i filtri di disabilitazione vengono comunque eseguiti per la richiesta corrente, e assets.inlineLimit mantiene il budget e l’ordine di cascata definiti per l’intera pagina. I metadati degli output degli asset non vengono raccolti se assets.enqueue o la cache persistente sono disabilitati. Una build valida precedente ma non aggiornata ripiega sulla risoluzione degli asset dal disco.
Le impostazioni risolte che non sono cambiate riutilizzano la propria impronta digitale all’interno della richiesta. Ricaricare o modificare le impostazioni la invalida; i valori mutabili di oggetti o riferimenti vengono sottoposti nuovamente a hash, anziché riutilizzare un’impronta potenzialmente non aggiornata.
In ambienti production e staging, uno snapshot di monitoraggio convalidato viene considerato attendibile per 20 secondi prima che Blockstudio controlli di nuovo i file e le directory con stats. Gli ambienti local e development hanno come valore predefinito zero, così le modifiche alle fonti sono visibili immediatamente. Modificate questo intervallo con:
add_filter('blockstudio/cache/watch_debounce', function () {
return 30;
});
Il debounce può ritardare il rilevamento automatico delle modifiche al sorgente al massimo del numero di secondi configurato. Gli asset compilati richiesti, gli asset raw non vuoti memorizzati nella cache e i fogli di stile dei moduli vengono comunque controllati a ogni cache hit. Eliminandone uno, il payload runtime viene invalidato immediatamente, invece di fornire metadati degli asset non aggiornati fino alla scadenza dell’intervallo. Impostate il debounce su 0 quando anche un ambiente simile a quello di produzione viene usato per modificare attivamente i file.
I payload della cache sono file protetti PHP. Per i payload di piccole dimensioni si usano array semplici quando il processo di scrittura dispone di memoria condivisa OPcache attiva e la destinazione non è esclusa. OPcache può così riutilizzare l’array compilato nelle inclusioni successive; le modifiche ai dati restituiti continuano a seguire il normale comportamento copy-on-write di PHP.
Senza OPcache con memoria condivisa, i payload rimangono dati serializzati compressi. Questo vale anche quando OPcache è piena, la sua API non è disponibile o è soggetta a restrizioni, oppure la sua blacklist o opcache.max_file_size esclude il file. OPcache con sola cache su file non seleziona il formato array semplice. Per questi controlli a livello di host, consultate la configurazione di OPcachePHP.
Il formato predefinito ad array semplici è limitato a 1 MiB, misurato sia sui dati serializzati sia sul sorgente PHP generato. I payload più grandi restano compressi, per evitare i costi di compilazione degli array di grandi dimensioni quando un processo CLI senza OPcache legge una cache riscaldata dai worker web.
Anche questi lettori devono analizzare i file semplici di piccole dimensioni, mentre i file appena scritti potrebbero dover essere compilati durante opcache.file_update_protection.
Il filtro blockstudio/cache/compress sostituisce il formato per ambito, ad esempio quando WP-CLI riscalda i file della cache per i worker web con OPcache abilitata. Restituire false sostituisce anche il limite di dimensione: fatelo solo se ogni lettore è in grado di gestire il file PHP generato. Se zlib non è disponibile, PHP semplice resta il formato di ripiego.
Concorrenza e conservazione
Le chiavi della cache a freddo usano un lock single-flight. Una richiesta crea il payload mentre le richieste simultanee attendono il risultato pubblicato atomicamente, invece di ripetere lo stesso lavoro di individuazione o compilazione. La pubblicazione atomica impedisce la creazione di oggetti parziali. Se un aggiornamento non riesce, resta disponibile un ultimo oggetto valido, l’errore è osservabile e la richiesta successiva può recuperare.
Per impostazione predefinita, gli ambiti runtime conservano 20 payload pubblicati. Modificate il limite per ambito quando un’integrazione crea intenzionalmente più contesti di cache:
add_filter(
'blockstudio/cache/max_files_per_scope',
function (int $maximum, string $scope): int {
return 'runtime' === $scope ? 50 : $maximum;
},
10,
2
);
La conservazione non elimina mai un file a cui fa riferimento la mappa di early-serve installata; il filtro blockstudio/cache/protected_paths contrassegna altri percorsi che la pulizia deve lasciare intatti.
Gli spazi dei nomi inutilizzati vengono raccolti automaticamente, invece di accumularsi a ogni attivazione di un plugin e a ogni aggiornamento di PHP o WordPress. Uno snippet di distribuzione che prima cercava i file nella vecchia directory della cache Tailwind dovrebbe chiamare Blockstudio\Runtime_Cache::purge('tailwind').
Uno spazio dei nomi viene ritirato quando cambia l’identità runtime, per esempio dopo un aggiornamento di base WordPress. La prima scansione di pulizia che lo rileva come ritirato vi scrive un marcatore .retired e l’albero viene raccolto una volta trascorsi cache.namespaceGrace secondi (un giorno per impostazione predefinita). Se nel frattempo l’albero viene scritto di nuovo, il periodo di tolleranza ricomincia. Non vengono raccolti né lo spazio dei nomi attuale di un ambito, né quello da cui la mappa di early-serve continua a servire un artefatto attivato; il periodo di tolleranza di quest’ultimo inizia quando l’attivazione successiva sposta altrove la voce della mappa. Le pagine memorizzate nella cache al di fuori di WordPress continuano a usare i fogli di stile con hash del contenuto con cui sono state renderizzate. Perciò, se un sito serve pagine tailwind.output: "link" tramite un CDN o una cache del browser di lunga durata, il periodo di tolleranza dovrebbe essere portato almeno alla durata massima di tali copie:
{
"cache": {
"namespaceGrace": 777600
}
}
Quando un’installazione aggiornata contiene la directory piatta cache/runtime precedente alla versione 7.6, Blockstudio la rinomina atomicamente rimuovendola dal percorso attivo. Un job WP-Cron rimuove quindi al massimo 500 voci del filesystem per passaggio. In questo modo i vecchi payload e gli alberi .build.lock non occupano spazio su disco, senza far sì che la richiesta che rileva una directory di grandi dimensioni la elimini ricorsivamente. La pulizia viene eseguita solo quando cache.enabled è attivo; modificate la dimensione dei batch con blockstudio/cache/legacy_cleanup_batch_size se l’host necessita di passaggi più piccoli o più grandi.
Disabilitate le cache persistenti in blockstudio.json:
{
"cache": {
"enabled": false
}
}
Oppure tramite un filtro:
add_filter('blockstudio/settings/cache/enabled', '__return_false');
La cache di rendering in memoria per richiesta descritta in Prestazioni è volutamente separata, ma i suoi artefatti persistenti usano lo stesso confine del filesystem.
Svuotare l’arretrato dei lock legacy
Le versioni precedenti a 7.6.14 lasciavano un file .build.lock per ogni modifica al contenuto e un sito molto frequentato può accumularne centinaia di migliaia. Dopo l’aggiornamento, WP-Cron li rimuove autonomamente in batch limitati. Per svuotare subito l’arretrato e fornire un numero al proprio host, eseguite il comando CLI:
wp bs cache status
wp bs cache cleanup
status conta i lock legacy rimasti e indica quando verrà eseguito il batch successivo. cleanup esegue batch finché non resta nulla di inattivo, poi raccoglie gli spazi dei nomi della cache il cui periodo di tolleranza è scaduto. I lock più recenti di un’ora o ancora detenuti da una richiesta in esecuzione vengono lasciati per il passaggio successivo. Non eliminate mai manualmente i file di lock mentre il sito serve traffico: un lock detenuto è il meccanismo di elezione che impedisce alle richieste simultanee di creare build in parallelo.
wp bs cache clear svuota l’intera cache runtime del sito corrente oppure un ambito in tutti gli spazi dei nomi con --scope=runtime. La richiesta successiva ricrea la cache a freddo, quindi eseguite il comando in un momento di traffico ridotto.
Cache Tailwind
La cache compilata CSS di Tailwind usa la radice runtime condivisa nello spazio dei nomi rete/sito/runtime e nell’ambito tailwind. Per impostazione predefinita, conserva fino a 1,000 voci per 30 giorni, un numero sufficiente a mantenere le chiavi a livello di pagina per un intero sito invece di eliminarle dopo poche route.
Tailwind riutilizza anche un compilatore già caldo per lo stesso input CSS nei processi di lunga durata e conserva lo stato di creazione del compilatore tra un processo e l’altro. Gli insiemi di candidate di pagina a freddo vengono ancora compilati separatamente, ma non serve ricostruire ogni volta l’analizzatore del framework.
Usate questi filtri per modificare la conservazione:
add_filter('blockstudio/tailwind/cache_max_files', function () {
return 1500;
});
add_filter('blockstudio/tailwind/cache_max_age', function () {
return 14 * DAY_IN_SECONDS;
});
L’età minima è un’ora.
I file della cache hanno hash basati sul contenuto e una pagina memorizzata nella cache collega un file tramite URL; di conseguenza, l’eliminazione di una voce e una pagina archiviata possono non concordare sui file ancora necessari. Prima di servirli, i documenti prerenderizzati vengono controllati rispetto al foglio di stile collegato, perciò l’eliminazione di un file comporta un solo nuovo rendering, anziché una pagina priva di stili. Aumentare cache_max_files oltre il numero di chiavi distinte a livello di pagina evita del tutto il nuovo rendering.
La cache anonima HTML che si trova sotto la stessa radice.