You are reading the documentation for version 2.2. Magento 2.3 is the latest version available. Ensure you are reading the documentation for your version of Magento.

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 ported over to the MFTF. We recommend using the MFTF for testing.

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

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.

Related topics

Adjust the FTF configuration