Vai al contenuto

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.

blockstudio.json
{
  "performance": {
    "staticPrerender": {
      "enabled": true,
      "ttl": 3600,
      "earlyServe": true,
      "dynamicPaths": ["/account", "/checkout"]
    }
  }
}

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.

Terminale
# 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 teardown

Aggiornato 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.

deploy.php
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']));

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.

nginx.conf
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;
}

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.

block.json
{
  "name": "acme/cart-count",
  "title": "Cart count",
  "blockstudio": {
    "island": {
      "mode": "dynamic",
      "attributes": ["productId"],
      "loading": "visible",
      "event": "cart:updated",
      "cache": {
        "ttl": 60,
        "per": "user"
      }
    }
  }
}

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.

blockstudio.json
{
  "dev": {
    "perf": true
  },
  "performance": {
    "measurement": {
      "enabled": true,
      "headers": true,
      "timings": true
    }
  }
}

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.

blockstudio.json
{
  "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.

index.php
<?php
echo bs_media_image([
  'src' => 'assets/images/hero.webp',
  'alt' => 'Hero',
  'eager' => true,
]);

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.

Plus

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