Laravel/Upgrade

From Aimeos documentation

Laravel
Other languages:
English 100%

Minor releases (i.e. 1.x.y or 2016.x.y where "y" is the minor release number) contain bugfixes only and you SHOULD always update to the latest version.

Within a release series (e.g. 1.x or 2016.x) we usually don't make backward incompatible changes of working code. This means you can upgrade within a release series without problems to get the new features. Database changes will be applied by executing the "artisan aimeos:setup" command.

Contrary to stable releases, major releases that start a new release series (once a year in January) will contain incompatible code changes, cleanups and configuration changes. Thus, you need to adapt your application and the custom Aimeos extensions you've written.

More information about past, current and future releases is available on the roadmap page.

Upgrade process

If you want to upgrade from earlier versions, there are five necessary steps to update your Laravel application:

  • Follow the steps in the installation guide
  • Setup authorization for the admin interface
  • Clear all caches
  • Copy the new shop.php configuration file from vendor/aimeos-laravel/src/config/shop.php to config/shop.php in your Laravel configuration directory and adapt it again to your needs
  • Copy the whole folder of the vendor blade view files including the subdirectories from ./vendor/aimeos-laravel/src/views/ to ./resources/views/vendor/shop/

If you've created a custom Aimeos extension, please have a look into the Aimeos Changelog and search for changes that applies to your code. The most important changes are the move to namespaces by following PSR-4 and changing the templates from layouts/**.html to templates/**.php.


<< Previous: Supported versions | Next: Install the Aimeos package >>