Michal Čihař edited this page May 16, 2016 · 4 revisions
Clone this wiki locally

This page will contain info on setting up a test environment.


  • PHP 5.2.7 (or later) but PHP 5.3.3 (or later) is highly recommended
  • Xdebug 2.0.5 (or later) but Xdebug 2.1.0 (or later) is highly recommended
  • PEAR Version: 1.9.1
  • PHP Unit 3.5 (or later)

Installing PHPUnit

Please refer to https://phpunit.de/manual/current/en/installation.html which explains the requirements and details the installation via a PHP Archive (PHAR).

Installing Selenium

  • Download a distribution archive of Selenium Server
  • Unzip the distribution archive and copy selenium-server-standalone-2.9.0.jar (check the version suffix) to /usr/local/bin, for instance
  • Start the Selenium Server server by running java -jar /usr/local/bin/selenium-server-standalone-2.9.0.jar
    • This can be on a totally different computer, e.g. a machine that has a specific browser available.
  • Install the PHPUnit_Selenium package, necessary for natively accessing the Selenium Server from PHPUnit
    • The dependency requirement for PhpUnit_Selenium is already declared in composer.json in the phpMyAdmin directory. But you would require composer to be installed on your machine to download the required dependencies.
    • You can download the composer.phar in the phpMyAdmin directory (if it's not already installed globally on your machine) by running the command below

curl -sShttps://getcomposer.org/installer| php

For other composer installation instructions, please refer to Composer

  • To resolve and download dependencies, run the install command inside the phpMyAdmin directory:

php composer.phar install

  • If you did a global install and do not have the phar in that directory run this instead:

composer install

Configuring Selenium

  • Please refer to test/README.rst.

Configuring phpMyAdmin for Selenium

  • If your browser is not natively in English, you will probably have to add this in config.inc.php:

$cfg['Lang'] = 'en';

otherwise, tests that are looking for a specific English message will fail.

Running phpMyAdmin Tests

If you successfully configured your testing environment, you can start running the phpMyAdmin Test Suite. All the tests are in the test/ folder

  • You can run test from command line specifying the configuration file.

$ cd $PHPMYADMIN_SOURCES $ phpunit -c phpunit.xml.nocoverage

  • If you are also interested in the code coverage report, run this command. It will take much longer and will use quite a lot memory :

$ phpunit -c phpunit.xml.dist

Currently Unit Tests under heavy development. Details can be found on the UnitTesting page.

Testing environment