Skip to content

Latest commit

 

History

History
69 lines (43 loc) · 2.79 KB

UPGRADE-2.0.md

File metadata and controls

69 lines (43 loc) · 2.79 KB
Raw

Migrating from SymfonyExtension 2.x to SymfonyExtension 2.4.2

If you were having "friends-of-behat/mink-browserkit-driver" or "friends-of-behat/mink" in your composer.json, you should remove them and add "behat/mink-browserkit-driver" and "behat/mink" accordingly.

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>