Configurer le bloc ESI Varnish varnish-esi-block

Dernière mise à jour : 23 juin 2026

Rubriques :
{"id":"dac87252-6066-4d6e-a9d2-f6d84c323de7"}

Créé pour :

{"id":"b5a62a22-46f7-4f0d-b151-3fc640bef588"}
{"id":"c66ffd68-0f65-42bb-aa23-b4020f12e0bd"},{"id":"ff6a42d2-313e-452e-93a6-792e4fad9ff8"}

NOTE

Si votre projet Commerce est déployé sur le cloud, la mise en cache complète des pages utilise Fastly au lieu de Varnish. Les rubriques de cette section s’appliquent uniquement aux installations sur site.

Les inclusions côté Edge (ESI) sont des directives spéciales que vous pouvez utiliser pour inclure des pages web dans d’autres pages web.

Par exemple :

<div>
  <esi:include src="http://domain.com/index.php/page_cache/block/esi/blocks"/>
</div>

Le vernis récupère le contenu de http://domain.com/index.php/page_cache/block/esi/blocks et remplace la balise <esi> par celui-ci.

ESI Commerce et vernis

Le framework Commerce crée une balise ESI lorsque les conditions suivantes sont remplies :

L’application de mise en cache est définie sur Varnish Cache
Un élément de block de mise en page XML est ajouté avec un attribut ttl

Exemple

cms_index_index.xml:

  <referenceContainer name="content">
      <block class="Magento\Framework\View\Element\Template" template="Magento_Paypal::esi.phtml" ttl="30"/>
   </referenceContainer>

Dans l’exemple ci-dessus, l’élément block ajoute le contenu du modèle esi.phtml à une page d’accueil et Varnish le met automatiquement à jour toutes les 30 secondes.

Restrictions

Actuellement, Varnish ne prend pas en charge l’ESI via HTTPS et passe donc automatiquement au HTTP.

Magento\PageCache\Observer\ProcessLayoutRenderElement:

    private function _wrapEsi(
        \Magento\Framework\View\Element\AbstractBlock $block,
        \Magento\Framework\View\Layout $layout
    ) {
    ....
        // Varnish does not support ESI over HTTPS must change to HTTP
        $url = substr($url, 0, 5) === 'https' ? 'http' . substr($url, 5) : $url;
        return sprintf('<esi:include src="%s" />', $url);
    }

recommendation-more-help

commerce-operations-help-configuration