Installation of the Functional Testing Framework Entities

Well, you are on the way to install the Functional Testing Framework!

Check pre-installation conditions

Install the Magento application

To install the Magento application, see Magento Installation Guide.

Check if all required software installed and configured


For more details about PHP verification, installation and configuration (Ubuntu, CentOS).

In php.ini file, make sure extension=php_openssl.dll is not commented out.

Check if the Functional Testing Framework has been already installed

  1. Find directory <magento2_root_dir>/dev/tests/functional/.
  2. Find the vendor directory. If the directory exists, you already have the Functional Testing Framework installed in vendor/magento/mtf.

Perform the installation

The Functional Testing Framework requires Composer, which downloads libraries defined in <magento2_root_dir>/dev/tests/functional/composer.json.

If you’re not sure that Composer is installed, see Install Composer.

  1. Open a command prompt.
  2. Log in to your Magento server as a user with permissions to modify the Magento file system. (This is typically the Magento file system owner.)
cd <magento2_root_dir>/dev/tests/functional/
composer install

If the command execution failed, check if Composer is installed globally.

Check the installation

Find the Functional Testing Framework directory

Check whether the vendor directory exists in <magento2_root_dir>/dev/tests/functional/.

cd <magento2_root_dir>/dev/tests/functional/

Find the mtf directory.

cd vendor/magento

Verify the Functional Testing Framework version

Open <magento2_root_dir>/dev/tests/functional/vendor/magento/mtf/ The latest version in is version of the FTF you installed.

Next Steps

Adjust the FTF configuration