UPGRADE-1.3.md

UPGRADE FROM v1.3.2 TO v1.3.3

• Incorporate the following changes in your application in order to be able to override external configuration files like specified in our documentation.

UPGRADE FROM v1.2.X TO v1.3.0

• MongoDB and PHPCR drivers have been deprecated in ResourceBundle and GridBundle.

• Referring to any file from vendor/sylius/sylius/app directory has been deprecated.

Application

• Run composer config config.platform.php 7.2.4

• Run composer require sylius/sylius:~1.3.0 sylius-labs/sensio-distribution-bundle:^6.0 incenteev/composer-parameter-handler:^2.1 --no-update

• Add the following code in your behat.yml(.dist) file:

  default:
      extensions:
          FriendsOfBehat\SymfonyExtension:
              env_file: ~  
  
  cached:
      extensions:
          FriendsOfBehat\SymfonyExtension:
              env_file: ~

  If you have any of those nodes, don't duplicate them.

• Incorporate changes from the following files into your application:

  • package.json (see diff)
  • .babelrc (see diff)
  • .eslintrc.js (see diff)

• Update PHP and JS dependencies by running composer update and yarn upgrade

• Clear cache by running bin/console cache:clear

• Install assets by bin/console assets:install web and yarn build

Optional

Travis CI

• Remove the build for PHP 7.1.

Behat

• If you want to reuse Sylius contexts, run composer require friends-of-behat/page-object-extension —-dev to add a new development dependency.

Showing products from descendant taxons

• See the Github issue for the details.

• This feature can be enabled by adding the following config to your application:

  sylius_shop:
      product_grid:
        include_all_descendants: true

Directory structure change

Sylius 1.3 uses new directory structure, introduced in Symfony 4. Even though it's not required, we strongly encourage you to follow this convention. Take a look at official Symfony upgrade documentation, to know what exactly should be done.

Remember!

After upgrading the catalog structure, copy public/index.php and bin/console files from Sylius-Standard to make the whole process completed.