installation.md

Upgrade from 1.x version

See Upgrade guide from 1.x to 2.0.

Installation

1. Download the Bundle

   Open a command console, enter your project directory and execute the following command to download the latest stable version of this bundle:

   $ composer require --dev liip/functional-test-bundle:~2.0@alpha

   This command requires you to have Composer installed globally, as explained in the installation chapter of the Composer documentation.

2. Enable the Bundle

   Add the following line in the app/AppKernel.php file to enable this bundle only for the test environment:

   <?php
   // app/AppKernel.php
   
   // ...
   class AppKernel extends Kernel
   {
       public function registerBundles()
       {
           // ...
           if (in_array($this->getEnvironment(), array('dev', 'test'), true)) {
               // ...
               if ('test' === $this->getEnvironment()) {
                   $bundles[] = new Liip\FunctionalTestBundle\LiipFunctionalTestBundle();
               }
           }
   
           return $bundles;
       }
   
       // ...
   }

3. Enable the functionalTest service adding the following empty configuration, ensuring that the framework sets the session name and is using the filesystem for session storage:

   • For symfony 3:

     # app/config/config_test.yml
     liip_functional_test: ~

     # app/config/config_test.yml
     framework:
         test: ~
         session:
             storage_id: session.storage.mock_file
             name: MOCKSESSION

   • For symfony 4:

     # config/packages/test/framework.yaml
     framework:
         test: true
         session:
             storage_id: session.storage.mock_file
             name: MOCKSESSION
     
     liip_functional_test: ~