2009-08-02 19:35:17 +00:00
|
|
|
<?php
|
|
|
|
|
/**
|
|
|
|
|
* We want to make this whole thing as seamless as possible to the
|
|
|
|
|
* end-user. Unfortunately, we can't do _all_ of the work in the class
|
2010-06-30 04:25:23 +00:00
|
|
|
* because A) included files are not in global scope, but in the scope
|
2009-08-02 19:35:17 +00:00
|
|
|
* of their caller, and B) MediaWiki has way too many globals. So instead
|
|
|
|
|
* we'll kinda fake it, and do the requires() inline. <3 PHP
|
|
|
|
|
*
|
|
|
|
|
* This program is free software; you can redistribute it and/or modify
|
|
|
|
|
* it under the terms of the GNU General Public License as published by
|
|
|
|
|
* the Free Software Foundation; either version 2 of the License, or
|
|
|
|
|
* (at your option) any later version.
|
|
|
|
|
*
|
|
|
|
|
* This program is distributed in the hope that it will be useful,
|
|
|
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
|
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
|
|
|
* GNU General Public License for more details.
|
|
|
|
|
*
|
|
|
|
|
* You should have received a copy of the GNU General Public License along
|
|
|
|
|
* with this program; if not, write to the Free Software Foundation, Inc.,
|
|
|
|
|
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
|
|
|
|
|
* http://www.gnu.org/copyleft/gpl.html
|
|
|
|
|
*
|
|
|
|
|
* @file
|
|
|
|
|
* @ingroup Maintenance
|
|
|
|
|
*/
|
2016-10-17 18:21:40 +00:00
|
|
|
use MediaWiki\MediaWikiServices;
|
2009-08-02 19:35:17 +00:00
|
|
|
|
2011-01-13 22:58:55 +00:00
|
|
|
if ( !defined( 'RUN_MAINTENANCE_IF_MAIN' ) ) {
|
2009-09-04 06:51:38 +00:00
|
|
|
echo "This file must be included after Maintenance.php\n";
|
|
|
|
|
exit( 1 );
|
|
|
|
|
}
|
|
|
|
|
|
2011-01-13 22:58:55 +00:00
|
|
|
// Wasn't included from the file scope, halt execution (probably wanted the class)
|
2020-09-23 10:52:01 +00:00
|
|
|
// If a class is using CommandLineInc (old school maintenance), they definitely
|
2011-01-14 02:13:30 +00:00
|
|
|
// cannot be included and will proceed with execution
|
2020-06-15 10:46:22 +00:00
|
|
|
// @phan-suppress-next-line PhanSuspiciousValueComparisonInGlobalScope
|
2018-01-13 00:02:09 +00:00
|
|
|
if ( !Maintenance::shouldExecute() && $maintClass != CommandLineInc::class ) {
|
2011-01-13 22:58:55 +00:00
|
|
|
return;
|
|
|
|
|
}
|
|
|
|
|
|
2020-06-15 10:46:22 +00:00
|
|
|
// @phan-suppress-next-line PhanImpossibleConditionInGlobalScope
|
2010-05-22 16:50:39 +00:00
|
|
|
if ( !$maintClass || !class_exists( $maintClass ) ) {
|
2010-01-25 03:46:31 +00:00
|
|
|
echo "\$maintClass is not set or is set to a non-existent class.\n";
|
2009-09-04 06:51:38 +00:00
|
|
|
exit( 1 );
|
2009-08-02 19:35:17 +00:00
|
|
|
}
|
|
|
|
|
|
2020-04-12 20:29:32 +00:00
|
|
|
// Define the MediaWiki entrypoint
|
|
|
|
|
define( 'MEDIAWIKI', true );
|
|
|
|
|
|
|
|
|
|
// This environment variable is ensured present by Maintenance.php.
|
|
|
|
|
$IP = getenv( 'MW_INSTALL_PATH' );
|
|
|
|
|
|
2010-11-27 15:35:57 +00:00
|
|
|
// Get an object to start us off
|
2014-08-07 20:57:14 +00:00
|
|
|
/** @var Maintenance $maintenance */
|
2010-11-27 15:35:57 +00:00
|
|
|
$maintenance = new $maintClass();
|
|
|
|
|
|
2021-11-19 23:19:42 +00:00
|
|
|
// Basic checks and such
|
2010-11-27 15:35:57 +00:00
|
|
|
$maintenance->setup();
|
|
|
|
|
|
|
|
|
|
// We used to call this variable $self, but it was moved
|
|
|
|
|
// to $maintenance->mSelf. Keep that here for b/c
|
|
|
|
|
$self = $maintenance->getName();
|
|
|
|
|
|
2017-09-19 19:24:19 +00:00
|
|
|
// Define how settings are loaded (e.g. LocalSettings.php)
|
|
|
|
|
if ( !defined( 'MW_CONFIG_CALLBACK' ) && !defined( 'MW_CONFIG_FILE' ) ) {
|
|
|
|
|
define( 'MW_CONFIG_FILE', $maintenance->loadSettings() );
|
2009-08-02 19:35:17 +00:00
|
|
|
}
|
2010-06-27 21:48:51 +00:00
|
|
|
|
2017-09-19 19:24:19 +00:00
|
|
|
// Custom setup for Maintenance entry point
|
|
|
|
|
if ( !defined( 'MW_SETUP_CALLBACK' ) ) {
|
2019-05-11 01:17:43 +00:00
|
|
|
|
2022-01-26 17:24:31 +00:00
|
|
|
function wfMaintenanceSetup() {
|
|
|
|
|
global $maintenance, $wgLocalisationCacheConf, $wgCacheDirectory;
|
2017-09-19 19:24:19 +00:00
|
|
|
if ( $maintenance->getDbType() === Maintenance::DB_NONE ) {
|
2022-01-26 17:24:31 +00:00
|
|
|
if ( $wgLocalisationCacheConf['storeClass'] === false
|
|
|
|
|
&& ( $wgLocalisationCacheConf['store'] == 'db'
|
|
|
|
|
|| ( $wgLocalisationCacheConf['store'] == 'detect' && !$wgCacheDirectory ) )
|
2017-09-19 19:24:19 +00:00
|
|
|
) {
|
2022-01-26 17:24:31 +00:00
|
|
|
$wgLocalisationCacheConf['storeClass'] = LCStoreNull::class;
|
2017-09-19 19:24:19 +00:00
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
|
2022-01-26 17:24:31 +00:00
|
|
|
$maintenance->finalSetup();
|
2013-04-18 18:48:44 +00:00
|
|
|
}
|
2019-05-11 01:17:43 +00:00
|
|
|
|
2017-09-19 19:24:19 +00:00
|
|
|
define( 'MW_SETUP_CALLBACK', 'wfMaintenanceSetup' );
|
2012-06-26 16:58:37 +00:00
|
|
|
}
|
2014-08-07 20:57:14 +00:00
|
|
|
|
2013-08-08 03:18:34 +00:00
|
|
|
require_once "$IP/includes/Setup.php";
|
2009-08-02 19:35:17 +00:00
|
|
|
|
2015-03-04 07:51:44 +00:00
|
|
|
// Initialize main config instance
|
2016-11-22 23:39:22 +00:00
|
|
|
$maintenance->setConfig( MediaWikiServices::getInstance()->getMainConfig() );
|
2015-03-04 07:51:44 +00:00
|
|
|
|
2021-11-19 23:19:42 +00:00
|
|
|
// Double check required extensions are installed
|
2016-07-28 21:44:06 +00:00
|
|
|
$maintenance->checkRequiredExtensions();
|
|
|
|
|
|
2021-03-02 17:41:53 +00:00
|
|
|
if ( $maintenance->getDbType() == Maintenance::DB_NONE ) {
|
|
|
|
|
// Be strict with maintenance tasks that claim to not need a database by
|
|
|
|
|
// disabling the storage backend.
|
|
|
|
|
MediaWikiServices::disableStorageBackend();
|
2021-03-02 00:07:44 +00:00
|
|
|
}
|
2016-08-28 16:06:57 +00:00
|
|
|
|
2019-03-22 02:52:11 +00:00
|
|
|
$maintenance->validateParamsAndArgs();
|
|
|
|
|
|
2009-08-02 19:35:17 +00:00
|
|
|
// Do the work
|
2018-12-09 21:22:17 +00:00
|
|
|
try {
|
|
|
|
|
$success = $maintenance->execute();
|
|
|
|
|
} catch ( Exception $ex ) {
|
|
|
|
|
$success = false;
|
2019-07-16 11:15:57 +00:00
|
|
|
$exReportMessage = '';
|
2018-12-09 21:22:17 +00:00
|
|
|
while ( $ex ) {
|
|
|
|
|
$cls = get_class( $ex );
|
2019-07-16 11:15:57 +00:00
|
|
|
$exReportMessage .= "$cls from line {$ex->getLine()} of {$ex->getFile()}: {$ex->getMessage()}\n";
|
|
|
|
|
$exReportMessage .= $ex->getTraceAsString() . "\n";
|
2018-12-09 21:22:17 +00:00
|
|
|
$ex = $ex->getPrevious();
|
|
|
|
|
}
|
2019-07-16 11:15:57 +00:00
|
|
|
// Print the exception to stderr if possible, don't mix it in
|
|
|
|
|
// with stdout output.
|
|
|
|
|
if ( defined( 'STDERR' ) ) {
|
|
|
|
|
fwrite( STDERR, $exReportMessage );
|
|
|
|
|
} else {
|
|
|
|
|
echo $exReportMessage;
|
|
|
|
|
}
|
2018-12-09 21:22:17 +00:00
|
|
|
}
|
2009-12-03 21:47:52 +00:00
|
|
|
|
2015-02-03 18:18:56 +00:00
|
|
|
// Potentially debug globals
|
|
|
|
|
$maintenance->globals();
|
2013-01-31 14:36:29 +00:00
|
|
|
|
2020-05-06 14:37:00 +00:00
|
|
|
$maintenance->shutdown();
|
2018-05-20 14:26:46 +00:00
|
|
|
|
|
|
|
|
// Exit with an error status if execute() returned false
|
|
|
|
|
if ( $success === false ) {
|
|
|
|
|
exit( 1 );
|
|
|
|
|
}
|