# Statique lorsque c’est possible

Pages prérendues et valeurs par défaut de production, définies dans blockstudio.json.

## Prérendre les pages anonymes

Le pré-rendu statique est désactivé par défaut. Activez `performance.staticPrerender` et Blockstudio pour que chaque document HTML complet reçu par un visiteur anonyme soit enregistré, puis servi au prochain visiteur anonyme depuis cette copie.

Les requêtes qui doivent rester dynamiques ne le touchent jamais : les requêtes autres que GET, les chaînes de requête, l’administration, REST, Ajax, cron, les flux, la recherche, les aperçus, les pages contenant un nonce, tous les chemins sous `dynamicPaths` et les visiteurs connectés, sauf si `serveLoggedIn` est activé.

[Prérendu statique](https://blockstudio.dev/fr/docs/production/static-prerendering/)

blockstudio.json

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

## Désactivé par défaut

Rien ne change tant que blockstudio.json ne nomme pas la fonctionnalité.

## Chemins dynamiques

Un chemin dynamique /account couvre /account/orders, mais pas /accounting.

## Marqueur de désactivation

Un commentaire blockstudio:no-cache exclut toute réponse du cache.

## Visiteurs connectés

Avec serveLoggedIn, ils consultent les pages enregistrées ; leurs propres pages ne sont jamais enregistrées.

## [Contournement personnalisé](https://blockstudio.dev/fr/docs/blocks/hooks/php/#blockstudio-static_prerender-request_bypass)

Le filtre static_prerender/request_bypass exclut des pages stockées toute requête que vous indiquez, par exemple une requête avec un cookie de panier.

## File de préchauffage

Une file durable relance le rendu des pages obsolètes selon l’intervalle que vous définissez.

## [Routes de longue traîne](https://blockstudio.dev/fr/docs/production/static-prerendering/#early-serving-and-atomic-deployment)

Les routes absentes de la carte déployée sont également servies rapidement, dès que WordPress les a générées et stockées.

## Vérification de la feuille de style

Si la feuille de style Tailwind liée à une page stockée a disparu, la page est générée à nouveau et n’est jamais servie sans style.

## Servi avant le démarrage de WordPress

Lorsque `earlyServe` est activé, Blockstudio installe un fichier d’interposition `advanced-cache.php` qui envoie une page enregistrée avant le chargement de WordPress, des extensions ou du thème. Il n’écrase jamais un fichier d’interposition, une table de routage ni une ligne `WP_CACHE` qu’il n’a pas écrite.

Ce site l’utilise. Le 8 octobre, 2026, les pages blockstudio.dev ont répondu avec `x-blockstudio-static-prerender: HIT-EARLY`, l’en-tête envoyé par le fichier d’interposition.

[Service anticipé](https://blockstudio.dev/fr/docs/production/static-prerendering/#early-serving-and-atomic-deployment)

Terminal

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

## Actualisé après chaque modification

Le mode `signature` par défaut remplit le cache lors d’une requête anonyme sans résultat et le renouvelle après les modifications à l’échelle du site. L’enregistrement ou la suppression d’un article purge cet article et la page d’accueil, ou les met en attente d’un nouveau rendu lorsque le préchauffage est activé.

Le mode `graph` est destiné aux outils de déploiement. Il enregistre les fichiers consultés par chaque page, afin qu’une compilation ne génère à nouveau que les routes dont les fichiers ont changé, puis active le nouvel ensemble comme un seul artefact. Si un fichier référencé échoue à la validation, l’artefact précédent reste actif.

L’installation d’un artefact compare les octets et remplace les documents modifiés de façon atomique. `last_promotion()` indique le nombre de routes promues, remplacées, ignorées ou conservées, afin qu’un déploiement puisse le consigner et le comparer à l’identifiant de compilation actif.

[Modes signature et graphe](https://blockstudio.dev/fr/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']));
```

## Derrière un CDN

L’en-tête de pré-rendu indique déjà quelles réponses peuvent être partagées sans risque. Associez `HIT` et `HIT-EARLY` à une durée de `Cache-Control` à l’origine, mettez en cache uniquement les réponses qui en comportent une, et contournez le nœud périphérique pour les cookies `wordpress_logged_in_`, `wp-postpass_` et `comment_author_email_`, ainsi que pour votre `dynamicPaths`, `wp-admin` et `wp-json`.

Les pages mises en cache en périphérie conservent le lien vers la feuille de style dont le nom contient le hachage du contenu et avec laquelle elles ont été générées. Réglez `cache.namespaceGrace` sur la durée maximale pendant laquelle une telle copie peut rester en cache, et les feuilles de style retirées resteront sur le disque jusqu’à son expiration.

[Configuration de CDN](https://blockstudio.dev/fr/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 bloc dynamique sur une page mise en cache

Réglez `blockstudio.island` sur `dynamic` : la page mise en cache contient alors un espace réservé à la place du bloc. Le navigateur collecte tous les îlots dynamiques de la page et récupère leurs fragments dans une seule requête groupée, chacun signé avec le nom du bloc et ses attributs autorisés.

`hydrate` conserve l’intégralité de HTML dans la page et n’envoie qu’un événement de montage. Les îlots dynamiques peuvent attendre d’être visibles, s’actualiser lorsqu’un événement de fenêtre se déclenche et mettre en cache les fragments par utilisateur ou globalement.

[Blocs isolés](https://blockstudio.dev/fr/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"
      }
    }
  }
}
```

## Voyez où s’écoule le temps de rendu

Ajoutez `?blockstudio-perf` à n’importe quel URL côté frontend pour afficher un panneau répertoriant les durées de rendu par bloc, le nombre d’appels et les phases de transformation, de modèle et de composant. Les mêmes durées sont envoyées dans des en-têtes `Server-Timing`, qui fonctionnent aussi lorsqu’un CDN met le HTML en cache.

Seuls les utilisateurs connectés disposant de `edit_posts` voient le résultat ; pour toute autre requête, le profileur est désactivé au niveau de `init`. `performance.measurement` ajoute des en-têtes de profil et de hachage de configuration, ainsi qu’un `Performance_Measurement::snapshot()` API.

[Profileur](https://blockstudio.dev/fr/docs/production/performance/#profiler)

blockstudio.json

```
{
  "dev": {
    "perf": true
  },
  "performance": {
    "measurement": {
      "enabled": true,
      "headers": true,
      "timings": true
    }
  }
}
```

## Un seul interrupteur pour les réglages de production

`performance.profile` réglé sur `speed` supprime les sorties du générateur, des émojis, des flux et de la découverte dans l’en-tête, retire la découverte oEmbed, désactive XML-RPC et les rétroliens, supprime les ressources génériques de l’interface publique de base, limite Heartbeat hors des éditeurs et précharge les liens de même origine au survol ou à la prise de focus.

La valeur par défaut est `compat`, ce qui ne change rien. Chaque valeur enfant remplace le profil : vous pouvez donc conserver un comportement tout en adoptant les autres réglages.

[Profils de performances](https://blockstudio.dev/fr/docs/production/performance/#performance-profiles)

blockstudio.json

```
{
  "performance": {
    "profile": "speed",
    "preload": {
      "links": "off"
    }
  }
}
```

## Des images qui gardent leur emplacement

Les images du thème se trouvent hors de la médiathèque, donc WordPress ne connaît pas leurs dimensions. `bs_media_image()` lit leurs dimensions réelles dans un `assets/media.json` généré et réserve le rapport hauteur/largeur avant le chargement du fichier.

Activez `performance.media.lazy` et la véritable URL reste derrière un espace réservé aux bonnes dimensions jusqu’à ce que l’image s’approche de la fenêtre d’affichage.

[Médias](https://blockstudio.dev/fr/docs/production/media/)

index.php

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

## [Un seul répertoire de cache](https://blockstudio.dev/fr/docs/production/caching/)

Chaque fichier généré se trouve sous cache.path et est indexé par une identité d’exécution.

## [Compilations à exécution unique](https://blockstudio.dev/fr/docs/production/caching/#concurrency-and-retention)

Une requête génère une clé de cache froide. Les autres attendent, réutilisent la dernière charge utile valide ou reçoivent un 503 avec Retry-After.

## Charges utiles compatibles avec OPcache

Les petites charges utiles du cache sont de simples tableaux PHP qu’OPcache peut réutiliser depuis la mémoire partagée. Les plus volumineuses restent compressées.

## [Cache de rendu](https://blockstudio.dev/fr/docs/production/performance/#render-cache)

Une balise de bloc auto-fermante avec les mêmes attributs n’est rendue qu’une fois par requête. Les occurrences suivantes sont servies depuis la mémoire.

## Actualisation groupée des choix

Une série d’écritures de contenu, par exemple lors d’une importation, déclenche une seule actualisation des choix de champs renseignés mis en cache.

## Caches multi-locataires

Filtrez cache/site_key pour définir votre propre frontière entre locataires et cache/context pour les variantes d’exécution d’un même site.

## [Ressources compilées dans le cache](https://blockstudio.dev/fr/docs/general/settings/#assets)

Lorsque assets.output est défini sur cache, les ressources compilées sont retirées de l’arborescence des blocs, ce qui permet de déployer depuis une extraction immuable.

## Compilations fragmentées

Static_Prerender_Batch_Renderer divise une compilation en fragments stables N/TOTAL, et l’appelant peut calculer la même partition.

## [Feuilles de style intégrées pour les petits fichiers](https://blockstudio.dev/fr/docs/blocks/assets/registering/#inline-small-stylesheets)

assets.inlineLimit intègre les feuilles de style des blocs les plus petites dans la limite d’un budget en octets, en respectant le même ordre de cascade.

## [Styles CSS de bloc à la fin de l’en-tête](https://blockstudio.dev/fr/docs/blocks/assets/registering/#load-order)

Les styles CSS de bloc sont ajoutés juste avant la balise de fermeture head, après les feuilles de style du thème et des extensions.

## [Ignorer les ressources inutilisées](https://blockstudio.dev/fr/docs/blocks/assets/registering/#disable-enqueuing)

Un modèle qui ne renvoie rien ne met aucune ressource en file d’attente. assets.enqueue false vous laisse gérer toutes les ressources.

## [Commandes de cache](https://blockstudio.dev/fr/docs/dev/cli/)

wp bs cache status, cleanup et clear permettent d’inspecter, de vider et de purger le cache d’exécution. wp bs prerender purge supprime les pages stockées.

## Désinstallation propre

wp bs teardown supprime uniquement l’état appartenant à cette installation.

## Hooks de résultat

cache/outcome et static_prerender/outcome signalent les accès, les compilations, les absences et les échecs à vos métriques.

## [Hooks d’erreur](https://blockstudio.dev/fr/docs/blocks/hooks/php/#error-handling)

error/logged et error/exception transmettent les erreurs Blockstudio à un journaliseur ou un outil de suivi externe.

## [Rendu par lots](https://blockstudio.dev/fr/docs/production/performance/#in-process-batch-rendering)

Batch_Render::reset() efface l’état de la requête entre les documents traités par un même processus. render/dependencies répertorie les fichiers de chaque bloc.

Plus

## Le kit d’extension officiel

Modèles de site premium, instructions système pour l’IA et communauté privée Discord. Achat unique, mises à jour à vie.

- 500+ modèles de sites
- Instructions système de l’IA
- Mises à jour à vie
- Communauté privée Discord

[Obtenir Plus](https://blockstudio.dev/fr/plus/)
