Skip to content

UPGRADE-1.4.md

Latest commit

 

History

History
80 lines (56 loc) · 4.33 KB

UPGRADE-1.4.md

File metadata and controls

80 lines (56 loc) · 4.33 KB

UPGRADE FROM v1.3.X TO v1.4.0

The first step is upgrading Sylius with Composer

  • composer require sylius/sylius:~1.4.0

Doctrine migrations

  • Change base AbstractMigration namespace to Doctrine\Migrations\AbstractMigration
  • Add : void return types to both up and down functions
  • Copy this and this migration to your migrations folder or run doctrine:migrations:diff to generate new migration with changes from Sylius

Dotenv

  • composer require symfony/dotenv:^4.2 --dev --no-update
  • Follow Symfony dotenv update guide to incorporate required changes in .env files structure. Optionally, you can take a look at corresponding PR introducing these changes in Sylius-Standard

At the apply migrations with bin/console doctrine:migrations:migrate.

Don't forget to clear the cache (bin/console cache:clear) to be 100% everything is loaded properly.

Behat

If you're using Behat and want to be up-to-date with our configuration, introduce following changes (you can also take a look at SymfonyExtension UPGRADE file) for more details:

  • Update required extensions with composer require friends-of-behat/symfony-extension:^2.0 friends-of-behat/page-object-extension:^0.3 --dev
  • Remove extensions that are not needed with composer remove friends-of-behat/context-service-extension friends-of-behat/cross-container-extension friends-of-behat/service-container-extension --dev
  • Update your behat.yml - look at the diff here
  • Add FriendsOfBehat\SymfonyExtension\Bundle\FriendsOfBehatSymfonyExtensionBundle::class => ['test' => true, 'test_cached' => true], to your bundles.php
  • Create config/services_test.yaml file with the following code and add these your own Behat services as well: 
    imports:
    - { resource: "../vendor/sylius/sylius/src/Sylius/Behat/Resources/config/services.xml" }
  • If you use our Travis CI configuration, create also config/services_test_cached.yaml and import the config/services_test.yaml file: 
    imports:
    - { resource: "services_test.yaml" }
  • Remove all __symfony__ prefixes in your Behat services
  • Remove all <tag name="fob.context_service" /> tags from your Behat services
  • Make your Behat services public by default with <defaults public="true" />
  • Change contexts_services in your suite definitions to contexts
  • If you use our Travis CI configuration, follow these and these changes introduced in .travis.yml file

UPGRADE FROM v1.2.X TO v1.4.0

Firstly, check out the Sylius 1.3 upgrade guide to update Sylius version step by step. To upgrade to Sylius 1.4 follow instructions from the previous section with following changes:

Doctrine migrations

  • Change namespaces of copied migrations to Sylius\Migrations

Dotenv

  • These changes are not required, but can be done as well, if you've changed application directory structure in 1.2.x to 1.3 update

Behat

  • Add \FriendsOfBehat\SymfonyExtension\Bundle\FriendsOfBehatSymfonyExtensionBundle() to your bundles lists in AppKernel.php (preferably only in test environment)
  • Import Sylius Behat services in app/config/config_test.yml and your own Behat services as well: 
    imports:
    - { resource: "../../vendor/sylius/sylius/src/Sylius/Behat/Resources/config/services.xml" }

Deprecations

  • Not passing Sylius\Component\Locale\Context\LocaleContextInterface instance as the second argument to Sylius\Bundle\LocaleBundle\Templating\Helper\LocaleHelper's constructor was deprecated