aboutsummaryrefslogtreecommitdiffstats
path: root/tests/RUNNING_TESTS.txt
diff options
context:
space:
mode:
authorNils Adermann <naderman@naderman.de>2010-10-22 19:27:41 +0200
committerNils Adermann <naderman@naderman.de>2010-10-25 19:38:58 +0200
commit9dbbfea5fd31e40acc6fb4a195795b3e285a5b56 (patch)
treea1b86b5befa333ce44eec4185ed4a519bd558db1 /tests/RUNNING_TESTS.txt
parentee846c461c6f0d4ec02dcefa6c82090587bc7012 (diff)
downloadforums-9dbbfea5fd31e40acc6fb4a195795b3e285a5b56.tar
forums-9dbbfea5fd31e40acc6fb4a195795b3e285a5b56.tar.gz
forums-9dbbfea5fd31e40acc6fb4a195795b3e285a5b56.tar.bz2
forums-9dbbfea5fd31e40acc6fb4a195795b3e285a5b56.tar.xz
forums-9dbbfea5fd31e40acc6fb4a195795b3e285a5b56.zip
[task/mssql-db-tests] No longer display an error when skipping db tests.
Tests are run with sqlite by default now anyway, so in the majority of cases the error message explaining how to set up database test running will not be displayed anyway. Database tests are now generally simply skipped if no configuration can be found. The RUNNING_TESTS.txt file explains how to set them up however, and more info is available on the wiki. The get_database_config method was moved from test_case_helpers to database_test_case because it has no general purpose. PHPBB3-9868
Diffstat (limited to 'tests/RUNNING_TESTS.txt')
-rw-r--r--tests/RUNNING_TESTS.txt30
1 files changed, 24 insertions, 6 deletions
diff --git a/tests/RUNNING_TESTS.txt b/tests/RUNNING_TESTS.txt
index f1b40f71ad..a5d3111242 100644
--- a/tests/RUNNING_TESTS.txt
+++ b/tests/RUNNING_TESTS.txt
@@ -1,33 +1,51 @@
Running Tests
--------------
+=============
Prerequisites
--------------
+=============
PHPUnit
-=======
+-------
phpBB unit tests use PHPUnit framework. Version 3.3 or better is required
to run the tests. PHPUnit prefers to be installed via PEAR; refer to
http://www.phpunit.de/ for more information.
PHP extensions
-==============
+--------------
Unit tests use several PHP extensions that board code does not use. Currently
the following PHP extensions must be installed and enabled to run unit tests:
- ctype
+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).
+
+ <?php
+ $dbms = 'mysqli';
+ $dbhost = 'localhost';
+ $dbport = '';
+ $dbname = 'database';
+ $dbuser = 'user';
+ $dbpasswd = 'password';
+
+
Running
--------
+=======
Once the prerequisites are installed, run the tests from tests directory:
$ phpunit all_tests.php
More Information
-----------------
+================
Further information is available on phpbb wiki:
http://wiki.phpbb.com/display/DEV/Unit+Tests