Update von 7.x auf 7.4

Dieses Dokument beschreibt den Update-Vorgang von einer vorherigen Minor-Version der OXID eShop 7 Reihe, 7.x, auf das Minor Release 7.4. Dieses Update kann zusätzliche Schritte beinhalten, da die Möglichkeit besteht, eine von zwei Versionen des vorinstallierten Content & Medien Bundles zu wählen.

Vorbereitung

  1. Überprüfen Sie, dass Sie sich mindestens auf einer 7.x Version älter als 7.4 befinden.

  2. Überprüfen Sie, welche OXID eShop Edition Sie verwenden (Enterprise, Professional oder Community).

  3. Erstellen Sie ein Backup Ihrer Datenbank.

  4. Erstellen Sie ein Backup Ihres Dateisystems.

  5. Entscheiden Sie, welches Content & Medien Bundle Sie nach dem Update verwenden möchten.

    OXID eShop 7.4 hat das neue Content & Medien Bundle 9 vorinstalliert. Dieses beinhaltet die folgenden Erweiterungen:

    • Media Library 4

    • WYSIWYG Editor 6

    • Visual CMS 9 (ausschließlich Enterprise und Professional Edition)

    Die Verwendung des neuen Bundles erfordert eine Migration bestehender Inhalte. Wenn Sie die aktualisierten Erweiterungen nicht verwenden möchten, können Sie Ihr Update vorkonfigurieren, um bei der letzten Major Version des Content & Medien Bundles zu bleiben. Dieses beinhaltet die folgenden Erweiterungen:

    • Media Library 3.0.0

    • WYSIWYG Editor 5.0.1

    • Visual CMS 8.0.2 (ausschließlich Enterprise und Professional Edition)

    Um zu entscheiden, welche Bundle-Version Sie verwenden möchten, lesen Sie bitte unsere Release Notes.

Vorgehen

Abhängig von Ihrer Edition und Ihrer Entscheidung bezüglich des Content & Medien Bundles besteht der Update-Vorgang aus bis zu fünf Schritten:

Schritt 1: Das Content & Medien Bundle vorkonfigurieren

Wenn Sie sich für das neue Content & Medien Bundle 9 entscheiden, können Sie diesen Schritt überspringen und mit Schritt 2: Die Zielversion festlegen fortfahren.

Wenn Sie sich entscheiden, das Content & Medien Bundle 8 zu behalten und eine OXID eShop Enterprise oder Professional Edition verwenden, führen Sie die folgenden drei Befehle aus:

composer require oxid-esales/media-library-module:^3.0 --no-update
composer require ddoe/wysiwyg-editor-module:^5.0 --no-update
composer require ddoe/visualcms-module:^8.0 --no-update

Wenn Sie sich entscheiden, das Content & Medien Bundle 8 zu behalten und eine OXID eShop Community Edition verwenden, führen Sie die folgenden zwei Befehle aus:

composer require oxid-esales/media-library-module:^3.0 --no-update
composer require ddoe/wysiwyg-editor-module:^5.0 --no-update

Schritt 2: Die Zielversion festlegen

Wenn Sie die OXID eShop Enterprise Edition verwenden, führen Sie den folgenden Befehl aus:

composer require oxid-esales/oxideshop-metapackage-ee:v7.4.0 --no-update

Wenn Sie die OXID eShop Professional Edition verwenden, führen Sie den folgenden Befehl aus:

composer require oxid-esales/oxideshop-metapackage-pe:v7.4.0 --no-update

Wenn Sie die OXID eShop Community Edition verwenden, führen Sie den folgenden Befehl aus:

composer require oxid-esales/oxideshop-metapackage-ce:v7.4.0 --no-update

Schritt 3: Den Update-Vorgang ausführen

Führen Sie in jedem Fall die folgenden Befehle aus, um Ihren OXID eShop zu aktualisieren:

composer update --no-plugins --no-scripts --no-dev --with-all-dependencies
composer update --no-dev
./vendor/bin/oe-console oe:cache:clear
./vendor/bin/oe-eshop-db_migrate migrations:migrate
./vendor/bin/oe-eshop-db_views_generate

Schritt 4: Die Rewrite-Bedingungen anpassen

Eine Rewrite-Bedingung in vorherigen OXID eShop Versionen schränkt die Verwendung bestimmter Markennamen ein. Da die .htaccess-Datei typischerweise dem Projekt und seiner Umgebung angepasst wird, ersetzt der OXID eShop sie beim Update nicht. Sie müssen die Datei daher manuell ändern.

  1. Öffnen Sie die Datei source/.htaccess.

  2. Suchen Sie nach der zu ändernden Rewrite-Bedingung:

    RewriteCond %{REQUEST_URI} !(\/admin\/|\/Core\/|\/Application\/|\/export\/|\/modules\/|\/out\/|\/Setup\/|\/tmp\/|\/views\/)

  3. Ersetzen Sie das erste Vorkommnis durch die folgende Bedingung:

    RewriteCond %{REQUEST_URI} !^(\/admin\/|\/Core\/|\/Application\/|\/export\/|\/modules\/|\/out\/|\/Setup\/|\/tmp\/|\/views\/)

  4. Wiederholen Sie dies für die zweite gefundene Stelle.

  5. Speichern Sie die Datei.

Schritt 5: Die Inhalte und Medien migrieren

Wenn Sie sich entschieden haben, das Content & Medien Bundle 8 zu behalten, können Sie diesen Schritt überspringen. Ihr Update ist abgeschlossen.

Wenn Sie sich für das neue Content & Medien Bundle 9 entschieden haben und eine OXID eShop Enterprise oder Professional Edition verwenden, lesen Sie bitte den Abschnitt Update in unserer Content & Medien Bundle-Dokumentation, um Ihr Update abzuschließen.

Wenn Sie sich für das neue Content & Medien Bundle 9 entschieden haben und eine OXID eShop Community Edition verwenden, lesen Sie bitte den Abschnitt Einführung von Medien-IDs in unserer Content & Medien Bundle-Dokumentation, um Ihr Update abzuschließen.