TestingEnvironment

From PmaWiki
Jump to: navigation, search

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


Contents

[edit] Prerequisites.

  • 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)

[edit] 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).

[edit] 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:
pear install phpunit/PHPUnit_Selenium

[edit] Configuring Selenium

  • Please refer to test/README.rst.

[edit] 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.

[edit] 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.

Personal tools