Module aktuell zu halten ist entscheidend für Sicherheit, Stabilität und Kompatibilität Ihres Magento-2-Shops. Diese Schritt-für-Schritt-Anleitung führt Sie sicher durch den Update-Prozess eines Moduls per Composer – von der Vorbereitung bis zur Verifizierung.
Voraussetzungen
Bevor Sie ein Modul aktualisieren, stellen Sie sicher, dass die folgenden Voraussetzungen erfüllt sind:
- Ein vollständiges Backup von Dateien und Datenbank.
- SSH-Zugang zum Server.
- Composer ist installiert und einsatzbereit.
- Der Shop lässt sich in den Wartungsmodus versetzen.
Schritt-für-Schritt-Anleitung
1. Wartungsmodus aktivieren
Versetzen Sie den Shop in den Wartungsmodus, damit während des Updates keine Kunden betroffen sind:
php bin/magento maintenance:enable2. Verfügbare Updates prüfen
Prüfen Sie die aktuell installierte und die verfügbare Version des Moduls:
composer show | grep vendor/module3. Modul aktualisieren
Aktualisieren Sie das Modul inklusive seiner Abhängigkeiten:
composer require vendor/module --update-with-dependencies4. Magento aktualisieren und neu kompilieren
Führen Sie das Setup-Upgrade aus, kompilieren Sie die Dependency Injection neu und deployen Sie die statischen Inhalte:
php bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento setup:static-content:deploy -f5. Wartungsmodus deaktivieren
Nehmen Sie den Shop wieder online:
php bin/magento maintenance:disable6. Aktualisierung verifizieren
Überprüfen Sie abschließend, ob alles wie erwartet funktioniert:
- Frontend und Backend auf Fehler prüfen.
- Logdateien in
var/logundvar/reportauf neue Einträge kontrollieren. - Einen Funktionstest der vom Modul bereitgestellten Features durchführen.
Häufige Probleme
- Composer-Versionskonflikte: Abhängigkeiten lassen sich nicht auflösen – prüfen Sie die Versionsanforderungen anderer Module.
- Berechtigungsfehler: Datei- und Verzeichnisrechte verhindern das Schreiben – korrigieren Sie Eigentümer und Rechte.
- Modul-Kompatibilität: Das Modul ist nicht mit Ihrer Magento-Version kompatibel – prüfen Sie die Kompatibilitätsangaben vor dem Update.
Fazit
Aktualisieren Sie Module regelmäßig und testen Sie jedes Update zunächst in einer Staging-Umgebung, bevor Sie es auf das Produktivsystem übertragen. So vermeiden Sie Ausfallzeiten und stellen einen reibungslosen Betrieb sicher. Benötigen Sie Unterstützung? Kontaktieren Sie uns.