How to Upgrade
Hyvä Commerce is an 'Early Access' product currently under development.
Early Access means that not all features of Hyvä Commerce are fully completed or released, and many areas are still under heavy development and may change. However, it means you can get your hands on everything currently available and being worked on, with a license. Find out more on our Early Access page.
This document gives a general overview over the Hyvä Commerce upgrade process.
Please be sure to check the version specific upgrade notes.
Metapackage Instructions Only
This upgrade guide applies only to using the Hyvä Commerce Metapackage, and not for manging upgrades of individual modules/packages when installed separately (i.e. not using the metapackage).
The Upgrade Process
- Check version specific upgrade notes here in the docs for the Commerce version you wish to upgrade to. If there are any backward incompatible changes they will be listed there.
- Check the changelog for the new version.
- Upgrade the Hyvä Commerce metapackage (see below).
- Apply required changes from step 2. to files customized in your project where needed.
Upgrading the Hyvä Commerce Metapackage
Upgrading to the latest version
To update the Hyvä Commerce metapackage with all dependencies to the latest version, run the command:
Early Access Upgrades
For some early access updates, the composer update
command will not work if you wish to upgrade to the latest version. This applies to when we bump the minor version number (e.g. 0.1.x
to 0.2.x
), as Composer considers these pre-release updates like major version changes). In this case, the composer require
command should be run instead:
Upgrading to a specific version
To update to a specific version, use the following command, replacing x.y.z
with the desired version.