Installation of the Functional Testing Framework Entities

The Magento Testing Framework (MTF) is superseded by the Magento Functional Testing Framework (MFTF). While the MTF is still functional, all MTF tests are being ported over to the MFTF. We recommend using the MFTF for testing.

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

Follow the next three steps:

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, see PHP Settings.

In php.ini file, make sure extension=php_openssl.dll is not commented out. Note: The Windows environment is not officially supported.

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

Command fail

If command failed, maybe Composer hasn’t been installed globally.

  • Copy composer.phar to /usr/local/bin/composer.
  • To run it locally put composer.phar into directory, where composer.json file is located (that is, <magento2>/dev/tests/functional/).
  • And run from this directory php composer.phar install.

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.

Related topics

Adjust the FTF configuration