Config Cache: Magento-Konfiguration beim Deploy vorkompilieren¶

User Guide¶

CopeX GmbH
Web: https://copex.io
Email: office@copex.io

Inhaltsverzeichnis / Table of Contents¶

Abschnitt / Section	Seite
1 Was es macht / What it does	3
2 Wann sinnvoll / When to use	3
3 Voraussetzungen / Requirements	4
4 Installation	4
5 Aktivierung / Activation	5
6 Verwendung / Usage	5
7 Was tun bei Problemen / Troubleshooting	7

1 Was es macht¶

Magento liest Konfigurationswerte zur Laufzeit aus einem Cache (Redis oder Datei-Cache) — bei jeder Anfrage, für jeden Scope. Das summiert sich bei stark frequentierten Seiten spürbar.

Config Cache ersetzt diesen Ablauf: Beim Deployment werden alle Konfigurationswerte einmalig aus der Datenbank gelesen und als OPcache-optimierte PHP-Dateien gespeichert. Bei der nächsten Anfrage liefert PHP die Werte direkt aus dem Arbeitsspeicher — kein Cache-Lookup, keine Deserialisierung.

Wenn ein Administrator im Backend eine Konfiguration speichert, wird die betroffene Scope-Datei automatisch neu generiert — kein Deployment notwendig.

2 Wann sinnvoll¶

Shop lädt langsam, obwohl Redis konfiguriert ist
Hohe Redis-Last durch viele Konfigurationsabfragen pro Seite
Deployment-Pipeline soll alle Optimierungen in einem Schritt abschließen
Mehrere Store-Views mit unterschiedlichen Konfigurationen — jede profitiert separat

3 Voraussetzungen¶

Magento 2.4.6 oder höher
PHP 8.1 oder höher (kompatibel mit 8.2, 8.3, 8.4, 8.5)
copex/module-performance-suite (wird automatisch via Composer installiert)
copex/build-compiler (wird automatisch via Composer installiert)
copex/module-core >1.1.0

4 Installation¶

composer require copex/module-build-config
bin/magento module:enable CopeX_BuildConfig
bin/magento setup:upgrade

Alternativ die komplette Suite installieren:

composer require copex/performance-suite-bundle

5 Aktivierung¶

Das Modul wird über app/etc/env.php gesteuert. Folgenden Block einfügen:

'copex' => [
    'build' => [
        'enabled' => true,
        'config_enabled' => true,
    ],
],

Flag	Standard	Beschreibung
`copex/build/enabled`	`false`	Hauptschalter für alle Build-Zeit-Kompilierungen
`copex/build/config_enabled`	`false`	Aktiviert die Konfigurationskompilierung (erfordert Hauptschalter)
`copex/build/generated_path`	`generated/copex/build-config/`	Ausgabeverzeichnis für kompilierte Dateien

Nach dem Setzen der Flags den Build-Befehl ausführen (siehe Abschnitt 6).

6 Verwendung¶

`bin/magento copex:performance:build:config`¶

Liest alle Konfigurationswerte für alle Scopes und schreibt je eine PHP-Datei pro Scope:

bin/magento copex:performance:build:config

Empfohlene Reihenfolge im Deployment:

bin/magento setup:upgrade
bin/magento setup:static-content:deploy
bin/magento copex:performance:build:config
bin/magento cache:flush

Optionen für gezielten Rebuild:

Option	Beschreibung
`--scope=default`	Nur Default-Scope neu kompilieren
`--scope=website:1`	Nur Website mit ID 1
`--scope=store:de`	Nur Store-View mit Code `de`

7 Was tun bei Problemen¶

Kill Switch — sofortiges Deaktivieren:

'copex' => ['build' => ['enabled' => false]]

env.php setzen, Cache leeren. Das Modul fällt sofort auf den nativen Magento-ScopeConfig zurück — kein Deployment, kein Server-Neustart nötig.

Konfigurationswerte nach Admin-Speicherung veraltet: beide Flags auf true prüfen, Schreibrechte auf generated/copex/build-config/ prüfen, dann bin/magento copex:performance:build:config ausführen.

Korrumpierte Datei: betroffene Datei löschen und --scope=store:de gezielt neu kompilieren.

CopeX GmbH — Web: https://copex.io — Email: office@copex.io