Installation

P2Lab Cache ist ein gewöhnliches Shopware-6-Plugin. Sie installieren es wie jedes andere Plugin — über die Admin-Erweiterungen oder per Composer / CLI.

Voraussetzungen

• Shopware 6.6 (die composer.json des Plugins schränkt shopware/core, shopware/administration und shopware/storefront auf >=6.6 <6.7 ein)
• Laufender Async-Worker (bin/console messenger:consume async) für Cache-Warming
• Eine Backend-Wahl — siehe Storage-Backends — und die passende Infrastruktur (Redis-Service, APCu-Erweiterung oder einfach Speicherplatz für Filesystem)

Installation über das Admin (ZIP-Upload)

1. Laden Sie die Plugin-ZIP (P2LabCache_vX.Y.Z.zip) aus Ihrer Distribution herunter.
2. Im Shopware-Admin gehen Sie zu Erweiterungen → Meine Erweiterungen → Erweiterung hochladen und wählen die ZIP.
3. Nach dem Upload klicken Sie Installieren neben dem Plugin-Eintrag.
4. Klicken Sie Aktivieren.
5. Leeren Sie den Shopware-Cache, damit der neue HTTP-Cache-Decorator aufgenommen wird.

Installation per CLI

Wenn Sie Shell-Zugriff auf den Shopware-Host haben, kopieren Sie das Plugin nach custom/plugins/P2LabCache und führen aus:

bin/console plugin:refresh
bin/console plugin:install --activate P2LabCache
bin/console cache:clear

Installation verifizieren

1. Öffnen Sie den Shopware-Admin.
2. Gehen Sie zu Einstellungen → Erweiterungen → Speed Boost — Sie landen auf dem P2Lab-Cache-Dashboard.
3. Vom Storefront öffnen Sie eine beliebige Produktseite. Beim zweiten Aufruf sollte die Antwort aus dem Cache geliefert werden.

Um einen HIT zu bestätigen, aktivieren Sie vorübergehend Debug-Modus in Einstellungen → Speed Boost → Core und laden die Seite neu. Die Antwort enthält:

• X-P2Lab-Cache-Status: HIT (oder MISS beim ersten Aufruf)
• X-P2Lab-Cache-Generation-Time: <Sekunden>

Wenn die Header fehlen, siehe Troubleshooting.

Update

1. Laden Sie die neue ZIP über Erweiterungen → Meine Erweiterungen → Erweiterung hochladen hoch (überschreibt die existierende Version).
2. Führen Sie Datenbankmigrationen aus, falls Shopware danach fragt.
3. Leeren Sie den Shopware-Cache.

Cache-Einträge älterer Versionen bleiben bei Patch-Updates gültig. Größere Updates können ein vollständiges Cache leeren vom Dashboard erfordern.

Deinstallation

Das Plugin entfernt bei der Deinstallation seine eigenen Datenbanktabellen und system-config-Einträge. Für eine saubere Deinstallation:

bin/console plugin:uninstall P2LabCache
bin/console cache:clear

Oder benutzen Sie Erweiterungen → Meine Erweiterungen → Deinstallieren aus dem Admin.

Weiter: Konfiguration

Das Plugin ist installiert, nutzt aber sichere Defaults, die zu Ihrer Infrastruktur möglicherweise nicht passen. Weiter mit Schnellkonfiguration.