How to update dependencies

General information

The third-party dependencies should be checked regularly if there is an update available. The easiest way is to subscribe to new releases via the "watch" functionality of GitHub.

While doing the updates, make sure:

• The behaviour stays the same
• To not break things

Major updates of dependencies that introduce new API or remove used API, can only be done in major versions like 5.8 (e.g. doctrine/dbal 3.x)

Special cases

doctrine/orm

Due to "historical reasons", the update of doctrine/orm needs some special attention. Under engine/Library/Doctrine you will find two classes. Those classes are copies from the original ORM library which contain additional overrides, to make Shopware work. So after the update of doctrine/orm, make sure that changes made to the original classes are also put into those overrides.