DokumentationCommerceKonfigurationshandbuch

[On-Premises]{class="badge informative" title="Gilt nur für Adobe Commerce On-Premise-Projekte."}

Cache-Backend-Optionen und Speicherreferenz

Letzte Aktualisierung: 16. September 2026

Erstellt für:

  • Fortgeschritten
  • Admin
  • Entwicklerin/Entwickler
NOTE
Auf dieser Seite wird die Konfiguration der On-Premise-app/etc/env.php dokumentiert.
Bei Adobe Commerce on Cloud Projekten generiert das ece-tools-Paket die resultierende app/etc/env.php während der Bereitstellung basierend auf der Konfiguration der Bereitstellungsvariablen in .magento.env.yaml. Die env.php-Datei wird nicht bearbeitet. Siehe Best Practices für die Konfiguration von Valkey und Redis Service und Variablen bereitstellen.

Die Commerce-Anwendung verwendet ein Cache-Frontend und ein Backend auf niedriger Ebene, um Zugriff auf den Cache-Speicher zu gewähren. Commerce unterstützt verschiedene Caching-Backends und -Strategien, die jeweils für verschiedene Anwendungsfälle geeignet sind. Auf dieser Seite werden die verfügbaren Backends und deren Unterschiede beschrieben.

NOTE
Varnish behandelt das Caching ganzer Seiten auf HTTP-Ebene für lokale Bereitstellungen. Der Fastly-Service übernimmt dies für Cloud-Bereitstellungen. Keine der Lösungen verwendet das Cache-Backend auf niedriger Ebene.

Backend-Cache-Optionen

In der folgenden Tabelle sind die verfügbaren Backend-Caches zusammengefasst:

Backend
Beschreibung
Konfigurationshandbuch
Dateisystem
Standard. Speichert Cache-Daten in Dateien unter var/cache/. Keine Konfiguration erforderlich.
Nicht zutreffend
Redis
In-Memory-Datenspeicher für leistungsstarkes Caching.
Redis für Standard-Cache verwenden
Tal
Open-Source, Redis-kompatible Alternative.
Valkey für Standardcache verwenden
Datenbank
Benutzerdefinierte Cache-Engine, die von einer Datenbank unterstützt wird
Erstellen benutzerdefinierter Cache-Engines (Dokumentation zu Adobe Developer)
IMPORTANT
Redis-Cache wird für Adobe Commerce 2.4.9 oder Patch-Versionen nach 2.4.5-p16, 2.4.6-p14, 2.4.7-p9 und 2.4.8-p4 nicht unterstützt. Wenn Sie ein Upgrade auf eine dieser Versionen durchführen, konfigurieren Sie Valley und aktualisieren Sie die Cache-Konfiguration, um es zu verwenden. Adobe Commerce on-premises finden Sie unter Einrichten von Valkey.

Cache-Backend- und L2-Implementierungen implementation-approaches

Commerce unterstützt direkte Cache-Backends und L2-Caching. Ein direktes Backend wählt Cache-Speicher aus. L2-Caching fügt eine lokale Cache-Ebene vor dem Remote-Speicher hinzu.

Direkte Cache-Backends

In der folgenden Tabelle sind die Cache-Backend-Konfigurationswerte für <Commerce-install-dir>/app/etc/env.php zusammengefasst. L2-Caching ist nicht aktiviert.

Commerce-Version
Backend
Konfigurationswert
2.4.8 und früher, sofern unterstützt
Datei
Standard. Keine Konfiguration erforderlich
2.4.8 und früher, sofern unterstützt
Redis
Magento\Framework\Cache\Backend\Redis
2.4.8 und früher, sofern unterstützt
Tal
Magento\Framework\Cache\Backend\Valkey
2.4.9 und höher sowie unterstützte Backports
Datei
file
2.4.9 und höher sowie unterstützte Backports
Tal
valkey

Informationen zur Unterstützung auf Patch-Ebene finden Sie unter Systemanforderungen.

[!TAB Zend-basierter Cache (2.4.8 und früher)]

Backend-Beispiele

Bei On-Premise-Bereitstellungen konfigurieren die folgenden Beispiele direkte Cache-Backends in <Commerce-install-dir>/app/etc/env.php. Sie ermöglichen kein L2-Caching. Verwenden Sie diese Beispiele nicht für Adobe Commerce on Cloud Bereitstellungen, die das ece-tools-Paket verwenden, um die resultierende app/etc/env.php während der Bereitstellung zu generieren.

Redis

Verwenden Sie den vollständigen Redis-Klassennamen nur für Versionen, in denen Redis unterstützt wird:

code language-php?start_inline=1 
'cache' => [
    'frontend' => [
        'default' => [
            'backend' => 'Magento\\Framework\\Cache\\Backend\\Redis',
            'backend_options' => [
                'server' => '127.0.0.1',
                'database' => '0',
                'port' => '6379',
            ],
        ],
    ],
],
Valkey
code language-php?start_inline=1 
'cache' => [
    'frontend' => [
        'default' => [
            'backend' => 'valkey',
            'backend_options' => [
                'server' => '127.0.0.1',
                'database' => '0',
                'port' => '6379',
            ],
        ],
    ],
],

L2-Caching

L2-Caching (auf zwei Ebenen) fügt eine lokale Cache-Ebene auf jedem Web-Knoten vor dem gemeinsam genutzten Remote-Cache-Speicher hinzu, wodurch der Netzwerk-Traffic zwischen Commerce und dem Remote-Cache reduziert wird. Implementierungsoptionen, Versionsunterstützung und Konfigurationsschritte finden Sie unter L2-Cache-Konfiguration.

Konfigurieren Sie für Cloud-Projekte das L2-Caching mithilfe der Bereitstellungsvariablen, die unter "​ bereitstellen“ beschrieben ​.

recommendation-more-help
commerce-operations-help-configuration