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

[Prerendering statico](https://blockstudio.dev/it/docs/production/static-prerendering/)

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](https://blockstudio.dev/it/docs/blocks/hooks/php/#blockstudio-static_prerender-request_bypass)

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](https://blockstudio.dev/it/docs/production/static-prerendering/#early-serving-and-atomic-deployment)

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.

[Servizio anticipato](https://blockstudio.dev/it/docs/production/static-prerendering/#early-serving-and-atomic-deployment)

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.

[Modalità firma e grafo](https://blockstudio.dev/it/docs/production/static-prerendering/#signature-and-graph-modes)

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.

[Configurazione di CDN](https://blockstudio.dev/it/guides/static-prerendering/#putting-a-cdn-in-front)

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.

[Blocchi isola](https://blockstudio.dev/it/docs/blocks/islands/)

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.

[Profiler](https://blockstudio.dev/it/docs/production/performance/#profiler)

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.

[Profili di prestazioni](https://blockstudio.dev/it/docs/production/performance/#performance-profiles)

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.

[Media](https://blockstudio.dev/it/docs/production/media/)

index.php

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

## [Un’unica directory della cache](https://blockstudio.dev/it/docs/production/caching/)

Ogni file generato si trova in cache.path ed è identificato in base a un’identità di runtime.

## [Build a esecuzione singola](https://blockstudio.dev/it/docs/production/caching/#concurrency-and-retention)

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](https://blockstudio.dev/it/docs/production/performance/#render-cache)

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](https://blockstudio.dev/it/docs/general/settings/#assets)

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](https://blockstudio.dev/it/docs/blocks/assets/registering/#inline-small-stylesheets)

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](https://blockstudio.dev/it/docs/blocks/assets/registering/#load-order)

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](https://blockstudio.dev/it/docs/blocks/assets/registering/#disable-enqueuing)

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](https://blockstudio.dev/it/docs/dev/cli/)

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](https://blockstudio.dev/it/docs/blocks/hooks/php/#error-handling)

error/logged ed error/exception inoltrano gli errori Blockstudio a un logger o tracker esterno.

## [Rendering in batch](https://blockstudio.dev/it/docs/production/performance/#in-process-batch-rendering)

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

[Passa a Plus](https://blockstudio.dev/it/plus/)
