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)
Please refer to https://phpunit.de/manual/current/en/installation.html which explains the requirements and details the installation via a PHP Archive (PHAR).
- 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
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:
- 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.