DokumentationCommerceKonfigurationshandbuch

Konfigurieren von Redis für Standard- und Seiten-Cache

Letzte Aktualisierung: 19. Mai 2026

Erstellt für:

  • Experienced
  • Admin
  • Developer

Commerce bietet Befehlszeilenoptionen zum Konfigurieren der Redis-Seite und des Standard-Caching. Obwohl Sie die Zwischenspeicherung durch Bearbeiten der <Commerce-install-dir>app/etc/env.php konfigurieren können, ist die Befehlszeile die empfohlene Methode, insbesondere für anfängliche Konfigurationen. Die Befehlszeile stellt eine Validierung bereit, um sicherzustellen, dass die Konfiguration syntaktisch korrekt ist.

Voraussetzung:

Installieren Sie Redis bevor Sie fortfahren.

NOTE
Bei auf EC2 gehosteten Commerce-Instanzen können Sie AWS ElastiCache anstelle einer lokalen Redis-Instanz verwenden. Siehe Konfigurieren von Elasticache für EC2-Instanzen.

Unterstützte Frameworks

Zend Cache (2.4.8 und früher)

  • Zend Cache (2.4.8 und früher) — Legacy Redis Backend für Commerce 2.4.8 und früher:

    • Legacy Redis Backend - Verwendet den vollständigen Klassenpfad (Magento\Framework\Cache\Backend\Redis)
    • Schlüssel vorladen - Unterstützt das Vorabladen häufig verwendeter Cache-Schlüssel
    • Lua-Skripte - Lua für die Speicherbereinigung
    • Komprimierung - Unterstützt die Datenkomprimierung
Symfony-Cache (2.4.9+)

  • Symfony Cache (2.4.9+) - Ab Commerce 2.4.9 bietet Symfony Cache eine moderne, PSR-6-konforme Caching-Implementierung für Redis mit erheblichen Leistungsverbesserungen:

    • Automatische Redis-: Bündelt mehrere Vorgänge in einzelnen Anfragen und reduziert so die Latenz
    • PSR-6 TagAwareAdapter - Effiziente Tag-basierte Cache-Invalidierung mit atomischen Vorgängen
    • Igbinary-Serialisierung - Die binäre Serialisierung reduziert die Größe des Cache-Eintrags um 45 % und verbessert die Geschwindigkeit um 5-10 %
    • Verbesserte persistente Verbindungen - Stabileres Verbindungspooling mit besserer Handhabung von Gabelprozessen
    • Optimierte Lua-Skripte - Server-seitige Ausführung in Kombination mit Pipelining für maximale Effizienz

Konfigurieren des Redis-Standardcachings

Führen Sie den setup:config:set Befehl aus und geben Sie Parameter an, die spezifisch für das Redis-Standardcaching sind.

bin/magento setup:config:set --cache-backend=redis --cache-backend-redis-<parameter>=<value>...

Mit den folgenden Parametern:

  • --cache-backend=redis aktiviert das Redis-Standard-Caching. Wenn diese Funktion bereits aktiviert ist, lassen Sie diesen Parameter weg.

  • --cache-backend-redis-<parameter>=<value> ist eine Liste von Schlüssel-Wert-Paaren, die das standardmäßige Caching konfigurieren:

Befehlszeilenparameter
Wert
Bedeutung
Standardwert
cache-backend-redis-server
Server
Vollqualifizierter Hostname, IP-Adresse oder ein absoluter Pfad zu einem UNIX-Socket. Der Standardwert 127.0.0.1 bedeutet, dass Redis auf dem Commerce-Server installiert ist.
127.0.0.1
cache-backend-redis-port
Port
Redis-Server-Listener-Port
6379
cache-backend-redis-db
Datenbank
Erforderlich, wenn Sie Redis sowohl für den Standard- als auch für den Vollseiten-Cache verwenden. Geben Sie die Datenbanknummer eines der Caches an; der andere Cache verwendet standardmäßig 0.

Wichtig: Wenn Sie Redis für mehr als einen Caching-Typ verwenden, müssen die Datenbanknummern unterschiedlich sein. Es wird empfohlen, die standardmäßige Caching-Datenbanknummer 0, die Seitencaching-Datenbanknummer 1 und die Sitzungsspeicher-Datenbanknummer 2 zuzuweisen.
0
cache-backend-redis-password
Passwort
Die Konfiguration eines Redis-Kennworts ermöglicht eine der integrierten Sicherheitsfunktionen: den auth-Befehl, für den sich Clients authentifizieren müssen, um auf die Datenbank zuzugreifen. Das Passwort wird direkt in der Redis-Konfigurationsdatei konfiguriert: /etc/redis/redis.conf
cache-backend-redis-use-lua
use_lua
Aktivieren oder Deaktivieren von LUA.

Lua: Lua ermöglicht die Ausführung eines Teils der Anwendungslogik in Redis, verbessert die Leistung und stellt die Datenkonsistenz durch atomare Ausführung sicher.
0
cache-backend-redis-use-lua-on-gc
use_lua_on_gc
Aktivieren oder deaktivieren Sie LUA für die Speicherbereinigung.

Lua: Lua ermöglicht die Ausführung eines Teils der Anwendungslogik in Redis, verbessert die Leistung und stellt die Datenkonsistenz durch atomare Ausführung sicher.
1

Beispielbefehl (Standard-Cache)

Das folgende Beispiel aktiviert die Redis-Standardzwischenspeicherung, legt den Host auf 127.0.0.1 fest und weist die Datenbanknummer auf 0 zu. Redis verwendet Standardwerte für alle anderen Parameter.

bin/magento setup:config:set --cache-backend=redis --cache-backend-redis-server=127.0.0.1 --cache-backend-redis-db=0

Konfigurieren des Redis-Seitencachings

Um das Caching der Redis-Seite in Commerce zu konfigurieren, führen Sie den Befehl setup:config:set mit zusätzlichen Parametern aus.

bin/magento setup:config:set --page-cache=redis --page-cache-redis-<parameter>=<value>...

Mit den folgenden Parametern:

  • --page-cache=redis aktiviert das Caching von Redis-Seiten. Wenn diese Funktion bereits aktiviert ist, lassen Sie diesen Parameter weg.

  • --page-cache-redis-<parameter>=<value> ist eine Liste von Schlüssel-Wert-Paaren, die das Caching von Seiten konfigurieren:

Befehlszeilenparameter
Wert
Bedeutung
Standardwert
page-cache-redis-server
Server
Vollqualifizierter Hostname, IP-Adresse oder ein absoluter Pfad zu einem UNIX-Socket. Der Standardwert 127.0.0.1 bedeutet, dass Redis auf dem Commerce-Server installiert ist.
127.0.0.1
page-cache-redis-port
Port
Redis-Server-Listener-Port
6379
page-cache-redis-db
Datenbank
Erforderlich, wenn Sie Redis sowohl für den Standard- als auch für den vollständigen Seitencache verwenden. Geben Sie die Datenbanknummer eines der Caches an; der andere Cache verwendet standardmäßig 0.
Wichtig: Wenn Sie Redis für mehr als einen Caching-Typ verwenden, müssen die Datenbanknummern unterschiedlich sein. Es wird empfohlen, die standardmäßige Caching-Datenbanknummer 0, die Seitencaching-Datenbanknummer 1 und die Sitzungsspeicher-Datenbanknummer 2 zuzuweisen.
0
page-cache-redis-password
Passwort
Die Konfiguration eines Redis-Kennworts ermöglicht eine der integrierten Sicherheitsfunktionen: den auth-Befehl, für den sich Clients authentifizieren müssen, um auf die Datenbank zuzugreifen. Konfigurieren Sie das Kennwort in der Redis-Konfigurationsdatei: /etc/redis/redis.conf

Das folgende Beispiel aktiviert die Zwischenspeicherung der Redis-Seite, legt den Host auf 127.0.0.1 fest und weist 1 die Datenbanknummer zu. Alle anderen Parameter sind auf den Standardwert eingestellt.

bin/magento setup:config:set --page-cache=redis --page-cache-redis-server=127.0.0.1 --page-cache-redis-db=1
NOTE
Ab Adobe Commerce 2.4.9 ersetzte Valkey offiziell Redis im CLI-Tooling. Verwenden Sie für Versionen 2.4.8 und früher die entsprechenden Redis-CLI-Befehle.

Überprüfen der Commerce-Umgebungskonfiguration

Wenn Sie die Befehle zum Konfigurieren des Redis-Caching ausführen, wird die Commerce-Umgebungskonfiguration (<Commerce-install-dir>app/etc/env.php) aktualisiert:

Zend Cache (2.4.8 und früher)
code language-php 
'cache' => [
    'frontend' => [
        'default' => [
            'backend' => 'Magento\\Framework\\Cache\\Backend\\Redis',
            'backend_options' => [
                'server' => '127.0.0.1',
                'database' => '0',
                'port' => '6379'
            ],
        ],
        'page_cache' => [
            'backend' => 'Magento\\Framework\\Cache\\Backend\\Redis',
            'backend_options' => [
                'server' => '127.0.0.1',
                'port' => '6379',
                'database' => '1',
                'compress_data' => '0'
            ]
        ]
    ]
],
Symfony-Cache (2.4.9+)
code language-php 
'cache' => [
    'frontend' => [
        'default' => [
            'backend' => 'redis',
            'backend_options' => [
                'server' => '127.0.0.1',
                'database' => '0',
                'port' => '6379'
            ],
        ],
        'page_cache' => [
            'backend' => 'redis',
            'backend_options' => [
                'server' => '127.0.0.1',
                'port' => '6379',
                'database' => '1',
                'compress_data' => '0'
            ]
        ]
    ]
],
note
NOTE
Verwenden Sie ab Commerce 2.4.9 den vereinfachten Backend-Typ 'backend' => 'redis' anstelle des vollständigen Klassenpfads. Der Symfony-Cache wird automatisch verwendet, wenn der vereinfachte Name angegeben wird.

Konfigurieren zusätzlicher Caching-Optionen

Vorabladefunktion neu einstellen

Da Commerce Konfigurationsdaten im Redis-Cache speichert, können Sie Daten vorab laden, die zwischen Seiten wiederverwendet werden. Um Schlüssel zu finden, die vorgeladen werden müssen, analysieren Sie Daten, die von Redis an Commerce übertragen werden. Adobe empfiehlt, Daten vorab zu laden, die auf jeder Seite geladen werden, z. B. SYSTEM_DEFAULT, EAV_ENTITY_TYPES und DB_IS_UP_TO_DATE.

Redis verwendet die pipeline zum Zusammensetzen von Ladeanfragen. Schlüssel sollten das Datenbankpräfix enthalten. Wenn das Datenbankpräfix beispielsweise 061_ ist, sieht der Vorabladeschlüssel wie folgt aus: 061_SYSTEM_DEFAULT

Zend Cache
code language-php 
'cache' => [
    'frontend' => [
        'default' => [
            'id_prefix' => '061_',
            'backend' => 'Magento\\Framework\\Cache\\Backend\\Redis',
            'backend_options' => [
                'server' => 'redis',
                'database' => '0',
                'port' => '6379',
                'password' => '',
                'compress_data' => '1',
                'compression_lib' => '',
                'preload_keys' => [
                    '061_EAV_ENTITY_TYPES',
                    '061_GLOBAL_PLUGIN_LIST',
                    '061_DB_IS_UP_TO_DATE',
                    '061_SYSTEM_DEFAULT',
                ],
            ]
        ],
        'page_cache' => [
            'id_prefix' => '061_'
        ]
    ]
]
Symfony-Cache
code language-php 
'cache' => [
    'frontend' => [
        'default' => [
            'id_prefix' => '061_',
            'backend' => 'redis',
            'backend_options' => [
                'server' => 'redis',
                'database' => '0',
                'port' => '6379',
                'password' => '',
                'compress_data' => '1',
                'compression_lib' => '',
                'preload_keys' => [
                    '061_EAV_ENTITY_TYPES',
                    '061_GLOBAL_PLUGIN_LIST',
                    '061_DB_IS_UP_TO_DATE',
                    '061_SYSTEM_DEFAULT',
                ],
            ]
        ],
        'page_cache' => [
            'id_prefix' => '061_'
        ]
    ]
]

Bei Verwendung der Vorabladefunktion mit einem L2-Cache müssen Sie den Schlüsseln das :hash Suffix hinzufügen. Der L2-Cache überträgt nur den Hash der Daten, nicht die tatsächlichen Daten.

'preload_keys' => [
    '061_EAV_ENTITY_TYPES:hash',
    '061_GLOBAL_PLUGIN_LIST:hash',
    '061_DB_IS_UP_TO_DATE:hash',
    '061_SYSTEM_DEFAULT:hash',
],

Parallelerzeugung

Mit der Commerce-Version 2.4.0 führte Adobe die allow_parallel_generation-Option für Benutzende ein, die das Warten auf Sperren verhindern möchten. Sie ist standardmäßig deaktiviert, und Adobe empfiehlt, sie zu deaktivieren, bis Sie übermäßige Konfigurationen und/oder Blockierungen haben.

So aktivieren Sie die parallele Generierung:

bin/magento setup:config:set --allow-parallel-generation

Da es sich um ein Flag handelt, können Sie es nicht mit einem Befehl deaktivieren. Legen Sie den Konfigurationswert manuell auf false fest:

Zend Cache
code language-php 
    'cache' => [
        'frontend' => [
            'default' => [
                'id_prefix' => 'b0b_',
                'backend' => 'Magento\\Framework\\Cache\\Backend\\Redis',
                'backend_options' => [
                    'server' => 'redis',
                    'database' => '0',
                    'port' => '6379',
                    'password' => '',
                    'compress_data' => '1',
                    'compression_lib' => ''
                ]
            ],
            'page_cache' => [
                'id_prefix' => 'b0b_'
            ]
        ],
        'allow_parallel_generation' => false
    ],
Symfony-Cache
code language-php 
    'cache' => [
        'frontend' => [
            'default' => [
                'id_prefix' => 'b0b_',
                'backend' => 'redis',
                'backend_options' => [
                    'server' => 'redis',
                    'database' => '0',
                    'port' => '6379',
                    'serializer' => 'igbinary',
                    'compress_data' => '1',
                    'compression_lib' => 'gzip'
                ]
            ],
            'page_cache' => [
                'id_prefix' => 'b0b_'
            ]
        ],
        'allow_parallel_generation' => false
    ],

Symfony Cache-Leistungsoptimierung

Wenn Sie Symfony Cache verwenden, können Sie die Leistung weiter optimieren, indem Sie den Igbinary-Serializer konfigurieren, die igbinary PHP-Erweiterung und die phpredis-Erweiterung installieren und persistente Verbindungen aktivieren.

Binäres Serialisierungsprogramm

Der Inbinary-Serialisierer bietet erhebliche Leistungsverbesserungen gegenüber der PHP-Standardserialisierung. Sie muss in app/etc/env.php manuell konfiguriert werden:

'cache' => [
    'frontend' => [
        'default' => [
            'backend_options' => [
                'server' => 'redis',
                'database' => '0',
                'port' => '6379',
                'serializer' => 'igbinary',  // Enable Igbinary serialization
            ]
        ],
        'page_cache' => [
            'backend_options' => [
                'server' => 'redis',
                'database' => '1',
                'port' => '6379',
                'serializer' => 'igbinary',  // Enable Igbinary for page cache too
            ]
        ]
    ]
]

Installieren der PHP Igbinary-Erweiterung

Um die inbinäre Serialisierung zu verwenden, müssen Sie die PHP Igbinary-Erweiterung installieren.

Verwenden von apt (empfohlen für Debian/Ubuntu):

sudo apt-get install php-igbinary
sudo systemctl restart php-fpm
php -m | grep igbinary

Verwendung von PECL (alternative Methode):

sudo pecl install igbinary
echo "extension=igbinary.so" | sudo tee /etc/php/8.3/mods-available/igbinary.ini
sudo phpenmod igbinary
sudo systemctl restart php-fpm
php -m | grep igbinary

PHP Redis-Erweiterungen: phpredis vs Predis

Commerce 2.4.9+ enthält einen automatischen Fallback zwischen phpredis (native C-Erweiterung) und Predis (reine PHP-Bibliothek). Installieren Sie phpredis, um eine optimale Leistung zu erzielen:

Verwenden von apt (empfohlen für Debian/Ubuntu):

sudo apt-get install php-redis
sudo systemctl restart php-fpm
php -m | grep redis

Verwendung von PECL (alternative Methode):

sudo pecl install redis
echo "extension=redis.so" | sudo tee /etc/php/8.3/mods-available/redis.ini
sudo phpenmod redis
sudo systemctl restart php-fpm
php -m | grep redis

Leistungsvergleich:

Bedienung
Predis
Phredis
Verbesserung
GET zwischenspeichern
1-5 ms
0,5 - 2 ms
2- bis 3-mal schneller
Cache-SET
2-6 ms
0,8 - 2,5 ms
2- bis 3-mal schneller
Tag-Vorgänge
10-30 ms
3-10 ms
3- bis 4-mal schneller

Persistente Verbindungen

Persistente Verbindungen verwenden vorhandene Redis-Verbindungen anforderungsübergreifend wieder und ermöglichen so 5-15 % schnellere Cache-Vorgänge. Konfigurieren Sie in app/etc/env.php:

'cache' => [
    'frontend' => [
        'default' => [
            'backend_options' => [
                'server' => 'redis',
                'database' => '0',
                'port' => '6379',
                'persistent' => '1',
                'persistent_id' => 'cache_default',
                'timeout' => '2.5',
                'read_timeout' => '2.0',
            ]
        ],
        'page_cache' => [
            'backend_options' => [
                'server' => 'redis',
                'database' => '1',
                'port' => '6379',
                'persistent' => '1',
                'persistent_id' => 'cache_fpc',
            ]
        ]
    ]
]
IMPORTANT
Verwenden Sie einen eindeutigen persistent_id für jeden Cache-Typ, um Verbindungskonflikte zu vermeiden.

Vollständige optimierte Konfiguration

Hier finden Sie eine produktionsbereite Symfony-Konfiguration, die alle Leistungsoptimierungen kombiniert:

'cache' => [
    'frontend' => [
        'default' => [
            'id_prefix' => 'b0b_',
            'backend' => 'redis',
            'backend_options' => [
                'server' => 'redis',
                'database' => '0',
                'port' => '6379',
                'serializer' => 'igbinary',
                'compress_data' => '1',
                'compression_lib' => 'gzip',
                'persistent' => '1',
                'persistent_id' => 'cache_default',
                'timeout' => '2.5',
                'read_timeout' => '2.0',
                'use_lua' => '1',
                'use_lua_on_gc' => '1',
                'preload_keys' => [
                    'b0b_EAV_ENTITY_TYPES',
                    'b0b_GLOBAL_PLUGIN_LIST',
                    'b0b_DB_IS_UP_TO_DATE',
                    'b0b_SYSTEM_DEFAULT',
                ],
            ]
        ],
        'page_cache' => [
            'id_prefix' => 'b0b_',
            'backend' => 'redis',
            'backend_options' => [
                'server' => 'redis',
                'database' => '1',
                'port' => '6379',
                'serializer' => 'igbinary',
                'compress_data' => '0',
                'persistent' => '1',
                'persistent_id' => 'cache_fpc',
            ]
        ]
    ],
    'allow_parallel_generation' => false
]

Überprüfen der Redis-Verbindung

So überprüfen Sie, ob Redis und Commerce ordnungsgemäß zusammenarbeiten:

  1. Melden Sie sich bei dem Server an, auf dem Redis und Commerce ausgeführt werden.
  2. Öffnen Sie ein Terminal.
  3. Überprüfen Sie die Verbindung entweder mithilfe des Befehls redis-cli monitor oder des Befehls redis-cli ping .

Wenn die Befehle erfolgreich sind, wird Redis ausgeführt und kann mit der Commerce-Anwendung kommunizieren. Wenn sie fehlschlagen, gibt es ein Verbindungsproblem zwischen Redis und Commerce, das Sie beheben müssen.

Redis-Monitorbefehl

redis-cli monitor

Beispielhafte Seitenzwischenspeicherungsausgabe:

1476826133.810090 [0 127.0.0.1:52366] "select" "1"
1476826133.816293 [0 127.0.0.1:52367] "select" "0"
1476826133.817461 [0 127.0.0.1:52367] "hget" "zc:k:ea6_GLOBAL__DICONFIG" "d"
1476826133.829666 [0 127.0.0.1:52367] "hget" "zc:k:ea6_DICONFIG049005964B465901F774DB9751971818" "d"
1476826133.837854 [0 127.0.0.1:52367] "hget" "zc:k:ea6_INTERCEPTION" "d"
1476826133.868374 [0 127.0.0.1:52368] "select" "1"
1476826133.869011 [0 127.0.0.1:52369] "select" "0"
1476826133.869601 [0 127.0.0.1:52369] "hget" "zc:k:ea6_DEFAULT_CONFIG_CACHE_DEFAULT__10__235__32__1080MAGENTO2" "d"
1476826133.872317 [0 127.0.0.1:52369] "hget" "zc:k:ea6_INITIAL_CONFIG" "d"
1476826133.879267 [0 127.0.0.1:52369] "hget" "zc:k:ea6_GLOBAL_PRIMARY_PLUGIN_LIST" "d"
...

Wenn beide Befehle erfolgreich sind, wird Redis ordnungsgemäß eingerichtet.

Überprüfen komprimierter Daten

Verwenden Sie das Tool RESP.app, um komprimierte Sitzungsdaten und Seiten-Cache zu überprüfen. Es unterstützt die automatische Dekomprimierung von Commerce 2-Sitzungs- und Seiten-Cache-Daten und zeigt PHP-Sitzungsdaten in menschenlesbarer Form an.

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