Shopware 6

Diese Anleitung beschreibt die Integration von smoxy mit Shopware 6 und setzt eine aktuelle Shopware-6-Version voraus — bei sehr alten Versionen können nicht alle hier beschriebenen Funktionen vollständig unterstützt werden.

INFO

Voraussetzungen: Zuerst die Erste Schritte-Anleitung abschließen. Die Shop-Domain muss über smoxy geroutet werden.

---

Cache-Tagging (Surrogate Keys)

Shopware 6 unterstützt Surrogate Keys für effiziente Cache-Invalidierung. Wenn richtig konfiguriert, teilt Shopware smoxy genau mit, welche gecachten Seiten gelöscht werden müssen, wenn sich Inhalte ändern — anstatt den gesamten Cache zu flushen.

Reverse-Proxy-Modus aktivieren

config/packages/storefront.yaml (Shopware 6.6.0+) oder config/packages/shopware.yaml bearbeiten:

shopware:
    http_cache:
        reverse_proxy:
            enabled: true
            hosts: ["https://smoxy:<token>@example.com"]
            use_varnish_xkey: true

example.com durch die tatsächliche Shop-Domain ersetzen und <token> durch das Cache-Token aus der Grundkonfiguration der Site.

INFO

Hinweis: Der Konfigurationsschlüssel hat sich von storefront.reverse_proxy (bis Shopware 6.5.x) zu shopware.http_cache.reverse_proxy (ab Shopware 6.6.0) geändert. Die Konfiguration beim Upgrade entsprechend anpassen.

INFO

Cloudflare-Nutzer: Beim Einsatz von Cloudflare muss eine separate Subdomain für die Cache-Invalidierung eingerichtet werden. Siehe Cloudflare Setup.

Cache-Hit-Rate optimieren

Cache-Tag-Fragmentierung reduzieren, indem Per-Item-Tags für Config, Snippets und Themes deaktiviert werden:

shopware:
    cache:
        tagging:
            each_config: false
            each_snippet: false
            each_theme_config: false

Das reduziert die Anzahl der Tags pro Seite, was zu weniger unnötigen Cache-Invalidierungen und einer höheren Cache-Hit-Rate führt.

---

Mehrere Sales Channels

Wenn die Shopware-6-Installation mehrere Sales Channels mit verschiedenen Domains verwendet (z. B. länderspezifische Shops), muss nur eine Domain in der Reverse-Proxy-hosts-Einstellung konfiguriert werden. Shopware weiß selbst, welche Caches für welchen Sales Channel geleert werden müssen, und übermittelt diese Information automatisch an smoxy.

WARNING

Wichtig: Alle Sales Channels derselben Shopware-Installation müssen dieselbe smoxy-Site verwenden.