Shopware 6 Development-Umgebung aktivieren – Schritt für Schritt
Shopware 6 Development-Umgebung aktivieren mit dump(), Symfony Profiler und Debugging-Tipps. Eine Zeile in der .env reicht. So geht's sicher und schnell.
Was ist die Development-Umgebung in Shopware 6?
Shopware 6 läuft auf Symfony. Zwei Modi stehen zur Verfügung: prod und dev. Jeder Shop startet im prod-Modus. Wechselst du auf dev, bekommst du Debug-Werkzeuge für die Template- und Plugin-Entwicklung.
Was die Dev-Umgebung freischaltet
| Feature | prod | dev |
|---|---|---|
{{ dump() }} 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 ({% dump %}, Source-Kommentare) |
| Performance | Optimiert | Langsamer (kein Caching) |
So wechselst du zur Development-Umgebung
Schritt 1: .env-Datei öffnen
Per FTP oder SSH auf den Server verbinden, dann die .env im Shopware-Stammverzeichnis öffnen. Du suchst diese Zeile:
APP_ENV=prod
Schritt 2: Wert ändern
prod durch dev ersetzen:
APP_ENV=dev
Schritt 3: Cache leeren
Nach dem Umgebungswechsel muss der Cache geleert werden. Per SSH:
bin/console cache:clear
Ohne SSH-Zugang: Den Ordner var/cache/ per FTP löschen oder den Cache über Einstellungen → System → Caches & Indizes im Admin leeren.
Schritt 4: Testen
Shop im Browser aufrufen. Unten am Bildschirmrand sollte jetzt die Symfony Debug Toolbar erscheinen, ein schwarzer Balken mit Performance-Metriken, Datenbankabfragen und Routing-Infos.
Die dump()-Funktion nutzen
Im Dev-Modus kannst du in jeder .html.twig-Datei Variablen ausgeben:
{{ dump() }}
Ohne Parameter zeigt dump() alle Variablen im aktuellen Template-Kontext. Für eine bestimmte Variable:
{{ dump(page.product) }}
Wichtig: Alle dump()-Aufrufe vor dem Wechsel zurück auf prod entfernen. Im Produktivmodus lösen sie einen Fatal Error aus.
Zurück zur Produktiv-Umgebung
Fertig mit Debugging? Die .env wieder zurücksetzen:
APP_ENV=prod
Cache erneut leeren:
bin/console cache:clear
Häufige Fehler beim Umgebungswechsel
| Problem | Ursache | Lösung |
|---|---|---|
| Shop zeigt nach Wechsel Fehler | Alter Cache aus prod-Modus |
var/cache/ komplett löschen |
| Debug Toolbar erscheint nicht | Browser-Cache | Hard Refresh (Strg+Shift+R) |
dump() zeigt nichts an |
Falscher Umgebungswert | Prüfe ob .env wirklich APP_ENV=dev 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 prod wechseln |
Sicherheitshinweis
Der Dev-Modus legt sensible Daten offen: Datenbankabfragen, Dateipfade, Konfigurationswerte, Stacktraces. Niemals auf einem öffentlich erreichbaren Live-Shop aktivieren. Nur nutzen auf:
- Lokalen Entwicklungsumgebungen
- Staging-Servern mit Zugriffsschutz (z. B. HTTP Basic Auth oder IP-Whitelist)
Fazit
Eine Zeile in der .env, Cache leeren, fertig. Schon hast du dump(), den Symfony Profiler und vollständige Fehlermeldungen. Zum Schluss nicht vergessen: zurück auf prod wechseln und Cache leeren.
Dieser Artikel wurde zuletzt am 30. März 2026 aktualisiert.