tests/phpunit/bootstrap.php

   1 <?php
   2 /**
   3  * Bootstrapping for MediaWiki PHPUnit tests
   4  * This file is included by phpunit and is NOT in the global scope.
   5  *
   6  * @file
   7  */
   8
   9 if ( !defined( 'MW_PHPUNIT_TEST' ) ) {
  10         echo <<<EOF
  11 You are running these tests directly from phpunit. You may not have all globals correctly set.
  12 Running phpunit.php instead is recommended.
  13 EOF;
  14         require_once ( dirname( __FILE__ ) . "/phpunit.php" );
  15 }
  16
  17 // Output a notice when running with older versions of PHPUnit
  18 if ( !version_compare( PHPUnit_Runner_Version::id(), "3.4.1", ">" ) ) {
  19   echo <<<EOF
  20 ********************************************************************************
  21
  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
  24 dependencies.
  25
  26 ********************************************************************************
  27
  28 EOF;
  29 }
  30
  31 global $wgLocalisationCacheConf, $wgMainCacheType, $wgMessageCacheType, $wgParserCacheType;
  32 global $wgMessageCache, $messageMemc, $wgUseDatabaseMessages, $wgMsgCacheExpiry;
  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
  39 # The message cache was already created in Setup.php
  40 $wgMessageCache = new StubObject( 'wgMessageCache', 'MessageCache',
  41         array( $messageMemc, $wgUseDatabaseMessages, $wgMsgCacheExpiry ) );
  42
  43 /* Classes */
  44
  45 abstract class MediaWikiTestCase extends PHPUnit_Framework_TestCase {
  46         public $suite;
  47         public $regex = '';
  48         public $runDisabled = false;
  49
  50         protected static $databaseSetupDone = false;
  51         protected $db;
  52         protected $dbClone;
  53         protected $oldTablePrefix;
  54         protected $useTemporaryTables = true;
  55
  56         function  __construct( $name = null, array $data = array(), $dataName = '' ) {
  57         if ($name !== null) {
  58             $this->setName($name);
  59         }
  60
  61         $this->data = $data;
  62         $this->dataName = $dataName;
  63
  64                 if( $this->needsDB() && !is_object( $this->dbClone ) ) {
  65                         $this->initDB();
  66                         $this->addCoreDBData();
  67                         $this->addDBData();
  68                 }
  69         }
  70
  71         function __destruct() {
  72                 if( $this->needsDB() && is_object( $this->dbClone ) && $this->dbClone instanceof CloneDatabase ) {
  73                         $this->destroyDB();
  74                 }
  75         }
  76
  77         function needsDB() { return true; }
  78
  79         function addDBData() {}
  80
  81         private function addCoreDBData() {
  82
  83                 //Make sysop user
  84                 $user = User::newFromName( 'UTSysop' );
  85
  86                 if ( $user->idForName() == 0 ) {
  87                         $user->addToDatabase();
  88                         $user->setPassword( 'UTSysopPassword' );
  89
  90                         $user->addGroup( 'sysop' );
  91                         $user->addGroup( 'bureaucrat' );
  92                         $user->saveSettings();
  93                 }
  94
  95
  96                 //Make 1 page with 1 revision
  97                 $article = new Article( Title::newFromText( 'UTPage' ) );
  98                 $article->doEdit( 'UTContent',
  99                                                         'UTPageSummary',
 100                                                         EDIT_NEW,
 101                                                         false,
 102                                                         User::newFromName( 'UTSysop' ) );
 103         }
 104
 105         private function initDB() {
 106                 global $wgDBprefix;
 107
 108                 if ( self::$databaseSetupDone ) {
 109                         return;
 110                 }
 111
 112                 $this->db = wfGetDB( DB_MASTER );
 113                 $dbType = $this->db->getType();
 114
 115                 if ( $wgDBprefix === 'unittest_' || ( $dbType == 'oracle' && $wgDBprefix === 'ut_' ) ) {
 116                         throw new MWException( 'Cannot run unit tests, the database prefix is already "unittest_"' );
 117                 }
 118
 119                 self::$databaseSetupDone = true;
 120                 $this->oldTablePrefix = $wgDBprefix;
 121
 122                 # SqlBagOStuff broke when using temporary tables on r40209 (bug 15892).
 123                 # It seems to have been fixed since (r55079?).
 124                 # If it fails, $wgCaches[CACHE_DB] = new HashBagOStuff(); should work around it.
 125
 126                 # CREATE TEMPORARY TABLE breaks if there is more than one server
 127                 if ( wfGetLB()->getServerCount() != 1 ) {
 128                         $this->useTemporaryTables = false;
 129                 }
 130
 131                 $temporary = $this->useTemporaryTables || $dbType == 'postgres';
 132
 133                 $tables = $this->listTables();
 134
 135                 $prefix = $dbType != 'oracle' ? 'unittest_' : 'ut_';
 136
 137                 $this->dbClone = new CloneDatabase( $this->db, $tables, $prefix );
 138                 $this->dbClone->useTemporaryTables( $temporary );
 139                 $this->dbClone->cloneTableStructure();
 140
 141                 if ( $dbType == 'oracle' )
 142                         $this->db->query( 'BEGIN FILL_WIKI_INFO; END;' );
 143
 144                 if ( $dbType == 'oracle' ) {
 145                         # Insert 0 user to prevent FK violations
 146
 147                         # Anonymous user
 148                         $this->db->insert( 'user', array(
 149                                 'user_id'         => 0,
 150                                 'user_name'       => 'Anonymous' ) );
 151                 }
 152
 153         }
 154
 155         protected function destroyDB() {
 156                 if ( !self::$databaseSetupDone ) {
 157                         return;
 158                 }
 159
 160                 $this->dbClone->destroy();
 161                 self::$databaseSetupDone = false;
 162
 163                 if ( $this->useTemporaryTables ) {
 164                         # Don't need to do anything
 165                         //return;
 166                         //Temporary tables seem to be broken ATM, delete anyway
 167                 }
 168
 169                 if( $this->db->getType() == 'oracle' ) {
 170                         $tables = $this->db->listTables( 'ut_', __METHOD__ );
 171                 }
 172                 else {
 173                         $tables = $this->db->listTables( 'unittest_', __METHOD__ );
 174                 }
 175
 176                 foreach ( $tables as $table ) {
 177                         $sql = $this->db->getType() == 'oracle' ? "DROP TABLE $table DROP CONSTRAINTS" : "DROP TABLE `$table`";
 178                         $this->db->query( $sql );
 179                 }
 180
 181                 if ( $this->db->getType() == 'oracle' )
 182                         $this->db->query( 'BEGIN FILL_WIKI_INFO; END;' );
 183
 184
 185         }
 186
 187         function __call( $func, $args ) {
 188                 if ( method_exists( $this->suite, $func ) ) {
 189                         return call_user_func_array( array( $this->suite, $func ), $args);
 190                 } else {
 191                         throw new MWException( "Called non-existant $func method on "
 192                                 . get_class( $this ) );
 193                 }
 194         }
 195
 196         protected function listTables() {
 197                 global $wgDBprefix;
 198
 199                 $tables = $this->db->listTables( $wgDBprefix, __METHOD__ );
 200                 $tables = array_map( create_function( '$table', 'global $wgDBprefix; return substr( $table, strlen( $wgDBprefix ) );' ), $tables );
 201                 return $tables;
 202
 203         }
 204 }
 205