Shopware 5 auf Shopware 6 migrieren: Eine vollständige 5-Schritte-Anleitung

Schritt 1: Auditieren Sie Ihren Shopware 5 Shop

Bevor Sie irgendeinen Code anfassen, dokumentieren Sie alles in Ihrer aktuellen Shopware 5 Installation. Dieses Audit bestimmt Ihre Migrationskomplexität und den Zeitplan.

Was muss auditiert werden?

• Benutzerdefinierte Plugins: Listen Sie alle installierten Plugins auf. Prüfen Sie die Shopware 6 Kompatibilität jedes Plugins im Shopware Store oder auf der Website des Anbieters. Markieren Sie kritische Plugins, die neu entwickelt werden müssen.
• Theme-Anpassungen: Dokumentieren Sie alle Template-Overrides, benutzerdefiniertes CSS und JavaScript-Modifikationen. Diese müssen in Shopware 6 manuell neu erstellt werden.
• Drittanbieter-Integrationen: Inventarisieren Sie ERP, PIM, Zahlungsgateways, Versandanbieter und Analytics-Integrationen. Prüfen Sie, ob Integrationspartner Shopware 6 unterstützen.
• Datenmengen: Zählen Sie Produkte, Kategorien, Kunden, Bestellungen und Mediendateien. Große Kataloge (50.000+ Produkte) erfordern spezielle Migrationsstrategien.

Schritt 2: Migrieren Sie Ihre Daten mit dem Migration Assistant

Shopware stellt ein offizielles Migration Assistant Plugin für Shopware 6 bereit, das sich mit Ihrer Shopware 5 API verbindet und Daten automatisch überträgt.

Wie funktioniert der Migration Assistant?

Das Plugin läuft in Shopware 6 und zieht Daten von Ihrem Shopware 5 Shop über die API. Es migriert Produkte, Kategorien, Kunden, Bestellungen und Medien in konfigurierbaren Batches.

Migrationsablauf

1. Migration Assistant installieren in Ihrer Shopware 6 Instanz aus dem Shopware Store (kostenlos).
2. Verbindung konfigurieren zu Shopware 5, indem Sie die Shop-URL und API-Zugangsdaten angeben.
3. Datenprofil abrufen, um zu sehen, welche Entitäten migriert werden und geschätzte Anzahlen.
4. Migration durchführen in Phasen: beginnen Sie mit Produkten und Kategorien, dann Kunden, dann historische Bestellungen.
5. Daten validieren nach jeder Phase durch stichprobenartige Prüfung von Produkten, Kundenkonten und Bestellhistorie.

Schritt 3: Erstellen Sie Ihr Theme neu und portieren Sie Plugins

Shopware 6 verwendet einen völlig anderen Frontend-Technologie-Stack (Twig-Templates, Symfony-Framework, Vue.js-Storefront). Eine direkte Theme-Migration ist nicht möglich.

Theme-Migrationsstrategie

• Beginnen Sie mit Shopware 6 Storefront: Verwenden Sie das Standard-Shopware 6 Storefront-Theme als Basis.
• Erstellen Sie benutzerdefiniertes Styling neu: Portieren Sie Ihre Markenfarben, Schriftarten und Layouts mit der SCSS-Struktur von Shopware 6.
• Erstellen Sie Template-Overrides neu: Konvertieren Sie Smarty-Templates (Shopware 5) zu Twig (Shopware 6).

Was ist mit Plugins?

Shopware 5 Plugins sind nicht kompatibel mit Shopware 6. Für jedes Plugin haben Sie drei Optionen:

• 1. Durch Shopware 6 Äquivalent ersetzen: Prüfen Sie, ob der ursprüngliche Anbieter eine Shopware 6 Version hat oder finden Sie eine Alternative im Shopware Store.
• 2. Von Grund auf neu erstellen: Portieren Sie die Funktionalität auf das Plugin-System von Shopware 6 (erforderlich für benutzerdefinierte/proprietäre Plugins).
• 3. Eliminieren: Bewerten Sie, ob die Funktionalität in Ihrem Shopware 6 Shop noch benötigt wird.

Schritt 4: Testen Sie alles gründlich

Vor dem Go-Live führen Sie umfassende Tests über alle kritischen Geschäftsfunktionen durch. Das Überspringen dieses Schritts führt zu Umsatzverlusten und Kundenfrust.

Was sollte vor dem Launch getestet werden?

Schritt 5: Planen und führen Sie den Go-Live durch

Ein gut geplanter Go-Live minimiert Ausfallzeiten und reduziert Risiken. Starten Sie niemals während verkehrsstarker Zeiten (Wochenenden, Feiertage, Kampagnenstarts).

Pre-Launch Checkliste

• Finale Datensynchronisation: Führen Sie eine finale Migration aktueller Bestellungen und Kundenaktualisierungen durch, bevor Sie DNS umschalten.
• DNS-Umstellung: Aktualisieren Sie die DNS-Einträge Ihrer Domain, um auf den Shopware 6 Server zu zeigen. TTL-Reduzierung hilft bei schnellem Rollback.
• Produktionsmodus: Aktivieren Sie den Shopware 6 Produktionsmodus, deaktivieren Sie Debug-Logs, aktivieren Sie Caching.
• Monitoring: Richten Sie Fehlerprotokollierung, Performance-Monitoring (New Relic, Datadog) und Uptime-Alerts ein.
• Rollback-Plan: Behalten Sie Shopware 5 für 30 Tage als Backup laufend. Dokumentieren Sie exakte Schritte, um DNS bei Bedarf zurückzusetzen.

Technische Go-Live Schritte

1. Shopware-Lizenz übertragen: In Shopware 6, gehen Sie zu Einstellungen > Shopware-Konto und aktualisieren Sie Ihren Lizenz-Host auf Ihre Produktionsdomain.
2. Verkaufskanal-Domains aktualisieren: Konfigurieren Sie die Domain-URL für jeden Verkaufskanal einzeln im Adminbereich.
3. Webserver konfigurieren: Richten Sie Ihren VirtualHost DocumentRoot auf das /public/ Unterverzeichnis in Ihrer Shopware 6 Installation. Dies ist kritisch für Frontend- und Admin-Zugriff.
4. Shopware 5 Installation verschieben: Verschieben Sie Ihren Shopware 5 Shop in ein Unterverzeichnis (z.B. /shop5/) oder eine alternative Domain, damit er nicht mehr die primäre Domain verwendet.
5. Migration abschließen: Nach der Überprüfung, dass alle Daten aktuell sind, schließen Sie die Migration über Einstellungen > Erweiterungen > Migration Assistant > Migration abschließen ab. Dies entfernt migrationsspezifische Datenbankeinträge.