#!/usr/bin/env php setAllowUnregisteredOptions( true ); $this->addOption( 'use-filebackend', 'Use filebackend', false, true ); $this->addOption( 'use-bagostuff', 'Use bagostuff', false, true ); $this->addOption( 'use-jobqueue', 'Use jobqueue', false, true ); $this->addOption( 'use-normal-tables', 'Use normal DB tables.', false, false ); $this->addOption( 'reuse-db', 'Init DB only if tables are missing and keep after finish.', false, false ); } public function setup() { // Set a flag which can be used to detect when other scripts have been entered // through this entry point or not. define( 'MW_PHPUNIT_TEST', true ); parent::setup(); require_once __DIR__ . '/../common/TestSetup.php'; TestSetup::snapshotGlobals(); } public function finalSetup() { parent::finalSetup(); // Inject test autoloader self::requireTestsAutoloader(); TestSetup::applyInitialConfig(); ExtensionRegistry::getInstance()->setLoadTestClassesAndNamespaces( true ); } public function execute() { // Deregister handler from MWExceptionHandler::installHandle so that PHPUnit's own handler // stays in tact. // Has to in execute() instead of finalSetup(), because finalSetup() runs before // doMaintenance.php includes Setup.php, which calls MWExceptionHandler::installHandle(). restore_error_handler(); $this->forceFormatServerArgv(); if ( !class_exists( 'PHPUnit\\Framework\\TestCase' ) ) { echo "PHPUnit not found. Please install it and other dev dependencies by running `composer install` in MediaWiki root directory.\n"; exit( 1 ); } // Start an output buffer to avoid headers being sent by constructors, // data providers, etc. (T206476) ob_start(); fwrite( STDERR, 'Using PHP ' . PHP_VERSION . "\n" ); foreach ( MediaWikiCliOptions::$additionalOptions as $option => $default ) { MediaWikiCliOptions::$additionalOptions[$option] = $this->getOption( $option ); } $command = new MediaWikiPHPUnitCommand(); $command->run( $_SERVER['argv'], true ); } public function getDbType() { return Maintenance::DB_ADMIN; } protected function addOption( $name, $description, $required = false, $withArg = false, $shortName = false, $multiOccurrence = false ) { // ignore --quiet which does not really make sense for unit tests if ( $name !== 'quiet' ) { parent::addOption( $name, $description, $required, $withArg, $shortName, $multiOccurrence ); } } /** * Force the format of elements in $_SERVER['argv'] * - Split args such as "wiki=enwiki" into two separate arg elements "wiki" and "enwiki" */ private function forceFormatServerArgv() { $argv = []; for ( $key = 0; $key < count( $_SERVER['argv'] ); $key++ ) { $arg = $_SERVER['argv'][$key]; if ( $key === 0 ) { $argv[0] = $arg; continue; } if ( preg_match( '/^--(.*)$/', $arg, $match ) ) { $opt = $match[1]; $parts = explode( '=', $opt, 2 ); $opt = $parts[0]; // Avoid confusing PHPUnit with MediaWiki-specific parameters if ( isset( $this->mParams[$opt] ) ) { if ( $this->mParams[$opt]['withArg'] && !isset( $parts[1] ) ) { // skip the value after the option name as well $key++; } continue; } } $argv[] = $arg; } $_SERVER['argv'] = $argv; } protected function showHelp() { parent::showHelp(); $this->output( "PHPUnit options are also accepted:\n\n" ); $command = new MediaWikiPHPUnitCommand(); $command->publicShowHelp(); } } $maintClass = PHPUnitMaintClass::class; require_once RUN_MAINTENANCE_IF_MAIN;