PhpMyAdmin test suite
This directory is protected from web visitors by a .htaccess file.
For more information on allowing http access to this directory see: https://httpd.apache.org/docs/current/mod/mod_authz_host.html#allow
Please visit the wiki for more information on unit testing: https://wiki.phpmyadmin.net/pma/Unit_Testing
Selenium tests
To be able to run Selenium tests, you need to have webserver, database and Selenium running. Following environment variables configure where testsuite connects:
- TESTSUITE_USER
-
Username to connect on the interface located at TESTSUITE_URL
- TESTSUITE_PASSWORD
-
Password to connect on the interface located at TESTSUITE_URL
- TESTSUITE_DATABASE_PREFIX
-
Database prefix to use for testing (Avoid database grouping characters like _).
- TESTSUITE_URL
-
URL where tested phpMyAdmin is available.
Additionally you need to configure link to Selenium and browsers. You can either setup Selenium locally or use BrowserStack automated testing.
For local setup, define following:
- TESTSUITE_SELENIUM_HOST
-
Host where Selenium is running.
- TESTSUITE_SELENIUM_PORT
-
Port where to connect.
- TESTSUITE_SELENIUM_BROWSER
-
Browser to use for testing inside Selenium.
With BrowserStack, set following:
- TESTSUITE_BROWSERSTACK_USER
-
BrowserStack username.
- TESTSUITE_BROWSERSTACK_KEY
-
BrowserStack access key.
For example you can use following setup in
phpunit.xml:
<php>
<env name="TESTSUITE_USER" value="root"/>
<env name="TESTSUITE_PASSWORD" value="root"/>
<env name="TESTSUITE_DATABASE_PREFIX" value="test"/>
<env name="TESTSUITE_URL" value="http://localhost/phpmyadmin/" />
<env name="TESTSUITE_SELENIUM_HOST" value="127.0.0.1" />
<env name="TESTSUITE_SELENIUM_PORT" value="4444" />
</php>Using BrowserStack
We're using our selenium tests on the GitHub CI.
To run tests locally, you need to install BrowserStack tool to enable local testing, see their website for instructions:
https://www.browserstack.com/local-testing#command-line
Following instructions use PHP's built in server for the testing:
# Export BrowserStack credentials in the environment:
export TESTSUITE_BROWSERSTACK_USER=your_username
export TESTSUITE_BROWSERSTACK_KEY=your_key
# Port where tests will be running
export TESTSUITE_PORT=9000
export TESTSUITE_URL=http://127.0.0.1:$TESTSUITE_PORT/
# Start PHP built in server
php --server 127.0.0.1:$TESTSUITE_PORT > php.log &
# Start BrowserStack Local client to forward the traffic
~/browserstack/BrowserStackLocal -localIdentifier Manual "$TESTSUITE_BROWSERSTACK_KEY" 127.0.0.1,$TESTSUITE_PORT,0 &
# Stop BrowserStack Local
~/browserstack/BrowserStackLocal --daemon stop