Statico quando possibile
Pagine prerenderizzate e impostazioni predefinite per la produzione, definite in blockstudio.json.
Prerenderizza le pagine anonime
Il prerendering statico è disattivato per impostazione predefinita. Attiva performance.staticPrerender e Blockstudio memorizzerà ogni documento HTML completo ricevuto da un visitatore anonimo, quindi risponderà al successivo visitatore anonimo usando quella copia.
Le richieste che devono restare dinamiche non passano mai da qui: richieste diverse da GET, stringhe di query, area di amministrazione, REST, Ajax, cron, feed, ricerca, anteprime, pagine con nonce, tutti i percorsi sotto dynamicPaths e visitatori connessi, a meno che serveLoggedIn non sia attivo.
{
"performance": {
"staticPrerender": {
"enabled": true,
"ttl": 3600,
"earlyServe": true,
"dynamicPaths": ["/account", "/checkout"]
}
}
}<!-- blockstudio:no-cache -->
<p class="stock">
<?php echo esc_html( $a['label'] ); ?>
</p>Disattivato per impostazione predefinita
Non cambia nulla finché blockstudio.json non specifica la funzionalità.
Percorsi dinamici
Un percorso dinamico /account comprende /account/orders, ma non /accounting.
Marcatore di esclusione
Un commento blockstudio:no-cache esclude qualsiasi risposta dalla cache.
Visitatori connessi
Con serveLoggedIn, i visitatori leggono le pagine salvate; le loro pagine non vengono mai memorizzate.
Esclusione personalizzata
Il filtro static_prerender/request_bypass esclude dalle pagine memorizzate le richieste specificate, ad esempio quelle con un cookie del carrello.
Coda di preriscaldamento
Una coda persistente esegue nuovamente il rendering delle pagine obsolete secondo l’intervallo impostato.
Route a bassa frequenza
Anche le route non incluse nella mappa distribuita vengono servite in anticipo, una volta che WordPress le ha renderizzate e memorizzate.
Verifica dei fogli di stile
Se il foglio di stile Tailwind collegato a una pagina memorizzata non è più disponibile, la pagina viene renderizzata di nuovo e non viene mai servita senza stili.
Servito prima dell’avvio di WordPress
Con earlyServe attivo, Blockstudio installa un drop-in advanced-cache.php che trasmette una pagina salvata prima del caricamento di WordPress, dei plugin o del tema. Non sovrascrive mai un drop-in, una mappa delle route o una riga WP_CACHE che non abbia scritto.
Questo sito lo usa. L’8 ottobre, le pagine 2026 blockstudio.dev hanno risposto con x-blockstudio-static-prerender: HIT-EARLY, l’header inviato dal drop-in.
# Identity, files, queue, and hit/miss counters
wp bs prerender status
# Re-render stale entries now
wp bs prerender warm
# Dead or orphaned early-serve map entries
wp bs prerender map status
wp bs prerender map prune --dry-run
# Remove the drop-in and map this install owns
wp bs teardowncurl -sI https://blockstudio.dev/ | grep -i x-blockstudio
# x-blockstudio-static-prerender: HIT-EARLYAggiornato dopo ogni modifica
La modalità predefinita signature riempie la cache quando una richiesta anonima non trova una pagina memorizzata e la aggiorna dopo le modifiche a livello di sito. Salvando o eliminando un articolo, svuota la cache di quell’articolo e della pagina iniziale oppure ne pianifica il nuovo rendering quando il preriscaldamento è attivo.
La modalità graph è pensata per gli strumenti di deploy. Registra i file letti da ogni pagina, così una build riesegue il rendering solo delle route i cui file sono cambiati, quindi attiva il nuovo insieme come un unico artefatto. Se un file referenziato non supera la convalida, l’artefatto precedente resta attivo.
L’installazione di un artefatto confronta i byte e sostituisce atomicamente i documenti modificati. last_promotion() indica quante route sono state promosse, sostituite, ignorate o mantenute, così un deploy può registrare il dato e confrontare l’ID della build attiva.
use Blockstudio\Static_Prerender_Runtime;
$plan = Static_Prerender_Runtime::build_plan($sourceUrls);
foreach ($plan['affectedUrls'] as $url) {
$result = render_with_dependencies($url);
Static_Prerender_Runtime::persist_built_response(
$url,
$result['html'],
$result['files'],
$result['virtualHashes']
);
}
Static_Prerender_Runtime::garbage_collect(array_keys($plan['live']));use Blockstudio\Static_Prerender_Early_Serve;
use Blockstudio\Static_Prerender_Runtime;
$entry = Static_Prerender_Runtime::artifact_entry($targetUrls);
Static_Prerender_Early_Serve::install_artifact_entry(
$entry,
Static_Prerender_Runtime::cache_root_path()
);
$counts = Static_Prerender_Early_Serve::last_promotion();Dietro un CDN
L’header di prerender indica già quali risposte possono essere condivise in sicurezza. Mappa HIT e HIT-EARLY a una durata Cache-Control all’origine, memorizza nella cache solo le risposte che ne hanno una ed escludi dall’edge i cookie wordpress_logged_in_, wp-postpass_ e comment_author_email_, il tuo dynamicPaths, wp-admin e wp-json.
Le pagine memorizzate nella cache edge continuano a collegarsi al foglio di stile con hash del contenuto con cui sono state renderizzate. Aumenta cache.namespaceGrace fino alla durata massima di una copia di questo tipo e i fogli di stile ritirati resteranno sul disco fino alla scadenza.
map $upstream_http_x_blockstudio_static_prerender $edge_cache_control {
"~^HIT" "public, s-maxage=604800";
default "";
}
location ~ \.php$ {
include fastcgi_params;
fastcgi_pass unix:/run/php/php-fpm.sock;
add_header Cache-Control $edge_cache_control;
}{
"cache": {
"namespaceGrace": 777600
},
"tailwind": {
"enabled": true,
"output": "link"
}
}Un blocco dinamico in una pagina memorizzata nella cache
Imposta blockstudio.island su dynamic e la pagina memorizzata nella cache conterrà un segnaposto al posto del blocco. Il browser raccoglie tutte le isole dinamiche della pagina e recupera i relativi frammenti con un’unica richiesta in batch, ciascuno firmato con il nome del blocco e i suoi attributi consentiti.
hydrate mantiene l’intero HTML nella pagina e invia solo un evento di mount. Le isole dinamiche possono attendere di essere visibili, aggiornarsi all’attivazione di un evento della finestra e memorizzare i frammenti nella cache per utente o a livello globale.
{
"name": "acme/cart-count",
"title": "Cart count",
"blockstudio": {
"island": {
"mode": "dynamic",
"attributes": ["productId"],
"loading": "visible",
"event": "cart:updated",
"cache": {
"ttl": 60,
"per": "user"
}
}
}
}<div class="cart-count-placeholder">
Loading cart...
</div>window.dispatchEvent(new Event('cart:updated'));Scopri dove viene impiegato il tempo di rendering
Aggiungi ?blockstudio-perf a qualsiasi URL del frontend e un pannello mostrerà i tempi di rendering per blocco, il numero di chiamate e le fasi di trasformazione, template e componente. Gli stessi tempi vengono trasmessi negli header Server-Timing, che continuano a funzionare anche quando un CDN memorizza nella cache il HTML.
Solo gli utenti che hanno effettuato l’accesso e dispongono di edit_posts vedono l’output; per tutte le altre richieste, il profiler viene disattivato in init. performance.measurement aggiunge gli header con l’hash del profilo e della configurazione e un Performance_Measurement::snapshot() API.
{
"dev": {
"perf": true
},
"performance": {
"measurement": {
"enabled": true,
"headers": true,
"timings": true
}
}
}use Blockstudio\Performance_Measurement;
$snapshot = Performance_Measurement::snapshot();Un solo interruttore per le impostazioni predefinite di produzione
Impostando performance.profile su speed, si rimuovono dall’head le informazioni sul generatore, le emoji, i feed e i dati di discovery, si disattiva la discovery di oEmbed, XML-RPC e i pingback, si eliminano gli asset frontend generici del core, si limita Heartbeat al di fuori degli editor e si esegue il prefetch dei link della stessa origine al passaggio del mouse o quando ricevono il focus.
Il valore predefinito è compat, che non modifica nulla. Ogni valore secondario sostituisce il profilo, così potete mantenere un comportamento e adottare tutte le altre impostazioni.
{
"performance": {
"profile": "speed",
"preload": {
"links": "off"
}
}
}Immagini che mantengono il proprio spazio
Le immagini del tema sono fuori dalla libreria dei media, quindi WordPress non ne conosce le dimensioni. bs_media_image() legge le dimensioni reali da un assets/media.json generato e riserva le proporzioni prima del caricamento del file.
Attivate performance.media.lazy e l’immagine URL vera resta dietro un segnaposto delle dimensioni corrette finché non si avvicina all’area visibile.
<?php
echo bs_media_image([
'src' => 'assets/images/hero.webp',
'alt' => 'Hero',
'eager' => true,
]);{
"performance": {
"media": {
"lazy": true,
"skeleton": true,
"metadata": true,
"rootMargin": "300px"
}
}
}Un’unica directory della cache
Ogni file generato si trova in cache.path ed è identificato in base a un’identità di runtime.
Build a esecuzione singola
Una richiesta genera una chiave della cache non ancora memorizzata. Le altre attendono, riutilizzano l’ultimo payload valido o ricevono un 503 con Retry-After.
Payload compatibili con OPcache
I payload di cache più piccoli sono array PHP semplici, che OPcache può riutilizzare dalla memoria condivisa. Quelli più grandi restano compressi.
Cache di rendering
Un tag di blocco autochiudente con gli stessi attributi viene renderizzato una volta per richiesta. Le occorrenze successive vengono recuperate dalla memoria.
Aggiornamento aggregato delle scelte
Un picco di scritture di contenuti, ad esempio durante un’importazione, si traduce in un unico aggiornamento delle scelte popolate dei campi memorizzate nella cache.
Cache multi-tenant
Filtra cache/site_key per definire il confine del tuo tenant e cache/context per le varianti runtime dello stesso sito.
Risorse compilate nella cache
Con assets.output impostato su cache, le risorse compilate escono dall’albero dei blocchi, così il deploy può avvenire da un checkout immutabile.
Build suddivise in shard
Static_Prerender_Batch_Renderer suddivide una build in shard stabili N/TOTAL e chi lo invoca può calcolare la stessa partizione.
Inserisci i fogli di stile piccoli inline
assets.inlineLimit inserisce inline i fogli di stile più piccoli dei blocchi, entro un limite di byte e nello stesso ordine della cascata.
Posiziona il blocco CSS alla fine dell’head
Il blocco CSS viene aggiunto subito prima del tag di chiusura head, dopo i fogli di stile del tema e dei plugin.
Salta le risorse inutilizzate
Un template che non restituisce nulla non accoda alcuna risorsa. assets.enqueue false lascia a te la gestione di tutte le risorse.
Comandi della cache
wp bs cache status, cleanup e clear controllano, svuotano e cancellano la cache runtime. wp bs prerender purge rimuove le pagine memorizzate.
Rimozione pulita
wp bs teardown rimuove solo lo stato gestito da questa installazione.
Hook degli esiti
cache/outcome e static_prerender/outcome riportano hit, build, miss e errori alle metriche.
Hook degli errori
error/logged ed error/exception inoltrano gli errori Blockstudio a un logger o tracker esterno.
Rendering in batch
Batch_Render::reset() azzera lo stato della richiesta tra un documento e l’altro nello stesso processo. render/dependencies elenca i file di ciascun blocco.
Il kit ufficiale di estensioni
Template di siti premium, istruzioni di sistema per l’AI e una community privata Discord. Acquisto una tantum, aggiornamenti a vita.
- Oltre 500 modelli di siti
- Istruzioni di sistema per l’AI
- Aggiornamenti a vita
- Community privata di Discord