Edge Side Includes edge-side-includes
aemcs-cdn-config-adopter@adobe.com und beschreiben Sie Ihren Anwendungsfall.Die Geschwindigkeit der Inhaltsbereitstellung profitiert vom aggressiven Caching von Seiten, was durch Festlegen von Cache-Headern mit hohen Time-to-Live-Zeit-Werten (TTL) erreicht wird. Dies kann eine Herausforderung darstellen, wenn Seiten dynamische Inhalte enthalten, die häufig aktualisiert werden müssen oder möglicherweise überhaupt nicht zwischengespeichert werden können. Glücklicherweise gibt es Strategien, bei denen die übergeordnete HTML-Seite mit einer hohen TTL zwischengespeichert werden kann, indem der Abruf der dynamischeren Inhaltsausschnitte entweder über Client-seitiges JavaScript oder im CDN auf einen späteren Zeitpunkt verschoben wird. Letzterer Ansatz ist ein Standard mit der Bezeichnung Edge Side Includes (ESI), der für Sites unterstützt wird, die mit AEM-Publishing gerendert werden. Die HTML enthält ESI-Tags, die das CDN anweisen, die Bereitstellung der Seite an den Browser zu verschieben, bis es diese Tags auswertet, wodurch zusätzliche, dynamischere (niedrigere TTL) Inhalte aus der Quelle (oder dem CDN-Cache, wenn die TTL noch nicht abgelaufen ist) abgerufen werden.
Anwendungsfälle, in denen Edge Side Includes nützlich sein kann:
- Anzeigen der Namen von Endbenutzenden oder von anderen Informationen, die für einzelne Endbenutzende eindeutig sind.
- Anzeigen einer Liste aktueller Informationen, z. B. News-Artikel oder Börsenkurse.
ESI-Syntax esi-syntax
Die ESI-Syntax lautet wie folgt, wenn eine übergeordnete Seite /content/page.html ein Snippet content/snippets/mysnippet.html enthält.
<html>
<head>
<title>My Site</title>
</head>
<body>
<div id="content">
<esi:include src="/content/snippets/mysnippet.html" />
</div>
</body>
</html>
Weitere Informationen finden Sie unter ESI-Spezifikationen.
Überlegungen esi-syntax-considerations
- Die folgenden ESI-Tags werden unterstützt: include, comment, remove.
- ESI-Tags werden beim CDN sequenziell und nicht gleichzeitig verarbeitet, sodass viele ESI-Tags auf einer Seite mit niedrigen TTLs Latenz zum Erlebnis von Endbenutzenden hinzufügen können.
- Die maximale Tiefe der „ESI include“-Verarbeitung beträgt 5.
- Die maximale Gesamtanzahl an „ESI include“-Verarbeitungsfragmenten beträgt 256.
Apache-Konfiguration esi-apache
Bei Seiten mit ESI-Tags sollten Sie die folgenden Eigenschaften in der Apache-Konfiguration deklarieren:
<LocationMatch "/parent-pages/*content/page.html">
# disable dispatcher compression
SetEnv no-gzip 1
# enable esi processing
Header set x-aem-esi "on"
# enable edgeCDN compression
Header set x-aem-compress "on"
# typically the main page is cached at the CDN
Header always set Cache-Control "max-age=300"
</LocationMatch>
<LocationMatch "/content/snippets/mysnippet.html">
SetEnv no-gzip 1
# typically the included page is either set to a lower TTL than the parent page, or not cached at all, as these 2 commented declarations show, respectively:
#Header always set Cache-Control "no-cache"
#Header always set Cache-Control "max-age=50"
</LocationMatch>
Die konfigurierten Eigenschaften weisen folgendes Verhalten auf:
Sowohl die übergeordnete Seite als auch die enthaltenen Snippets sollten no-gzip auf 1 setzen.
Diese Einstellung setzt jegliche Komprimierungseinstellung außer Kraft, die Apache entsprechend der
Accept-Encoding-Werte der Anforderung sonst möglicherweise genutzt hätte.no-gzip auf 1 gesetzt), kann dies die Latenz verringern.Wenn diese Kopfzeile nicht festgelegt ist und das CDN unkomprimierte Inhalte aus der Quelle abruft, würden Inhalte auch unkomprimiert für den Client bereitgestellt. Daher muss diese Kopfzeile festgelegt werden, wenn
no-gzip auf 1 gesetzt ist (für ESI erforderlich) und Inhalte bereitgestellt werden sollen, die vom CDN für den Browser komprimiert wurden.Sling Dynamic Include esi-sdi
Sling Dynamic Include (SDI) kann (aber muss nicht) verwendet werden, um ESI-Snippets zu generieren, die im CDN interpretiert werden.