Shopware 6 Development-Umgebung Schritt für Schritt aktivieren

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.