phpunit.php

Go to the documentation of this file.

#!/usr/bin/env php
<?php
// 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 );

// Start up MediaWiki in command-line mode
require_once dirname( dirname( __DIR__ ) ) . "/maintenance/Maintenance.php";

class PHPUnitMaintClass extends Maintenance {

    public function __construct() {
        parent::__construct();
        $this->addOption( 'with-phpunitdir',
            'Directory to include PHPUnit from, for example when using a git fetchout from upstream. Path will be prepended to PHP `include_path`.',
            false, # not required
            true # need arg
        );
    }

    public function finalSetup() {
        parent::finalSetup();

        global $wgMainCacheType, $wgMessageCacheType, $wgParserCacheType;
        global $wgLanguageConverterCacheType, $wgUseDatabaseMessages;
        global $wgLocaltimezone, $wgLocalisationCacheConf;
        global $wgDevelopmentWarnings;

        // Inject test autoloader
        require_once __DIR__ . '/../TestsAutoLoader.php';

        // wfWarn should cause tests to fail
        $wgDevelopmentWarnings = true;

        $wgMainCacheType = CACHE_NONE;
        $wgMessageCacheType = CACHE_NONE;
        $wgParserCacheType = CACHE_NONE;
        $wgLanguageConverterCacheType = CACHE_NONE;

        $wgUseDatabaseMessages = false; # Set for future resets

        // Assume UTC for testing purposes
        $wgLocaltimezone = 'UTC';

        $wgLocalisationCacheConf['storeClass'] = 'LCStoreNull';

        // Bug 44192 Do not attempt to send a real e-mail
        Hooks::clear( 'AlternateUserMailer' );
        Hooks::register(
            'AlternateUserMailer',
            function () {
                return false;
            }
        );
    }

    public function execute() {
        global $IP;

        # Make sure we have --configuration or PHPUnit might complain
        if ( !in_array( '--configuration', $_SERVER['argv'] ) ) {
            //Hack to eliminate the need to use the Makefile (which sucks ATM)
            array_splice( $_SERVER['argv'], 1, 0,
                array( '--configuration', $IP . '/tests/phpunit/suite.xml' ) );
        }

        # --with-phpunitdir let us override the default PHPUnit version
        if ( $this->hasOption( 'with-phpunitdir' ) ) {
            $phpunitDir = $this->getOption( 'with-phpunitdir' );
            # Sanity checks
            if ( !is_dir( $phpunitDir ) ) {
                $this->error( "--with-phpunitdir should be set to an existing directory", 1 );
            }
            if ( !is_readable( $phpunitDir . "/PHPUnit/Runner/Version.php" ) ) {
                $this->error( "No usable PHPUnit installation in $phpunitDir.\nAborting.\n", 1 );
            }

            # Now prepends provided PHPUnit directory
            $this->output( "Will attempt loading PHPUnit from `$phpunitDir`\n" );
            set_include_path( $phpunitDir . PATH_SEPARATOR . get_include_path() );

            # Cleanup $args array so the option and its value do not
            # pollute PHPUnit
            $key = array_search( '--with-phpunitdir', $_SERVER['argv'] );
            unset( $_SERVER['argv'][$key] ); // the option
            unset( $_SERVER['argv'][$key + 1] ); // its value
            $_SERVER['argv'] = array_values( $_SERVER['argv'] );
        }
    }

    public function getDbType() {
        return Maintenance::DB_ADMIN;
    }
}

$maintClass = 'PHPUnitMaintClass';
require RUN_MAINTENANCE_IF_MAIN;

if ( !class_exists( 'PHPUnit_Runner_Version' ) ) {
    require_once 'PHPUnit/Runner/Version.php';
}

if ( PHPUnit_Runner_Version::id() !== '@package_version@'
    && version_compare( PHPUnit_Runner_Version::id(), '3.7.0', '<' )
) {
    die( 'PHPUnit 3.7.0 or later required, you have ' . PHPUnit_Runner_Version::id() . ".\n" );
}

if ( !class_exists( 'PHPUnit_TextUI_Command' ) ) {
    require_once 'PHPUnit/Autoload.php';
}

// Prevent segfault when we have lots of unit tests (bug 62623)
if ( version_compare( PHP_VERSION, '5.4.0', '<' )
    && version_compare( PHP_VERSION, '5.3.0', '>=' )
) {
    register_shutdown_function( function() {
        gc_collect_cycles();
        gc_disable();
    } );
}

MediaWikiPHPUnitCommand::main();