--- url: 'https://www.wpconsults.com/fr/litespeed-cache-esi-settings-explained/' language: 'fr' title: 'Explication des paramètres de LiteSpeed Cache ESI' author: name: 'Abdullah Nouman' url: 'https://www.wpconsults.com/fr/author/nouman/' date: '2024-12-06T22:28:50-06:00' modified: '2026-07-18T22:17:06-05:00' type: 'post' categories: - 'Technical SEO' image: 'https://www.wpconsults.com/wp-content/uploads/2026/06/wpc-img-7272-YKiLJh.avif' published: true --- # Explication des paramètres de LiteSpeed Cache ESI Edge Side Includes (ESI) est la fonctionnalité de LiteSpeed Cache qui vous permet de “ percer des trous ” dans une page mise en cache accessible au public, afin que les éléments personnalisés (barre d'administration, message d'accueil pour les utilisateurs connectés, panier, formulaire de connexion) restent dynamiques tandis que le reste de la page continue d'être servi à partir du cache. C’est ainsi qu’un visiteur connecté peut se voir proposer une page mise en cache. Je vais vous expliquer ci-dessous le fonctionnement réel de chaque paramètre ESI, la condition préalable que la plupart des guides négligent (ESI nécessite un produit LiteSpeed commercial ; la version gratuite OpenLiteSpeed ne permet pas de l'utiliser), ainsi que mon avis sincère sur les cas où il vaut la peine d'activer ESI et ceux où cela ne fait qu'ajouter de la complexité. ### Principaux enseignements - ESI “ perce des trous ” dans une page mise en cache et les remplit en fonction de chaque visiteur, ce qui permet aux utilisateurs connectés de continuer à bénéficier du contenu issu du cache plutôt que de le contourner. - **ESI nécessite LiteSpeed Web Server Enterprise, LiteSpeed Web ADC ou le CDN QUIC.cloud. La version gratuite d'OpenLiteSpeed ne prend pas en charge ESI.**, et le plugin seul, sur Apache ou Nginx, ne suffira pas non plus. - **Activer ESI** Il s'agit du commutateur principal ; la barre d'administration du cache et le formulaire de commentaire du cache transforment ces deux blocs dynamiques courants en fragments ESI. - Les nonces ESI permettent de maintenir la validité des jetons de sécurité au sein des pages mises en cache ; le groupe « Vary » fournit différentes versions du cache en fonction des rôles des utilisateurs. - L'ESI est particulièrement utile sur les sites comptant de nombreux utilisateurs connectés (abonnements, comptes WooCommerce, forums) ; sur un simple blog, elle entraîne généralement plus de problèmes de débogage qu'elle n'apporte d'avantages. Table des matières - Ce que fait réellement ESI - Pourquoi l'ESI est importante, et dans quels cas elle ne l'est pas - Quels serveurs prennent en charge LiteSpeed ESI (OpenLiteSpeed ne le prend pas en charge) ? - Présentation des paramètres ESI de LiteSpeed Cache - Transformer un shortcode en bloc ESI - Alors, faut-il activer l'ESI ? - Journal des mises à jour ## Ce que fait réellement ESI En règle générale, la mise en cache de pages entières et le contenu personnalisé sont incompatibles : dès qu’une page affiche un élément spécifique à l’utilisateur, comme “ Bonjour, Abdullah ” ou un lien de modification, il n’est plus possible de proposer en toute sécurité une seule copie mise en cache à tous les visiteurs. L'ESI résout ce problème en découpant la page en plusieurs parties. Le corps statique est mis en cache et réutilisé pour tous les visiteurs, tandis que les éléments personnalisés sont marqués comme des fragments distincts et assemblés à la volée. LiteSpeed utilise pour cela l'expression suivante : **perforer** Dans la page mise en cache : le serveur fournit la copie mise en cache, plus rapide, mais laisse de petits « trous » à l’emplacement du contenu dynamique, qu’il remplit ensuite à chaque requête. Ces « trous » correspondent aux éléments qui ne peuvent pas être partagés entre les visiteurs, comme la barre d’administration, un panier d’achat, un formulaire de connexion ou un jeton de sécurité. Ce concept n'est pas une invention de LiteSpeed. Il s'agit d'une norme Web ancienne décrite dans le [Spécification ESI du W3C](https://www.w3.org/TR/esi-lang/); LiteSpeed offre simplement à WordPress un moyen simple de l'utiliser. ## Pourquoi l'ESI est importante, et dans quels cas elle ne l'est pas Le véritable avantage réside dans les performances pour les utilisateurs connectés. Dans la plupart des configurations de mise en cache, les visiteurs connectés contournent complètement le cache et sollicitent PHP et la base de données à chaque page, ce qui correspond exactement au parcours lent que vous cherchiez à éviter. Grâce à ESI, ces utilisateurs continuent de bénéficier de la page mise en cache, seuls leurs fragments personnels étant recalculés à la volée. Ainsi, un site d'adhésion ou une boutique en ligne dont les clients sont connectés semble beaucoup plus réactif, tandis que le serveur a beaucoup moins de travail à fournir. Cela dit, je tiens à rester objectif, car ESI n'est pas une mise à jour gratuite pour tous les sites. Cela ajoute des éléments complexes : davantage de fragments à invalider, davantage de cas particuliers où un plugin affiche un résultat inattendu, et davantage de temps passé à déboguer un bloc obsolète. Si votre site est un site vitrine ou un blog où presque tous les visiteurs sont des utilisateurs non connectés, la mise en cache simple en pleine page suffit déjà à leur fournir le contenu instantanément, et l’ESI n’apporte que très peu de valeur ajoutée. Elle prend tout son sens lorsqu’une part significative de votre trafic est constituée d’utilisateurs connectés, ce qui explique également pourquoi elle est évoquée dans les discussions sérieuses sur la scalabilité, par exemple lorsqu’il s’agit de déterminer si [WordPress peut gérer plus d'un million de visiteurs](https://www.wpconsults.com/fr/un-site-wordpress-peut-il-gerer-1-million-de-visiteurs/). ## Quels serveurs prennent en charge LiteSpeed ESI (OpenLiteSpeed ne le prend pas en charge) ? ESI nécessite un produit LiteSpeed commercial : **LiteSpeed Web Server Enterprise, LiteSpeed Web ADC ou QUIC.cloud CDN**. Le gratuit **OpenLiteSpeed ne prend absolument pas en charge l'ESI**, tout comme le plugin fonctionnant sur Apache ou Nginx « à l'état brut ». C'est la condition préalable que la plupart des tutoriels négligent, et je me suis moi-même trompé sur cette page jusqu'à ce que je consulte correctement la documentation. Cela provient directement de LiteSpeed lui-même [Documentation sur LiteSpeed Cache](https://docs.litespeedtech.com/lscache/lscwp/cache/), qui l'énonce clairement : > “ OpenLiteSpeed ne prend pas en charge la fonctionnalité ESI. Vous devrez disposer de LiteSpeed Web Server Enterprise, de LiteSpeed Web ADC ou du CDN QUIC.cloud pour pouvoir utiliser l'ESI et l'une des fonctionnalités de cet onglet. ” La raison est d'ordre architectural, et non une mesquinerie commerciale. L'ESI est assemblé par le *serveur web*, et non par PHP ; le serveur doit donc lui-même comprendre les balises ESI et assembler les fragments. OpenLiteSpeed ne dispose tout simplement pas de ce moteur. Avant de modifier le moindre de ces paramètres, vérifiez donc quel serveur utilise réellement votre hébergeur. Si vous utilisez OpenLiteSpeed, l’onglet « ESI » apparaîtra comme disponible dans le plugin, mais ne fera en réalité rien pour vous — et c’est exactement le genre de situation qui peut vous faire perdre un après-midi. QUIC.cloud est la solution de secours qu’il faut connaître : il peut gérer l’ESI en périphérie, ce qui permet à un site fonctionnant sous OpenLiteSpeed d’y accéder en passant par ce service. Si la vitesse est un critère essentiel dans le choix d'un hébergeur, voici ma sélection de [fournisseurs d'hébergement WordPress rapides](https://www.wpconsults.com/fr/fournisseurs-dhebergement-wordpress-rapides-2/) va plus loin, et une option LiteSpeed fiable que je recommande souvent est [Hostinger](https://www.wpconsults.com/fr/shared-hosting-hostinger/). [![Hostinger Hébergement Web](https://wpconsults.com/wp-content/uploads/2023/10/728x90.png)](https://www.wpconsults.com/fr/shared-hosting-hostinger/) ## Présentation des paramètres ESI de LiteSpeed Cache Vous les trouverez sous **LiteSpeed Cache > Cache > ESI**. Le panneau est petit, mais chaque bouton a une fonction bien définie. ![Page des paramètres ESI de LiteSpeed Cache dans WordPress, avec le bouton bascule « Activer l'ESI »](https://www.wpconsults.com/wp-content/uploads/2024/12/image-4-1024x706.avif) **Activer ESI** Il s'agit de l'interrupteur principal. Lorsqu'il est désactivé, aucune des autres options ne s'applique. Activez-le et LiteSpeed pourra commencer à mettre en cache les pages publiques pour les utilisateurs connectés en traitant les éléments personnels comme des fragments distincts, ce qui est justement l'intérêt de cette fonctionnalité. **Barre d'administration du cache** transforme la barre d'outils WordPress visible par les utilisateurs connectés en un bloc ESI distinct. Sans cela, cette barre obligerait la page à se charger dynamiquement à chaque fois ; en tant que fragment, le reste de la page reste en cache et seule la barre est gérée séparément. **Cache du formulaire de commentaire** Il en va de même pour le formulaire de commentaires, qui contient un jeton de sécurité propre à chaque utilisateur ; cela permet au formulaire de continuer à fonctionner sans que la page entière doive être récupérée depuis le cache. ### Nonces ESI Un « nonce » est un jeton de sécurité à durée de vie limitée que WordPress utilise pour s'assurer qu'un formulaire ou une action provient bien de votre site. Le problème est qu'une page mise en cache afficherait à tous les visiteurs un nonce obsolète et périmé, ce qui empêcherait l'action de s'exécuter. Le **Nonces ESI** La solution suivante résout ce problème : vous indiquez les noms des nonces (un par ligne, par exemple `stats_nonce` ou `subscribe_nonce`), et LiteSpeed renvoie chacun d'entre eux sous forme de fragment distinct, ce qui permet au jeton de rester valide au sein d'une page qui, par ailleurs, est mise en cache. Vous pouvez ajouter `privé` en lui attribuant un nom aléatoire pour le mettre en cache par utilisateur ; vous pouvez utiliser un caractère générique tel que `nonce_formid_*` pour faire correspondre toute une famille de nonces en une seule fois. La plupart des utilisateurs n'ont jamais besoin d'y toucher, sauf si l'action sécurisée d'un plugin spécifique présente un dysfonctionnement en raison de la mise en cache. ![Paramètres « Nonces » et « Vary Group » de LiteSpeed Cache ESI](https://www.wpconsults.com/wp-content/uploads/2024/12/image-5-1024x449.avif) ### Groupe Vary **Groupe Vary** détermine le nombre de versions distinctes du cache que vous conservez par rôle d'utilisateur. Chaque rôle se voit attribuer un identifiant de groupe : attribuez à chaque rôle un numéro unique, par exemple **99** pour l'administrateur, et ce rôle dispose de sa propre version mise en cache avec ses éléments spécifiques à l'administration, tandis que les rôles restants à **0** partager le cache public par défaut. L'objectif est d'empêcher la « contamination du cache », c'est-à-dire qu'un rôle puisse accidentellement accéder à la vue mise en cache d'un autre rôle. En pratique, on sépare généralement les administrateurs ou les éditeurs du reste des utilisateurs ; diviser chaque rôle en un groupe distinct multiplie le nombre de copies du cache sans apporter grand-chose, il vaut donc mieux limiter le nombre de groupes. ## Transformer un shortcode en bloc ESI Outre les boutons bascules, vous pouvez vous-même marquer n'importe quel élément de sortie comme dynamique. Si un shortcode affiche du contenu spécifique à chaque utilisateur, faites-le précéder de `esi` LiteSpeed le traite donc comme un fragment : ``` [esi shortcodeA attr1="val1" attr2="val2"] ``` Cela indique à LiteSpeed de mettre la page en cache, mais de recalculer ce shortcode à chaque fois. Pour les développeurs, le site officiel [Documentation sur LiteSpeed Cache](https://docs.litespeedtech.com/lscache/lscwp/cache/) explique comment enregistrer des blocs ESI personnalisés dans le code, ce qui constitue la véritable source de flexibilité. ## Alors, faut-il activer l'ESI ? À mon avis, activez l'ESI si une part importante de vos visiteurs se connecte, qu'il s'agisse d'un site d'adhésion, d'une communauté ou d'une boutique WooCommerce où les clients naviguent après s'être connectés, car c'est dans ces cas-là que la mise en cache pour les utilisateurs connectés transforme une expérience lente en une expérience rapide et allège considérablement la charge du serveur. Commencez par activer uniquement « Enable ESI », « Cache Admin Bar » et « Cache Comment Form », vérifiez que les zones personnalisées fonctionnent toujours correctement, et n’utilisez les options « Nonces » ou « Vary Group » que lorsqu’un plugin spécifique en a besoin. Si votre site accueille principalement des visiteurs occasionnels, je ne m’en préoccuperais pas ; la mise en cache simple en pleine page suffit déjà à leur fournir le contenu instantanément, et l’ESI ne ferait qu’ajouter des éléments à déboguer. Et avant toute chose, vérifiez le serveur : sur OpenLiteSpeed, tout cet onglet n’est que de la poudre aux yeux. Considérez l’ESI comme un levier parmi d’autres, aux côtés des éléments de base qui font réellement fonctionner votre [Core Web Vitals](https://www.wpconsults.com/fr/comment-passer-les-epreuves-vitales-de-la-toile-de-fond-2/). Utilisée à bon escient, c'est une excellente solution ; utilisée partout par réflexe, ce n'est qu'une source de complexité. ## Journal des mises à jour **12 juillet 2026** - Correction : cet article indiquait auparavant qu'ESI fonctionnait sur OpenLiteSpeed. Ce n'est pas le cas. La documentation officielle de LiteSpeed précise qu’ESI nécessite LiteSpeed Web Server Enterprise, LiteSpeed Web ADC ou le CDN QUIC.cloud, et n’est pas pris en charge sur OpenLiteSpeed. Les exigences relatives au serveur sont désormais indiquées correctement et citées à partir de la source, et QUIC.cloud est mentionné comme la solution qu’un site OpenLiteSpeed peut effectivement utiliser. **27 juin 2026** - Réécriture du texte afin de préciser clairement la condition préalable relative au serveur LiteSpeed, d'apporter une explication plus claire de chaque paramètre et de donner un avis honnête sur les cas où il vaut la peine d'activer l'ESI et ceux où cela ne fait qu'ajouter de la complexité.