3 * Bootstrapping for MediaWiki PHPUnit tests
4 * This file is included by phpunit and is NOT in the global scope.
9 if ( !defined( 'MW_PHPUNIT_TEST' ) ) {
11 You are running these tests directly from phpunit. You may not have all globals correctly set.
12 Running phpunit.php instead is recommended.
14 require_once ( dirname( __FILE__
) . "/phpunit.php" );
17 // Output a notice when running with older versions of PHPUnit
18 if ( !version_compare( PHPUnit_Runner_Version
::id(), "3.4.1", ">" ) ) {
20 ********************************************************************************
22 These tests run best with version PHPUnit 3.4.2 or better. Earlier versions may
23 show failures because earlier versions of PHPUnit do not properly implement
26 ********************************************************************************
31 global $wgLocalisationCacheConf, $wgMainCacheType, $wgMessageCacheType, $wgParserCacheType;
32 global $wgMessageCache, $messageMemc, $wgUseDatabaseMessages, $wgMsgCacheExpiry, $wgMemc;
33 $wgLocalisationCacheConf['storeClass'] = 'LCStore_Null';
34 $wgMainCacheType = CACHE_NONE
;
35 $wgMessageCacheType = CACHE_NONE
;
36 $wgParserCacheType = CACHE_NONE
;
37 $wgUseDatabaseMessages = false; # Set for future resets
38 $wgMemc = new FakeMemCachedClient
;
40 # The message cache was already created in Setup.php
41 $wgMessageCache = new StubObject( 'wgMessageCache', 'MessageCache',
42 array( $messageMemc, $wgUseDatabaseMessages, $wgMsgCacheExpiry ) );
46 abstract class MediaWikiTestCase
extends PHPUnit_Framework_TestCase
{
49 public $runDisabled = false;
51 protected static $databaseSetupDone = false;
54 protected $oldTablePrefix;
55 protected $useTemporaryTables = true;
57 function __construct( $name = null, array $data = array(), $dataName = '' ) {
59 $this->setName($name);
63 $this->dataName
= $dataName;
66 function run( PHPUnit_Framework_TestResult
$result = NULL ) {
67 if( $this->needsDB() && !is_object( $this->dbClone
) ) {
69 $this->addCoreDBData();
72 parent
::run( $result );
75 function __destruct() {
76 if( is_object( $this->dbClone
) && $this->dbClone
instanceof CloneDatabase
) {
82 $rc = new ReflectionClass( $this );
83 return strpos( $rc->getDocComment(), '@group Database' ) !== false;
86 function addDBData() {}
88 private function addCoreDBData() {
91 $user = User
::newFromName( 'UTSysop' );
93 if ( $user->idForName() == 0 ) {
94 $user->addToDatabase();
95 $user->setPassword( 'UTSysopPassword' );
97 $user->addGroup( 'sysop' );
98 $user->addGroup( 'bureaucrat' );
99 $user->saveSettings();
103 //Make 1 page with 1 revision
104 $article = new Article( Title
::newFromText( 'UTPage' ) );
105 $article->doEdit( 'UTContent',
109 User
::newFromName( 'UTSysop' ) );
112 private function initDB() {
115 if ( self
::$databaseSetupDone ) {
119 $this->db
= wfGetDB( DB_MASTER
);
120 $dbType = $this->db
->getType();
122 if ( $wgDBprefix === 'unittest_' ||
( $dbType == 'oracle' && $wgDBprefix === 'ut_' ) ) {
123 throw new MWException( 'Cannot run unit tests, the database prefix is already "unittest_"' );
126 self
::$databaseSetupDone = true;
127 $this->oldTablePrefix
= $wgDBprefix;
129 # SqlBagOStuff broke when using temporary tables on r40209 (bug 15892).
130 # It seems to have been fixed since (r55079?).
131 # If it fails, $wgCaches[CACHE_DB] = new HashBagOStuff(); should work around it.
133 # CREATE TEMPORARY TABLE breaks if there is more than one server
134 if ( wfGetLB()->getServerCount() != 1 ) {
135 $this->useTemporaryTables
= false;
138 $temporary = $this->useTemporaryTables ||
$dbType == 'postgres';
140 $tables = $this->listTables();
142 $prefix = $dbType != 'oracle' ?
'unittest_' : 'ut_';
144 $this->dbClone
= new CloneDatabase( $this->db
, $tables, $prefix );
145 $this->dbClone
->useTemporaryTables( $temporary );
146 $this->dbClone
->cloneTableStructure();
148 if ( $dbType == 'oracle' )
149 $this->db
->query( 'BEGIN FILL_WIKI_INFO; END;' );
151 if ( $dbType == 'oracle' ) {
152 # Insert 0 user to prevent FK violations
155 $this->db
->insert( 'user', array(
157 'user_name' => 'Anonymous' ) );
162 protected function destroyDB() {
163 if ( !self
::$databaseSetupDone ) {
167 $this->dbClone
->destroy();
168 self
::$databaseSetupDone = false;
170 if ( $this->useTemporaryTables
) {
171 # Don't need to do anything
173 //Temporary tables seem to be broken ATM, delete anyway
176 if( $this->db
->getType() == 'oracle' ) {
177 $tables = $this->db
->listTables( 'ut_', __METHOD__
);
180 $tables = $this->db
->listTables( 'unittest_', __METHOD__
);
183 foreach ( $tables as $table ) {
184 $sql = $this->db
->getType() == 'oracle' ?
"DROP TABLE $table DROP CONSTRAINTS" : "DROP TABLE `$table`";
185 $this->db
->query( $sql );
188 if ( $this->db
->getType() == 'oracle' )
189 $this->db
->query( 'BEGIN FILL_WIKI_INFO; END;' );
194 function __call( $func, $args ) {
195 static $compatibility = array(
196 'assertInternalType' => 'assertType',
197 'assertNotInternalType' => 'assertNotType',
198 'assertInstanceOf' => 'assertType',
201 if ( method_exists( $this->suite
, $func ) ) {
202 return call_user_func_array( array( $this->suite
, $func ), $args);
203 } elseif ( isset( $compatibility[$func] ) ) {
204 return call_user_func_array( array( $this, $compatibility[$func] ), $args);
206 throw new MWException( "Called non-existant $func method on "
207 . get_class( $this ) );
211 protected function listTables() {
214 $tables = $this->db
->listTables( $wgDBprefix, __METHOD__
);
215 $tables = array_map( create_function( '$table', 'global $wgDBprefix; return substr( $table, strlen( $wgDBprefix ) );' ), $tables );