Shopware 6 Development-Umgebung aktivieren – Schritt für Schritt
Was ist die Development-Umgebung in Shopware 6?
Shopware 6 basiert auf Symfony und kennt zwei Umgebungen: prod (Produktiv) und dev (Development). Standardmäßig läuft jeder Shop im prod-Modus. Die Development-Umgebung aktiviert Debug-Werkzeuge, die bei der Template- und Plugin-Entwicklung unverzichtbar sind.
Was die Dev-Umgebung freischaltet
| Feature | prod | dev |
|---|---|---|
| <code>{{ dump() }}</code> in Twig-Templates | Fehler | Variablen-Ausgabe |
| Symfony Web Profiler (Toolbar) | Aus | Aktiv |
| Detaillierte Fehlermeldungen | Generische 500-Seite | Vollständiger Stacktrace |
| Cache-Verhalten | Aggressives Caching | Kein Template-Cache |
| Twig Debug-Modus | Aus | Aktiv (<code>{% dump %}</code>, Source-Kommentare) |
| Performance | Optimiert | Langsamer (kein Caching) |
So wechselst du zur Development-Umgebung
Schritt 1: .env-Datei öffnen
Verbinde dich per FTP oder SSH mit deinem Server und öffne die Datei .env im Shopware-Stammverzeichnis. Suche diese Zeile:
APP_ENV=prodSchritt 2: Wert ändern
Ändere prod zu dev:
APP_ENV=devSchritt 3: Cache leeren
Der Umgebungswechsel erfordert einen Cache-Clear. Per SSH:
bin/console cache:clearOhne SSH-Zugang: Lösche den Ordner var/cache/ manuell per FTP oder leere den Cache über Einstellungen → System → Caches & Indizes im Admin.
Schritt 4: Testen
Rufe deinen Shop im Browser auf. Du solltest unten am Bildschirmrand die Symfony Debug Toolbar sehen – ein schwarzer Balken mit Performance-Metriken, Datenbankabfragen und Routing-Infos.
Die dump()-Funktion nutzen
In der Dev-Umgebung kannst du in jeder .html.twig-Datei Variablen ausgeben:
{{ dump() }}Das gibt alle verfügbaren Variablen im aktuellen Template-Kontext aus. Für eine spezifische Variable:
{{ dump(page.product) }}Wichtig: Entferne alle dump()-Aufrufe bevor du zurück auf prod wechselst – sie verursachen dort einen Fatal Error.
Zurück zur Produktiv-Umgebung
Wenn du fertig bist, ändere die .env wieder zurück:
APP_ENV=prodUnd leere den Cache erneut:
bin/console cache:clearHäufige Fehler beim Umgebungswechsel
| Problem | Ursache | Lösung |
|---|---|---|
| Shop zeigt nach Wechsel Fehler | Alter Cache aus <code>prod</code>-Modus | <code>var/cache/</code> komplett löschen |
| Debug Toolbar erscheint nicht | Browser-Cache | Hard Refresh (Strg+Shift+R) |
| <code>dump()</code> zeigt nichts an | Falscher Umgebungswert | Prüfe ob <code>.env</code> wirklich <code>APP_ENV=dev</code> enthält (keine Leerzeichen) |
| Shop extrem langsam im Dev-Modus | Normal – kein Caching aktiv | Nur lokal oder auf Staging verwenden, nie auf Live |
| Kunden sehen Fehlermeldungen | Dev-Modus auf Live-Server | Sofort zurück auf <code>prod</code> wechseln |
Sicherheitshinweis
Die Development-Umgebung zeigt sensible Informationen: Datenbankabfragen, Dateipfade, Konfigurationswerte und Stacktraces. Aktiviere den Dev-Modus niemals auf einem öffentlich erreichbaren Live-Shop. Nutze ihn nur auf:
- Lokalen Entwicklungsumgebungen
- Staging-Servern mit Zugriffsschutz (z. B. HTTP Basic Auth oder IP-Whitelist)
Fazit
Der Wechsel zwischen Produktiv- und Development-Umgebung in Shopware 6 ist eine Änderung in einer Zeile der .env-Datei. Die Dev-Umgebung gibt dir Zugriff auf dump(), den Symfony Profiler und detaillierte Fehlermeldungen – unverzichtbar für Template- und Plugin-Entwicklung. Denke daran: nach dem Debugging immer zurück auf prod und Cache leeren. Mehr über unsere Shopware-Leistungen →
Dieser Artikel wurde zuletzt am 30. März 2026 aktualisiert.
