wiki.techinc.nl/tests/phpunit
Aaron Schulz 5c8ef13306 Add WRITE_SYNC flag to BagOStuff::set()/merge()
* This blocks on writing to all replicas
  and returns false if any failed.
* This is useful if ChronologyProtector is to work across
  domains by having the writes go everywhere so that later
  reads will see them (and be local at the same time).
* Redundant doc comments were also removed.

Change-Id: I9ed098d563c64dba605e7809bc96731da3b3e79d
2015-10-22 01:44:09 +00:00
..
data Add unit tests for FileContentsHasher 2015-09-24 13:39:09 +01:00
docs Clean up ExportDemoTest 2014-03-07 21:17:08 +00:00
includes Add WRITE_SYNC flag to BagOStuff::set()/merge() 2015-10-22 01:44:09 +00:00
languages Merge "Add new grammar forms for language names in Russian" 2015-09-28 13:41:33 +00:00
maintenance Move comment in backup_PageTest.php 2015-10-14 09:08:52 +00:00
mocks Configure logged in session length independently 2015-06-23 19:31:20 -04:00
skins Fixed some @params documentation (tests) 2014-04-17 20:43:42 +02:00
structure Make lines short to pass phpcs in ResourcesTest.php 2015-09-30 15:40:39 +00:00
suites Deprecate $wgEnableParserCache 2015-06-04 19:23:03 +01:00
tests Throw exception when trying to stash unset globals 2014-03-09 14:52:40 +01: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 Pass phpcs-strict on some test files (1/x) 2014-04-24 17:05:32 +02:00
MediaWikiPHPUnitTestListener.php Wrap some long strings in tests/ 2015-09-26 21:01:59 +01:00
MediaWikiTestCase.php Fix transaction warnings on test cleanup rollback() 2015-10-21 12:13:22 -07:00
phpunit.php Fix issues identified by SpaceBeforeSingleLineComment sniff 2015-09-26 23:06:52 +00:00
README Update test documentation, fix broken links 2015-09-03 12:28:19 +00:00
ResourceLoaderTestCase.php resourceloader: Enable module content version for data modules 2015-06-18 20:39:38 +00:00
run-tests.bat Per wikitech-l discussion: Move tests from maintenance/tests/ to tests/. They're not strictly maintenance scripts, and some people want to do a selective checkout that doesn't include the tests. There's still debate on whether we should include these in the release downloads, but we had a pretty firm consensus to move this. 2010-12-14 16:26:35 +00:00
suite.xml tests: add structure and less tests to 'skins' suite 2015-08-25 14:52:52 +02: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