wiki.techinc.nl/tests/phpunit
Matthew Flaschen d920237e37 Add support for External Store for unit tests
This allow running PHP tests with External Store DB configured.
This means it needs to do the unittest_ prefixing similar to the main
tables.

It could do resetting (truncating the tables) similar to the tablesUsed
functionality.  However, if External Store is truncated unconditionally,
revision, etc. also needs to be.  This can cause performance issues.
I was thinking of making resetting ES optional, but it wasn't needed
to pass any of the core tests, so I just left it out entirely for now.

Bug: T95870
Change-Id: If27435210d5a2165795dd759b17a7e51fe9bba10
2016-03-11 19:58:32 -05:00
..
data Convert all array() syntax to [] 2016-02-17 01:33:00 -08:00
docs Clean up ExportDemoTest 2014-03-07 21:17:08 +00:00
includes Don't return PHPUnit_Framework_MockObject_MockObject when not needed 2016-03-11 15:28:46 +00:00
languages Use static::class instead of get_called_class() 2016-02-29 22:43:58 +00:00
maintenance Convert all array() syntax to [] 2016-02-17 01:33:00 -08:00
mocks Add missing null type hints to Content::isCountable and implementations 2016-02-25 14:13:22 +01:00
skins Fix trivial PHPCS violations in */skins/* directories 2016-03-02 21:02:15 +01:00
structure Replace uses of join() by implode() 2016-03-08 18:24:16 +00:00
suites build: Ignore phpcs in /skins but not /includes/skins 2016-03-04 15:50:03 +00:00
tests Convert all array() syntax to [] 2016-02-17 01:33:00 -08:00
bootstrap.php Remove phpunit profiling. It doesn't make any sense 2015-02-10 18:50:52 +00:00
LessFileCompilationTest.php resourceloader: Tidy up RL to simplify ResourceLoaderEditToolbarModule 2015-09-28 12:18:12 -07:00
Makefile tests: Remove "install" target from makefile documentation 2015-09-02 23:58:26 +00:00
MediaWikiLangTestCase.php phpunit: Abstract user-lang override in MediaWikiTestCase 2016-03-09 16:55:50 +00:00
MediaWikiPHPUnitTestListener.php Wrap some long strings in tests/ 2015-09-26 21:01:59 +01:00
MediaWikiTestCase.php Add support for External Store for unit tests 2016-03-11 19:58:32 -05:00
phpunit.php Upgrade from PHPunit 3.7.x to PHPUnit 4.8.x 2016-02-23 00:57:48 +00:00
README Update test documentation, fix broken links 2015-09-03 12:28:19 +00:00
ResourceLoaderTestCase.php Convert all array() syntax to [] 2016-02-17 01:33:00 -08:00
run-tests.bat
suite.xml Upgrade from PHPunit 3.7.x to PHPUnit 4.8.x 2016-02-23 00:57:48 +00:00
TODO format the tests/phpunit/TODO document for readability 2014-05-15 11:21:51 +00:00

== MediaWiki PHPUnit Tests ==

The unit tests for MediaWiki are implemented using the PHPUnit testing
framework and require PHPUnit to run.


=== WARNING ===

Some of the unit tests are DESTRUCTIVE and WILL ALTER YOUR WIKI'S CONTENTS.

DO NOT RUN THESE TESTS ON A PRODUCTION SYSTEM OR ON ANY SYSTEM WHERE YOU NEED
TO RETAIN YOUR DATA.


== Installation ==

If you used composer to install MediaWiki's dependencies PHPUnit will already be available, unless
you explicitly specified the --no-dev flag during the install. In this case just run "composer update".

Otherwise follow the installation instructions in the
PHPUnit Manual at:

  https://phpunit.de/manual/current/en/installation.html


== Running tests ==

The tests are run from your operating system's command line.

Ensure that you are in the tests/phpunit directory of your MediaWiki
installation.


On Unix-like operating systems, the tests runs are controlled with a makefile.
Run command:

  make help

for a full list of options for running tests.


On Windows-family operating systems, run the 'run-tests.bat' batch file.


=== Writing tests ===

A guide to writing PHP unit tests for MediaWiki can be found at:

	https://www.mediawiki.org/wiki/Manual:PHP_unit_testing