Magento 2 Module aktualisieren: Anleitung

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:enable

2. Verfügbare Updates prüfen

Prüfen Sie die aktuell installierte und die verfügbare Version des Moduls:

composer show | grep vendor/module

3. Modul aktualisieren

Aktualisieren Sie das Modul inklusive seiner Abhängigkeiten:

composer require vendor/module --update-with-dependencies

4. 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 -f

5. Wartungsmodus deaktivieren

Nehmen Sie den Shop wieder online:

php bin/magento maintenance:disable

6. Aktualisierung verifizieren

Überprüfen Sie abschließend, ob alles wie erwartet funktioniert:

• Frontend und Backend auf Fehler prüfen.
• Logdateien in var/log und var/report auf 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.