tests/phpunit/phpunit.php

   1 #!/usr/bin/env php
   2 <?php
   3 /**
   4  * Bootstrapping for MediaWiki PHPUnit tests
   5  *
   6  * @file
   7  */
   8
   9 /* Configuration */
  10
  11 // Set a flag which can be used to detect when other scripts have been entered through this entry point or not
  12 define( 'MW_PHPUNIT_TEST', true );
  13
  14 // Start up MediaWiki in command-line mode
  15 require_once( dirname( dirname( __DIR__ ) ) . "/maintenance/Maintenance.php" );
  16
  17 class PHPUnitMaintClass extends Maintenance {
  18
  19         function __construct() {
  20                 parent::__construct();
  21                 $this->addOption( 'with-phpunitdir',
  22                         'Directory to include PHPUnit from, for example when using a git fetchout from upstream. Path will be prepended to PHP `include_path`.',
  23                         false, # not required
  24                         true # need arg
  25                 );
  26         }
  27
  28         public function finalSetup() {
  29                 parent::finalSetup();
  30
  31                 global $wgMainCacheType, $wgMessageCacheType, $wgParserCacheType;
  32                 global $wgLanguageConverterCacheType, $wgUseDatabaseMessages;
  33                 global $wgLocaltimezone, $wgLocalisationCacheConf;
  34                 global $wgDevelopmentWarnings;
  35
  36                 // wfWarn should cause tests to fail
  37                 $wgDevelopmentWarnings = true;
  38
  39                 $wgMainCacheType = CACHE_NONE;
  40                 $wgMessageCacheType = CACHE_NONE;
  41                 $wgParserCacheType = CACHE_NONE;
  42                 $wgLanguageConverterCacheType = CACHE_NONE;
  43
  44                 $wgUseDatabaseMessages = false; # Set for future resets
  45
  46                 // Assume UTC for testing purposes
  47                 $wgLocaltimezone = 'UTC';
  48
  49                 $wgLocalisationCacheConf['storeClass'] = 'LCStore_Null';
  50
  51                 // Bug 44192 Do not attempt to send a real e-mail
  52                 Hooks::clear( 'AlternateUserMailer' );
  53                 Hooks::register( 'AlternateUserMailer',
  54                         function() { return false; }
  55                 );
  56         }
  57
  58         public function execute() {
  59                 global $IP;
  60
  61                 # Make sure we have --configuration or PHPUnit might complain
  62                 if ( !in_array( '--configuration', $_SERVER['argv'] ) ) {
  63                         //Hack to eliminate the need to use the Makefile (which sucks ATM)
  64                         array_splice( $_SERVER['argv'], 1, 0,
  65                                 array( '--configuration', $IP . '/tests/phpunit/suite.xml' ) );
  66                 }
  67
  68                 # --with-phpunitdir let us override the default PHPUnit version
  69                 if ( $phpunitDir = $this->getOption( 'with-phpunitdir' ) ) {
  70                         # Sanity checks
  71                         if ( !is_dir( $phpunitDir ) ) {
  72                                 $this->error( "--with-phpunitdir should be set to an existing directory", 1 );
  73                         }
  74                         if ( !is_readable( $phpunitDir . "/PHPUnit/Runner/Version.php" ) ) {
  75                                 $this->error( "No usable PHPUnit installation in $phpunitDir.\nAborting.\n", 1 );
  76                         }
  77
  78                         # Now prepends provided PHPUnit directory
  79                         $this->output( "Will attempt loading PHPUnit from `$phpunitDir`\n" );
  80                         set_include_path( $phpunitDir
  81                                 . PATH_SEPARATOR . get_include_path() );
  82
  83                         # Cleanup $args array so the option and its value do not
  84                         # pollute PHPUnit
  85                         $key = array_search( '--with-phpunitdir', $_SERVER['argv'] );
  86                         unset( $_SERVER['argv'][$key] ); // the option
  87                         unset( $_SERVER['argv'][$key + 1] ); // its value
  88                         $_SERVER['argv'] = array_values( $_SERVER['argv'] );
  89
  90                 }
  91         }
  92
  93         public function getDbType() {
  94                 return Maintenance::DB_ADMIN;
  95         }
  96 }
  97
  98 $maintClass = 'PHPUnitMaintClass';
  99 require( RUN_MAINTENANCE_IF_MAIN );
 100
 101 require_once( 'PHPUnit/Runner/Version.php' );
 102
 103 if ( PHPUnit_Runner_Version::id() !== '@package_version@'
 104         && version_compare( PHPUnit_Runner_Version::id(), '3.6.7', '<' )
 105 ) {
 106         die( 'PHPUnit 3.6.7 or later required, you have ' . PHPUnit_Runner_Version::id() . ".\n" );
 107 }
 108 require_once( 'PHPUnit/Autoload.php' );
 109
 110 require_once( "$IP/tests/TestsAutoLoader.php" );
 111 MediaWikiPHPUnitCommand::main();