Patch-Update installieren

Führen Sie bei Bedarf ein Patch-Update Ihres OXID eShops durch.

Mit den folgenden Schritten aktualisieren Sie die Compilation beispielsweise von einer bestehenden Version 6.4.x auf die Version 6.4.2.

Achtung

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.

Vorgehen

  1. Aktualisieren Sie Composer auf Version 2.2.x.

    Achtung

    Composer 2.3.x wird nicht unterstützt.

    Wenn Sie Composer 2.3.x haben, installieren Sie Composer 2.2.x beispielsweise wie folgt:

    sudo composer selfupdate 2.2.12
    
  2. Wechseln Sie ins Hauptverzeichnis des Shops (in unserem Beispiel /var/www/oxideshop/).

    cd /var/www/oxideshop/
    
  3. Aktualisieren Sie in der Datei composer.json, die sich im Hauptverzeichnis des Shops befindet, die Version des Metapackage.
    Dazu tun Sie Folgendes:

    1. Passen Sie im folgenden Beispielbefehl die Versions-Nummer des Metapackage entsprechend der neuen Shop-Edition an:

      composer require --no-update oxid-esales/oxideshop-metapackage-<Typ der Edition: ce, pe oder ee>:v<Versions-Nummer>
      
    2. Führen Sie den Befehl aus, in unserem Beispiel für das Update einer Community Edition 6.4.1 zu 6.4.2:

      composer require --no-update oxid-esales/oxideshop-metapackage-ce:v6.4.2
      
  4. Aktualisieren Sie die benötigten Bibliotheken.
    Führen Sie dazu den folgenden Composer-Befehl aus.
    Optional: Wenn Sie die entwicklungsbezogenen Dateien nicht brauchen, verwenden Sie den Parameter --no-dev.

    composer update --no-plugins --no-scripts --no-dev
    
  5. Laden Sie die neue Compilation herunter.
    Führen Sie dazu den folgenden Composer-Befehl aus.

    composer update --no-dev
    
  6. Bestätigen Sie für Shop-Dateien, Themes und Module, dass das Update bestehende Dateien überschreibt.

  7. Um sicherzustellen, dass die zwischengespeicherten Elemente keine Inkompatibilitäten enthalten, leeren Sie das Verzeichnis /tmp.

    rm -rf source/tmp/*
    
  8. Migrieren Sie die Datenbank.

    vendor/bin/oe-eshop-db_migrate migrations:migrate
    
  9. 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
    

Resultat

Das Update ist beendet. Wenn Sie den Shop als Administrator öffnen, wird die neue Version rechts oben angezeigt.