diff options
| author | Andreas Fischer <bantu@phpbb.com> | 2013-07-01 21:22:51 +0200 |
|---|---|---|
| committer | Andreas Fischer <bantu@phpbb.com> | 2013-07-01 21:22:51 +0200 |
| commit | 1a292750f25de08a85b0fdd81bdf3e1899cd91b4 (patch) | |
| tree | 21a096ff4eb2c55e5f8565296fbf90c36f2ce641 /tests | |
| parent | 960b20e45bda11a072102294d66837a2691893b9 (diff) | |
| parent | 440986dc3f941835febf75a30f41b69cb748a15a (diff) | |
| download | forums-1a292750f25de08a85b0fdd81bdf3e1899cd91b4.tar forums-1a292750f25de08a85b0fdd81bdf3e1899cd91b4.tar.gz forums-1a292750f25de08a85b0fdd81bdf3e1899cd91b4.tar.bz2 forums-1a292750f25de08a85b0fdd81bdf3e1899cd91b4.tar.xz forums-1a292750f25de08a85b0fdd81bdf3e1899cd91b4.zip | |
Merge remote-tracking branch 'dhruvgoel92/ticket/10838' into develop-olympus
* dhruvgoel92/ticket/10838:
[ticket/10838] Fix URL for wiki and remove irrelevant line
[ticket/10838] Remove php 5.4 and builtin server references
[ticket/10838] Fix missing data
[ticket/10838] separate database used mentioned in unit tests
[ticket/10838] Updated RUNNING_TESTS.md
Diffstat (limited to 'tests')
| -rw-r--r-- | tests/RUNNING_TESTS.md | 38 |
1 files changed, 34 insertions, 4 deletions
diff --git a/tests/RUNNING_TESTS.md b/tests/RUNNING_TESTS.md index 26a93f0430..23c74f4411 100644 --- a/tests/RUNNING_TESTS.md +++ b/tests/RUNNING_TESTS.md @@ -47,9 +47,11 @@ Database Tests By default all tests requiring a database connection will use sqlite. If you do not have sqlite installed the tests will be skipped. If you wish to run the tests on a different database you have to create a test_config.php file within -your tests directory following the same format as phpBB's config.php. An -example for mysqli can be found below. More information on configuration -options can be found on the wiki (see below). +your tests directory following the same format as phpBB's config.php. Testing +makes use of a seperate database defined in this config file and before running +the tests each time this database is deleted. An example for mysqli can be +found below. More information on configuration options can be found on the +wiki (see below). <?php $dbms = 'mysqli'; @@ -114,8 +116,36 @@ only want the slow tests, run: $ phpBB/vendor/bin/phpunit --group slow +Functional tests +----------------- + +Functional tests test software the way a user would. They simulate a user +browsing the website, but they do these steps in an automated way. +phpBB allows you to write such tests. + +Running +======= + +Running the tests requires your phpBB3 repository to be accessible through a +local web server. You will need to supply the URL to the webserver in +the 'tests/test_config.php' file. This is as simple as defining the +'$phpbb_functional_url' variable, which contains the URL for the directory containing +the board. Make sure you include the trailing slash. Note that without extensive +changes to the test framework, you cannot use a board outside of the repository +on which to run tests. + + $phpbb_functional_url = 'http://localhost/phpBB3/'; + +To then run the tests, you run PHPUnit, but use the phpunit.xml.functional +config file instead of the default one. Specify this through the "-c" option: + + $ phpBB/vendor/bin/phpunit -c phpunit.xml.functional + +This will change your board's config.php file, but it makes a backup at +config_dev.php, so you can restore it after the test run is complete. + More Information ================ Further information is available on phpbb wiki: -http://wiki.phpbb.com/Unit_Tests +http://wiki.phpbb.com/Automated_Tests |