tests/phpunit/phpunit.php

   1 #!/usr/bin/env php
   2 <?php
   3 /**
   4  * Bootstrapping for MediaWiki PHPUnit tests
   5  *
   6  * @file
   7  */
   8
   9 use MediaWiki\MediaWikiServices;
  10 use MediaWiki\Registration\ExtensionRegistry;
  11 use PHPUnit\TextUI\Command;
  12
  13 class PHPUnitMaintClass {
  14         public function setup() {
  15                 // Set a flag which can be used to detect when other scripts have been entered
  16                 // through this entry point or not.
  17                 define( 'MW_PHPUNIT_TEST', true );
  18
  19                 // Send PHP warnings and errors to stderr instead of stdout.
  20                 // This aids in diagnosing problems, while keeping messages
  21                 // out of redirected output.
  22                 if ( ini_get( 'display_errors' ) ) {
  23                         ini_set( 'display_errors', 'stderr' );
  24                 }
  25
  26                 $this->prepareEnvironment();
  27                 require_once __DIR__ . '/../common/TestSetup.php';
  28                 TestSetup::snapshotGlobals();
  29         }
  30
  31         public function prepareEnvironment() {
  32                 # Disable the memory limit as it's not needed for tests.
  33                 ini_set( 'memory_limit', -1 );
  34
  35                 # Set max execution time to 0 (no limit). PHP.net says that
  36                 # "When running PHP from the command line the default setting is 0."
  37                 # But sometimes this doesn't seem to be the case.
  38                 ini_set( 'max_execution_time', 0 );
  39
  40                 # Turn off output buffering if it's on
  41                 while ( ob_get_level() > 0 ) {
  42                         ob_end_flush();
  43                 }
  44         }
  45
  46         public function finalSetup() {
  47                 global $wgDBadminuser, $wgDBadminpassword;
  48                 global $wgDBuser, $wgDBpassword, $wgDBservers, $wgLBFactoryConf;
  49
  50                 # Prepare environment again, things might have changed in the settings files
  51                 $this->prepareEnvironment();
  52
  53                 if ( isset( $wgDBadminuser ) ) {
  54                         $wgDBuser = $wgDBadminuser;
  55                         $wgDBpassword = $wgDBadminpassword;
  56
  57                         if ( $wgDBservers ) {
  58                                 /**
  59                                  * @var array $wgDBservers
  60                                  */
  61                                 foreach ( $wgDBservers as $i => $server ) {
  62                                         $wgDBservers[$i]['user'] = $wgDBuser;
  63                                         $wgDBservers[$i]['password'] = $wgDBpassword;
  64                                 }
  65                         }
  66                         if ( isset( $wgLBFactoryConf['serverTemplate'] ) ) {
  67                                 $wgLBFactoryConf['serverTemplate']['user'] = $wgDBuser;
  68                                 $wgLBFactoryConf['serverTemplate']['password'] = $wgDBpassword;
  69                         }
  70                         $service = MediaWikiServices::getInstance()->peekService( 'DBLoadBalancerFactory' );
  71                         if ( $service ) {
  72                                 $service->destroy();
  73                         }
  74                 }
  75
  76                 require_once __DIR__ . '/../common/TestsAutoLoader.php';
  77
  78                 TestSetup::applyInitialConfig();
  79
  80                 ExtensionRegistry::getInstance()->setLoadTestClassesAndNamespaces( true );
  81         }
  82
  83         public function execute() {
  84                 // Start an output buffer to avoid headers being sent by constructors,
  85                 // data providers, etc. (T206476)
  86                 ob_start();
  87
  88                 fwrite( STDERR, 'Using PHP ' . PHP_VERSION . "\n" );
  89
  90                 $command = new Command();
  91                 $args = $_SERVER['argv'];
  92                 $knownOpts = getopt( 'c:', [ 'configuration:', 'bootstrap:' ] ) ?: [];
  93                 if ( !isset( $knownOpts['c'] ) && !isset( $knownOpts['configuration'] ) ) {
  94                         // XXX HAX: Use our default file. This is a temporary hack, to be removed when this file goes away
  95                         // or when T227900 is resolved.
  96                         $args[] = '--configuration=' . __DIR__ . '/suite.xml';
  97                 }
  98                 $args[] = '--bootstrap=' . __DIR__ . '/bootstrap.maintenance.php';
  99                 $command->run( $args, true );
 100         }
 101 }
 102
 103 $deprecationMsg = <<<EOT
 104 *******************************************************************************
 105 DEPRECATED: The tests/phpunit/phpunit.php entry point has been deprecated. Use
 106             `composer phpunit` instead.
 107 *******************************************************************************
 108
 109 EOT;
 110
 111 fwrite( STDERR, $deprecationMsg );
 112
 113 if ( defined( 'MEDIAWIKI' ) ) {
 114         exit( 'Wrong entry point?' );
 115 }
 116
 117 if ( PHP_SAPI !== 'cli' && PHP_SAPI !== 'phpdbg' ) {
 118         exit( 'This script must be run from the command line' );
 119 }
 120
 121 define( 'MW_ENTRY_POINT', 'cli' );
 122
 123 if ( strval( getenv( 'MW_INSTALL_PATH' ) ) === '' ) {
 124         putenv( 'MW_INSTALL_PATH=' . realpath( __DIR__ . '/../..' ) );
 125 }
 126
 127 if ( getenv( 'PHPUNIT_WIKI' ) ) {
 128         $wikiName = getenv( 'PHPUNIT_WIKI' );
 129         $bits = explode( '-', $wikiName, 2 );
 130         define( 'MW_DB', $bits[0] );
 131         define( 'MW_PREFIX', $bits[1] ?? '' );
 132         define( 'MW_WIKI_NAME', $wikiName );
 133 }
 134
 135 // Define the MediaWiki entrypoint
 136 define( 'MEDIAWIKI', true );
 137
 138 define( 'PHPUNIT_LEGACY_ENTRYPOINT', true );
 139
 140 $IP = getenv( 'MW_INSTALL_PATH' );
 141
 142 $wrapper = new PHPUnitMaintClass();
 143 $wrapper->setup();
 144
 145 require_once "$IP/includes/BootstrapHelperFunctions.php";
 146
 147 $IP = wfDetectInstallPath(); // ensure MW_INSTALL_PATH is defined
 148 wfDetectLocalSettingsFile( $IP );
 149
 150 function wfPHPUnitSetup() {
 151         // phpcs:ignore MediaWiki.NamingConventions.ValidGlobalName.allowedPrefix
 152         global $wrapper;
 153         $wrapper->finalSetup();
 154 }
 155
 156 define( 'MW_SETUP_CALLBACK', 'wfPHPUnitSetup' );
 157
 158 require_once "$IP/includes/Setup.php";
 159 // Deregister handler from MWExceptionHandler::installHandle so that PHPUnit's own handler
 160 // stays in tact. Needs to happen after including Setup.php, which calls MWExceptionHandler::installHandle().
 161 restore_error_handler();
 162
 163 // Check that composer dependencies are up-to-date
 164 if ( !getenv( 'MW_SKIP_EXTERNAL_DEPENDENCIES' ) ) {
 165         $composerLockUpToDate = new CheckComposerLockUpToDate();
 166         $composerLockUpToDate->loadParamsAndArgs( 'phpunit', [ 'quiet' => true ] );
 167         $composerLockUpToDate->execute();
 168 }
 169
 170 $wrapper->execute();