Performance Suite Bundle: Komplette Performance-Optimierung in einem Paket¶

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¶

Performance Suite Bundle ist ein Composer-Meta-Paket — es enthält keinen eigenen Code. Es installiert mit einem einzigen Befehl alle sechs CopeX-Performance-Pakete:

Paket	Zweck
`copex/module-performance-suite`	Kerninfrastruktur, CLI, Kill-Switches
`copex/module-preloaders` (Smart Loaders)	Batch-Vorladen von Produkt- und Warenkorbdaten
`copex/module-build-config` (Config Cache)	Konfiguration beim Deploy vorkompilieren
`copex/module-layout-precompile` (Layout Cache)	Layout-Cache beim Deploy aufwärmen
`copex/build-compiler`	Technische Grundlage für die Kompilierung
`copex/module-performance-tweaks` (Cache Tweaks)	Redis-Layout-Cache durch generische Handles verkleinern

Alle enthaltenen Module können unabhängig voneinander aktiviert und deaktiviert werden.

2 Wann sinnvoll¶

Alle CopeX-Performance-Module sollen auf einmal installiert werden
Ein composer require statt sechs separate Pakete

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-core >1.1.0
CopeX-Paket-Repository in composer.json

4 Installation¶

CopeX-Paket-Repository zur composer.json hinzufügen, falls noch nicht vorhanden:

{
    "repositories": [
        {
            "type": "composer",
            "url": "https://packages.copex.io"
        }
    ]
}

Bundle installieren:

composer require copex/performance-suite-bundle

Alle Magento-Module aktivieren und Setup ausführen:

bin/magento module:enable CopeX_PerformanceSuite CopeX_Preloaders CopeX_BuildConfig CopeX_LayoutPrecompile CopeX_Performance
bin/magento setup:upgrade
bin/magento cache:flush

5 Aktivierung¶

Das Bundle selbst hat keine Konfiguration. Alle Funktionen werden über app/etc/env.php gesteuert:

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

6 Verwendung¶

Nach der Aktivierung die Build-Befehle ausführen, um Konfiguration und Layout-Cache vorzubereiten:

bin/magento copex:performance:build:config
bin/magento copex:performance:build
bin/magento cache:flush

Diese Befehle zum Deployment-Pipeline hinzufügen — nach setup:upgrade und setup:static-content:deploy, vor cache:flush.

Gesundheitscheck nach dem Deployment:

bin/magento copex:performance:recommendations

7 Was tun bei Problemen¶

Kompletter Kill Switch — alle Module sofort deaktivieren:

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

In env.php setzen. Wirkt ab der nächsten Anfrage — kein Cache-Flush, kein Server-Neustart erforderlich. Der Shop läuft sofort wieder wie vor der Installation.

Einzelmodul-Dokumentation: vendor/copex/<paketname>/docs/DE.md für Performance Suite, Smart Loaders, Config Cache, Build Compiler und Cache Tweaks.

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