Prérendu statique
Le prérendu statique est un cache anonyme HTML activé sur demande. Une réponse pouvant être mise en cache doit être un document HTML complet et peut exclure son contenu avec <!-- blockstudio:no-cache -->. Blockstudio ignore les requêtes autres que GET, les chaînes de requête, l’administration WordPress, REST, Ajax, cron, les flux, les résultats de recherche situés sous le chemin de base de recherche à la racine du site (comme /search/term/), les en-têtes d’aperçu et de canevas, les requêtes contenant un nonce, les chemins déclarés dynamiques, les cookies de mot de passe ou de commentaire, ainsi que, par défaut, les requêtes des utilisateurs connectés. Une page dont le chemin contient uniquement un segment search ou preview plus loin, comme /docs/blocks/preview/, est mise en cache comme toute autre page.
{
"performance": {
"staticPrerender": {
"enabled": true,
"ttl": 3600,
"invalidate": "graph",
"earlyServe": true,
"serveLoggedIn": false,
"dynamicPaths": ["/account", "/checkout"],
"replayHeaders": ["Link"],
"warm": {
"enabled": true,
"interval": 900,
"concurrency": 4,
"transport": "http"
}
}
}
}
Les utilisateurs connectés ne peuvent utiliser une entrée de cache existante que si serveLoggedIn est vrai ; les réponses personnalisées ne créent jamais d’entrées de cache. Les chemins dynamiques respectent les limites des segments : /account correspond à /account/orders, mais pas à /accounting.
Lorsque la fonctionnalité est désactivée, aucun fichier n’est écrit, aucune extension drop-in n’est installée et aucun hook de requête ou d’administration n’est enregistré. earlyServe: false n’enregistre pas non plus de rappel d’administration Early Serve, et warm.enabled: false n’enregistre aucun rappel ni aucune tâche planifiée cron. La désactivation de l’une ou l’autre fonctionnalité supprime une fois l’état qu’elle gérait ; les requêtes suivantes n’effectuent aucun contrôle de nettoyage du système de fichiers ou de cron.
La désactiver selon l’environnement
Chaque valeur ci-dessus peut également être définie avec un filtre de configuration. Blockstudio se charge avant le thème actif, depuis une extension ou le chargement automatique Composer du thème. Il résout donc à nouveau ses paramètres d’exécution une fois le thème chargé et décide des hooks de prérendu statique à after_setup_theme. Un filtre ajouté par une extension ou dans le fichier functions.php du thème prend ainsi effet :
add_filter('blockstudio/settings/performance/staticPrerender/enabled', function ($enabled) {
return 'local' === wp_get_environment_type() ? false : $enabled;
});
Désactiver la fonctionnalité de cette manière revient à la désactiver dans blockstudio.json : aucun hook de requête, de contenu, d’administration ou de cron n’est enregistré, et l’entrée Early Serve du site, s’il a auparavant été servi de manière anticipée, est supprimée une fois. Un filtre ajouté plus tard, par exemple sur init, ne modifie pas les hooks enregistrés.
Modes signature et graphe
Le mode signature remplit une réponse indexée par identité lors d’une absence de cache anonyme normale. Il convient aux sites WordPress classiques et se renouvelle après les modifications à l’échelle du site.
Le mode graph est destiné aux intégrations déterministes de compilation et de déploiement. Appelez Static_Prerender_Runtime::build_plan() avec les URL sources actives, ne rendez que affectedUrls, puis enregistrez chaque résultat avec persist_built_response() ou persist_skipped_response(). Le plan compare les fichiers partagés et les empreintes exactes des dépendances de chaque page. garbage_collect() supprime les URL supprimées et les fichiers HTML non référencés.
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']
);
}
$targets = array_keys($plan['live']);
Static_Prerender_Runtime::garbage_collect($targets);
Les arguments facultatifs d’hôte et de page d’accueil cible réécrivent les routes pour un déploiement sans utiliser le chemin de la première page comme racine du site. Les outils de traitement par lots peuvent utiliser Static_Prerender_Batch_Renderer::render() et des fragments N/TOTAL stables ; Static_Prerender_Batch_Renderer::parse_shard() et select_shard() gèrent l’option de fragment, afin qu’un appelant puisse calculer la même partition que le moteur de rendu. Pendant une compilation, Static_Prerender_Batch_Renderer::is_rendering() indique si la requête actuelle correspond à un rendu par lots plutôt qu’à un visiteur, ce qui permet à un modèle d’ignorer les opérations qui ne doivent pas être exécutées lors d’une compilation. Un transport internal est fourni par le filtre générique blockstudio/static_prerender/render_internal ; le recours facultatif à HTTP utilise l’en-tête de préchauffage habituel.
Éléments suivis en mode graphe
Avec le transport HTTP par défaut, Static_Prerender_Batch_Renderer::render() envoie un jeton signé avec chaque requête de préchauffage, et la requête signale les fichiers lus : le modèle WordPress chargé, le modèle de chaque bloc Blockstudio rendu, les fichiers de modèle et de ressources, les fichiers ajoutés via blockstudio/render/dependencies et, pour une page synchronisée, ses fichiers de définition, de modèle, de contenu et de mise en page. Le rapport est écrit dans le répertoire de cache du site, que le moteur de rendu et le serveur Web partagent déjà pour les HTML générés. À la compilation suivante, build_plan() recalcule les empreintes de ces fichiers et ne marque que les routes dont les fichiers ont changé, ainsi que les nouvelles routes, celles qui ont dépassé leur ttl et toutes les routes lorsqu’un fichier partagé change (blockstudio.json, theme.json, style.css, functions.php, header.php, footer.php, tout ce qui se trouve sous inc/, parts/ et templates/, ainsi que les sources des ressources UI regroupées de Blockstudio). La signature partagée calcule l’empreinte des sources, jamais de la sortie compilée : les fichiers _dist compilés au premier rendu d’une compilation ne la modifient donc pas. artifact_entry() dérive l’identifiant de compilation de la même signature que celle observée par build_plan() avant le rendu.
Le contenu qui réside uniquement dans la base de données n’est pas un fichier et n’est pas suivi : articles modifiés dans l’administration, options, lignes générées ou prix. Une compilation qui doit prendre en compte ces modifications transmet $force à build_plan() ou rend elle-même les URL concernées. Le transport internal enregistre les dépendances renvoyées par son filtre.
Service anticipé et déploiement atomique
Lorsque earlyServe est activé, Blockstudio gère un petit wp-content/blockstudio-static-prerender-map.php, une extension drop-in advanced-cache.php et une déclaration WP_CACHE précise. L’extension drop-in lit une table de routes propre à chaque site et transmet une entrée admissible avant le démarrage de WordPress, des extensions ou du thème.
Blockstudio ne remplace jamais une table, une extension drop-in ou une déclaration WP_CACHE qui ne lui appartient pas. Les ressources du graphe valident chaque fichier HTML référencé avant le remplacement de la table ; si la validation échoue, le graphe précédent reste actif. Dans un multisite, les entrées partagent la table, mais sont isolées par hôte, chemin d’accueil et ID de site. Désactiver la fonctionnalité ou désactiver Blockstudio supprime uniquement l’entrée du site actuel et ne supprime les ressources partagées qu’une fois la dernière entrée gérée disparue.
Les outils de déploiement peuvent activer atomiquement un graphe entièrement rendu :
$entry = Static_Prerender_Runtime::artifact_entry($targetUrls);
Blockstudio\Static_Prerender_Early_Serve::install_artifact_entry(
$entry,
Static_Prerender_Runtime::cache_root_path()
);
La configuration reste la référence. install_artifact_entry() renvoie false à moins que enabled et earlyServe soient tous deux vrais, afin qu’un déploiement ne puisse jamais installer une table, une extension drop-in et une déclaration WP_CACHE que la prochaine requête d’administration supprimerait à nouveau.
install_artifact_entry() conserve l’build_id de l’entrée, ce qui permet au déploiement de le comparer à celui que renvoie ensuite installed_map_entries() pour cette entrée. La table est un fichier PHP lu avec include, et chaque écriture l’expulse du cache de code opérationnel. La lecture voit donc la nouvelle entrée dans le même processus, même si opcache.enable_cli est activé.
L’installation d’une ressource transfère ses documents dans un espace dédié aux ressources, que le nettoyage de rétention n’affecte jamais. Les fichiers référencés par la table ne peuvent être supprimés, où qu’ils se trouvent, afin que le trafic de rendu actif ne fasse pas expirer les routes de la table du service anticipé. Une clé de route n’est pas entièrement basée sur le contenu, donc un nouveau rendu peut modifier un document sans changer sa clé. L’installation compare les octets et remplace atomiquement tout document de ressource différent, laisse intacts les documents identiques et conserve un document de ressource dont la copie stockée a disparu. Static_Prerender_Early_Serve::last_promotion() indique le nombre de routes transférées, remplacées, ignorées ou conservées lors de la dernière installation, afin que le déploiement puisse le consigner.
Un document stocké épingle les ressources de compilation auxquelles il renvoie avec URL, et ces fichiers ont leur propre rétention : l’un peut donc survivre à l’autre. Avant le service, le cache PHP et l’extension drop-in vérifient qu’une feuille de style Tailwind liée et hachée selon son contenu existe toujours sur le disque. Si la feuille de style a disparu, le document est transmis à WordPress au lieu d’être servi sans style ; celle-ci republie ensemble la feuille de style et le document. La même vérification est effectuée avant l’enregistrement d’une réponse : un document qui ne pourrait pas être servi n’est jamais écrit.
Une requête dont l’en-tête Accept contient text/markdown contourne à la fois le stockage PHP et le module complémentaire, car les documents stockés sont HTML et une page peut répondre à cette requête avec sa source Markdown.
Les documents servis envoient donc Vary: Accept. La mise à jour de Blockstudio réécrit un ancien module complémentaire lors de la prochaine écriture de la carte.
Les routes du graphe répertoriées utilisent toujours la ressource activée. Lorsqu’une route anonyme sûre ne figure pas dans cette table, mais que WordPress l’a depuis rendue et enregistrée, Early Serve utilise le magasin d’exécution indexé par identité avant le démarrage de WordPress. Cela prend en charge les routes générées ou de longue traîne situées hors d’un graphe de déploiement volontairement limité. Ce recours utilise l’identité du graphe activé et les mêmes règles de contournement pour l’hôte, la normalisation du chemin, le TTL, les cookies, les en-têtes, les chaînes de requête, les chemins dynamiques et les flux que les routes répertoriées. Il ne trouve que les documents enregistrés par le moteur d’exécution, qui n’incluent jamais les résultats de recherche.
En-têtes de réponse
Un document stocké est rejoué sans la requête qui l’a généré ; tout en-tête envoyé par un thème ou un plugin avec header() serait donc absent de chaque réponse. Blockstudio stocke, avec chaque document, les en-têtes nommés dans replayHeaders et les renvoie depuis le cache PHP ainsi que depuis le drop-in de service anticipé. La valeur par défaut, ["Link"], couvre des en-têtes tels qu’un autre Markdown (rel="alternate"; type="text/markdown"), rel="describedby" ou rel="canonical". Les noms sont comparés sans tenir compte de la casse, et le filtre du paramètre modifie la liste comme toute autre valeur :
add_filter('blockstudio/settings/performance/staticPrerender/replayHeaders', function (array $headers): array {
$headers[] = 'X-Robots-Tag';
return $headers;
});
Définissez replayHeaders sur [] pour désactiver le rejeu des en-têtes. Une liste explicite remplace la liste par défaut ; ajoutez donc Link aux autres noms d’en-tête si vous souhaitez toujours rejouer les en-têtes de lien.
Les en-têtes sont capturés dans le processus qui génère la page : depuis headers_list() lorsqu’une absence du cache en direct est enregistrée, et depuis la requête de préchauffage elle-même lorsqu’une compilation ou le préchauffeur génère la page en passant par HTTP. Ainsi, un en-tête ajouté par le serveur Web lui-même et ajouté à nouveau à chaque document servi n’est jamais stocké. Seuls les en-têtes de sa réponse sont utilisés lorsqu’un rendu HTTP ne produit aucun rapport. Le transport internal les renvoie sous forme de headers dans son résultat, et persist_built_response() les accepte comme dernier argument, soit sous forme de lignes Name: value, soit sous forme de correspondance entre noms et valeurs.
Ils sont écrits dans <key>.headers.json à côté du document, le suivent lors de la promotion des artefacts, du ramassage des fichiers inutilisés et de la purge selon la durée de conservation, et sont supprimés lorsqu’un nouveau rendu n’en envoie aucun. Les en-têtes de cookie, de mise en cache et de transport ne sont jamais stockés ni rejoués, même s’ils figurent dans la liste : Set-Cookie, Cache-Control, Expires, Pragma, Age, ETag, Last-Modified, Vary, Content-Type, Content-Length, Content-Encoding, Transfer-Encoding, Location, Status, Date, ainsi que les en-têtes de transport saut par saut et d’authentification. Un document servi définit ses propres Content-Type et Vary.
Les en-têtes stockés sont de nouveau vérifiés par rapport à la liste au moment de leur envoi. Le cache PHP lit le paramètre actuel ; le drop-in lit la copie dans l’entrée correspondante de la carte du site, que la prochaine installation d’artefact ou synchronisation de la carte actualise. Les documents stockés avant une mise à niveau n’ont pas de fichier d’en-têtes et sont servis exactement comme auparavant jusqu’à ce qu’ils soient générés à nouveau.
Préchauffage, maintenance et observabilité
La file de préchauffage est durable, fusionne les travaux URL, n’exécute qu’un travail à la fois et récupère les tâches dont la réservation a expiré. Les modifications de contenu et de site imposent un travail de remplacement même si la signature actuelle est inchangée ; les passages périodiques ne mettent en file que les travaux obsolètes. Chaque passage, planifié ou lancé via wp bs prerender warm, rend jusqu’à warm.concurrency travaux. Le mode graph désactive le préchauffeur par URL, car les ressources du graphe sont compilées et activées en bloc.
wp bs prerender warm
wp bs prerender status
wp bs prerender purge
wp bs prerender map status
wp bs prerender map prune --dry-run
status indique l’identité active, les fichiers, les octets, les enregistrements du graphe, l’état de la file, le rapport de la table du service anticipé et les compteurs d’accès, d’échecs d’accès, de compilation et d’échec pour chaque espace.
La table du service anticipé est partagée par tous les sites d’une installation. map status (et Static_Prerender_Early_Serve::map_report()) répertorie les entrées que le service anticipé ne peut plus utiliser : les entrées orphaned dont le site n’existe plus et les entrées dead dont le répertoire a disparu, ainsi que le nombre de documents de route missing dans les entrées restantes. map prune (Static_Prerender_Early_Serve::prune_map()) supprime les entrées orphelines et mortes sous verrouillage de la table et indique la raison de chacune ; --dry-run se contente de les répertorier. La suppression de la dernière entrée entraîne celle de la table, de l’extension drop-in et de la déclaration WP_CACHE. La suppression d’un site d’un réseau multisite retire immédiatement ses entrées, et le nettoyage du cache ne supprime jamais l’espace de noms depuis lequel une ressource activée est servie. Les entrées ne deviennent donc inactives que si leurs fichiers sont supprimés par d’autres moyens.
Observez les résultats de chaque réponse avec blockstudio/static_prerender/outcome et tous les résultats du cache partagé avec blockstudio/cache/outcome.
Désinstallation
Les installations sans hook de désactivation d’extension, telles que les configurations fournies avec Composer, peuvent supprimer en une seule commande tout ce qui appartient à la fonctionnalité :
wp bs teardown
Cette commande supprime les événements cron et l’état de prérendu statique géré par l’installation : l’entrée de la table du site actuel, ainsi que l’extension drop-in partagée et la déclaration WP_CACHE une fois la dernière entrée gérée supprimée. Les fichiers de configuration restent intacts, afin que la réactivation de la fonctionnalité démarre proprement.
Adoption en production
Un ordre d’adoption raisonnable :
- Définissez
performance.profilesurspeed, puis vérifiez la sortie de l’en-tête, les flux et tout plugin qui dépend de oEmbed ou de XML-RPC. - Générez
assets/media.json, déplacez les modèles versbs_media_image(), puis activezperformance.media.lazy. - Activez
performance.staticPrerenderen laissantearlyServedésactivé, vérifiez les accès avecwp bs prerender status, puis activezearlyServe.
Le retour en arrière se fait fonctionnalité par fonctionnalité : définir staticPrerender.enabled sur false supprime une fois l’état Early Serve géré par Blockstudio et les tâches planifiées de préchauffage, puis laisse le moteur d’exécution de prérendu non enregistré. Redéfinir performance.profile sur compat annule le profil. Chaque opération laisse les autres couches en place.
Les profils, le profileur et les techniques de rendu sous-jacentes.
L’unique répertoire de cache où résident toutes les ressources générées.