Minor Update installieren

Aktualisieren Sie die Compilation beispielsweise von einer bestehenden Version 7.0.x auf Version 7.1.x.

Attention

Datenverlust

Um mögliche Datenverluste zu vermeiden, tun Sie Folgendes:

Führen Sie das Update sollte immer erst in einer Testumgebung, einer Kopie Ihres aktuellen Shops, aus.
Gehen Sie beim Update grundsätzlich wie folgt vor:
1. Erstellen Sie vor dem Update eine Sicherung der Shop-Dateien und der Datenbank.
2. Testen Sie nach dem Update den Shop erneut.
  Prüfen Sie insbesondere die Funktionen des Bestellprozesses und die Zahlungs- und Versandarten.

Kompatibilität von Drittanbieter-Modulen sicherstellen

Wenn Sie Module oder Themes von Drittanbietern verwenden, fragen Sie den Drittanbieter, ob diese Themes und Module mit der neuen Version des OXID eShops kompatibel sind.

Hintergrund: Normalerweise enthält ein Minor Update keine breaking changes. Alle Module von Drittanbietern funktionieren nach dem Update wie zuvor.

In Ausnahmefällen können sich Änderungen jedoch so auswirken, dass Module von Drittanbietern nicht mehr funktionieren.

Update ausführen

Aktualisieren Sie Ihren OXID eShop auf die aktuelle Version.

Voraussetzungen

Sie haben OXID eShop 7.0.x.

Vorgehen

Deaktivieren Sie alle Module.
Aktualisieren Sie Composer auf Version 2.7.

Installieren Sie Composer 2.7 beispielsweise wie folgt:
```
composer selfupdate 2.7.1
```
Aktualisieren Sie in der Datei composer.json die Version des Metapackage.
Passen Sie dazu wie im folgenden Beispiel den Namen des Metapackage der gewünschten Shop-Edition an.
Beispiel für ein Update einer Community Edition mit dem Metapackage-Namen 7.1.0:
```
composer require --no-update oxid-esales/oxideshop-metapackage-ce:v7.1.0
```
Aktualisieren Sie die Abhängigkeiten.
Öffnen Sie eine Shell im Hauptverzeichnis des Shops und führen Sie den nachstehenden Composer-Befehl aus.
Dadurch werden alle benötigten Bibliotheken aktualisiert.
Wenn Sie die entwicklungsbezogenen Dateien brauchen, lassen Sie den Parameter --no-dev weg.
```
composer update --no-plugins --no-scripts --no-dev
```
Um die neue Compilation zu beziehen und das Update auszuführen, führen Sie die Skripte aus.
Führen Sie dazu den folgenden Befehl aus.
Note

Durch das Update werden mögliche Änderungen überschrieben, die Sie im Verzeichnis source an Modulen oder Themes vorgenommen haben.

Hintergrund: Bei einem Shop-Update lädt Composer die neuen Daten zunächst ins Verzeichnis vendor. Anschließend werden die Daten ins Verzeichnis source kopiert. Damit werden die Dateien des Shops, der Module und der Themes ersetzt.

Ihre individuellen Anpassungen des OXID Shops oder Änderungen an Modulen von Fremdherstellern sind nur dann vorm Überschreiben durch das Update sicher, wenn Sie die Änderungen durch eine der Erweiterungsmöglichkeiten des OXID eShops (Component, Modul, Child-Theme) vorgenommen haben.

Weitere Informationen finden Sie in der Entwickler-Dokumentation unter
- Module skeleton: metadata, composer, and structure
- How to create a theme installable via composer?
Attention

Abfragen bestätigen

Während des Updates werden Sie gefragt, welche Pakete überschrieben werden dürfen.

Damit nur kompatible und getestete Pakete installiert werden und es nicht zu Inkonsistenzen und Fehlfunktionen durch fehlerhaft implementierte Module oder Themes kommen kann, müssen Sie die Abfragen mit Ja bestätigen.

Empfehlungen:
- Wenn Sie die Erweiterungsmöglichkeiten des OXID eShops nutzen, folgen Sie den Anweisungen in der Entwickler-Dokumentation.
- Holen Sie zum Erstellen von Modulen oder Child-Themes die Unterstützung einer OXID-Partner-Agentur ein. Dies erleichtert Ihnen alle künftigen Updates.
  Eine Liste der von OXID zertifizierten Partneragenturen finden Sie unter oxid-esales.com/partner/partner-finden/.
- Wenn Sie Module oder Themes von Drittanbietern verwenden, fragen Sie den Drittanbieter, ob diese Themes und Module mit der neuen Version des OXID eShops kompatibel sind.
  Hintergrund: Normalerweise enthält ein Minor Update keine breaking changes. Alle Module von Drittanbietern funktionieren nach dem Update wie zuvor.
  In Ausnahmefällen können sich Änderungen jedoch so auswirken, dass Module von Drittanbietern nicht mehr funktionieren.
```
composer update --no-dev
```
Um sicherzustellen, dass die zwischengespeicherten Elemente keine Inkompatibilitäten enthalten, leeren Sie das Verzeichnis tmp.
Führen Sie dazu den folgenden Befehl aus.
```
rm -rf source/tmp/*
```
Migrieren Sie die Datenbank.
Führen Sie dazu den folgenden Befehl aus.
```
vendor/bin/oe-eshop-db_migrate migrations:migrate
```
Generieren Sie die Datenbank-Views neu.
Hintergrund: Je nach Änderungen und Shop-Edition kann es sein, dass der Shop nach dem Update in den Wartungsmodus geht.
Um dem vorzubeugen, generieren Sie die Datenbank-Views mit folgendem Befehl neu:
```
vendor/bin/oe-eshop-db_views_generate
```
Aktivieren Sie alle Module.