Update from 6.2.x to 6.3.0

This document describes minor updates of OXID eShop. Follow the steps below to upgrade the compilation from an existing version 6.2.x to the version 6.3.0.

Updates should always be installed in a test environment, a copy of your current shop. Backup the shop files and the database before updating. Disable all modules and check whether the shop works in general. After updating, test the shop again by paying special attention to the ordering process as well as payment and shipping methods.

schritt Updating Composer

Update to composer 2.2.x.

Attention

Composer 2.3.x is not supported.

If you have Composer 2.3.x, for example, install Composer 2.2.x as follows:

composer selfupdate 2.2.12

schritt Specifying the target version of the update

In the file composer.json located in the shop’s main directory, the version of the metapackage must be updated.

Example of an update for a Community Edition 6.2.4 to 6.3.0:

composer require --no-update oxid-esales/oxideshop-metapackage-ce:v6.3.0

Hint

The name of the metapackage must be adapted to the used shop edition.

Then you need to adapt some versions in the require-dev section.

composer require --dev --no-update oxid-esales/testing-library:^v8.0.0 oxid-esales/oxideshop-ide-helper:^v4.1.0

Warning

Even if you do not install the dev requirements, Composer verifies their dependencies. Therefore this change is mandatory.

schritt Updating dependencies

Open a shell in the shop’s main directory and execute the following Composer command. This will update all required libraries. Specify the --no-dev parameter if the development-related files are not required.

composer update --no-plugins --no-scripts --no-dev

schritt Obtaining new compilation

The second Composer command executes all scripts to obtain the new compilation. For shop files, themes and modules, you will need to confirm that the update will overwrite the existing files.

composer update --no-dev

schritt Deleting temporary files

To ensure the cached elements do not contain any incompatibilities the /tmp directory needs to be cleared.

rm -rf source/tmp/*

schritt Migrating database

The third and final Composer command will migrate the database if necessary.

vendor/bin/oe-eshop-db_migrate migrations:migrate

schritt Optional: Generating views

Depending on changes and shop edition you might see the maintenance mode in the shop as long as the views are not generated again.

vendor/bin/oe-eshop-db_views_generate

Hint

Usually required when updating an Enterprise Edition.

This completes the updating process.