[Contribution Konstantin G.]{class="badge informative" title="Konstantin G."} [PaaS uniquement]{class="badge informative" title="S’applique uniquement aux projets Adobe Commerce on Cloud (infrastructure PaaS gérée par Adobe) et aux projets On-premise."}
Bloc d'ESI vernis
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 attributttl
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);
}