friends-of-behat-symfony-extension/UPGRADE-2.0.md

Migrating from SymfonyExtension 1.x to SymfonyExtension 2.0

Upgrade checklist

Symfony application configuration

• Register \FriendsOfBehat\SymfonyExtension\Bundle\FriendsOfBehatSymfonyExtensionBundle bundle in your kernel in test environment.

• Load your context services definitions in test environment (check installation documentation).

Behat extensions configuration

• Remove FriendsOfBehat\CrossContainerExtension and FriendsOfBehat\ContextServiceExtension from the extensions list.

• Integrate the configuration changes to your FriendsOfBehat\SymfonyExtension config (see configuration reference):

  • kernel.env was renamed to kernel.environment

  • kernel.bootstrap was moved to bootstrap

  • env_file setting was removed (use original Symfony bootstrap file or a custom one to load environment variables)

Behat suite configuration

• Replace contexts_services configuration key from your suites configuration with contexts.

Context service - definition

• Make sure all your context definitions are public.

• Remove fob.context_service tag from your context definitions.

Context service - dependencies

• Remove __symfony__. and __symfony_shared__. prefixes from your context dependencies.

• Use behat.mink.default_session service instead of mink.default_session or getting the session from __behat__.mink service.

• Inject behat.mink.parameters service (which is an object implementing \ArrayAccess) instead of %__behat__.mink.parameters% parameter. Remove array typehint in the class implementation and assert it's \ArrayAccess or array instead.

Exemplary upgrade

Sylius has updated from v1 to v2 in this PR.

<!-- Before -->
<service id="mink.default_session" class="Behat\Mink\Session" lazy="true" public="false">
    <factory service="__behat__.mink" method="getSession" />
</service>

<service id="some_context" class="SomeContext" public="true">
    <argument type="service" id="mink.default_session" />
    <argument>%__behat__.mink.parameters%</argument>
    <argument type="service" id="__symfony__.some_service" />
    <tag name="fob.context_service" />
</service>

<!-- After -->
<service id="some_context" class="SomeContext" public="true">
    <argument type="service" id="behat.mink.default_session" />
    <argument type="service" id="behat.mink.parameters" />
    <argument type="service" id="some_service" />
</service>