Abstract maintenance class for quickly writing and churning out maintenance scripts with minimal effort. More...

Inherited by AddChangeTag, AddSite, AllTrans, AttachLatest, BackupDumper, BackupReader, Benchmarker, BenchmarkParse, CategoryChangesAsRdf, CdbInspector, ChangePassword, CheckBadRedirects, CheckComposerLockUpToDate, CheckDependencies, CheckImages, CheckLess, CheckUsernames, CleanupAncientTables, CleanupBlocks, CleanupInvalidDbKeys, CleanupPreferences, CleanupRemovedModules, CleanupSpam, CleanupUploadStash, ClearInterwikiCache, CLIParser, CommandLineInc, CommandLineInstaller, CompareParserCache, CompressOld, ConvertExtensionToRegistration, ConvertLinks, ConvertUserOptions, CopyFileBackend, CopyJobQueue, CreateAndPromote, CreateCommonPasswordCdb, DatabaseLag, DateFormats, DeleteArchivedFiles, DeleteArchivedRevisions, DeleteAutoPatrolLogs, DeleteBatch, DeleteDefaultMessages, DeleteEqualMessages, DeleteLocalPasswords, DeleteOldRevisions, DeleteOrphanedRevisions, DeleteSelfExternals, DeleteTag, Digit2Html, DumpCategoriesAsRdf, DumpIterator, DumpLinks, DumpMessages, DumpRenderer, DumpRev, DumpUploads, EditCLI, EmptyUserGroup, EraseArchivedFile, ExportSites, FakeMaintenance, FetchText, FileOpPerfTest, FindDeprecated, FindHooks, FindMissingFiles, FindOrphanedFiles, FixDoubleRedirects, FixTimestamps, FixUserRegistration, FormatInstallDoc, GenerateCollationData, GenerateJsonI18n, GenerateNormalizerDataAr, GenerateNormalizerDataMl, GeneratePhpCharToUpperMappings, GenerateUcfirstOverrides, GenerateUpperCharTable, GetConfiguration, GetLagTimes, GetReplicaServer, GetTextMaint, ImageBuilder, ImportImages, ImportSites, ImportSiteScripts, ImportTextFiles, InitEditCount, InitSiteStats, InitUserPreference, InvalidateUserSesssions, JSParseHelper, LangMemUsage, ListVariants, LoggedUpdateMaintenance, MakeTestEdits, ManageForeignResources, ManageJobs, McTest, MediaWikiShell, MergeMessageFileList, MigrateFileRepoLayout, MigrateUserGroup, MinifyScript, MoveBatch, MWDocGen, MwSql, MysqlMaintenance, NamespaceDupes, NukeNS, NukePage, Orphans, OrphanStats, PageExists, PatchSql, PopulateCategory, PopulateContentModel, PopulateContentTables, PopulateInterwiki, Protect, PruneFileCache, PurgeChangedFiles, PurgeChangedPages, PurgeExpiredUserrights, PurgeList, PurgeModuleDeps, PurgeOldText, PurgePage, PurgeParserCache, ReassignEdits, RebuildAll, RebuildFileCache, RebuildLocalisationCache, RebuildMessages, RebuildRecentchanges, RebuildTextIndex, RecountCategories, RefreshFileHeaders, RefreshImageMetadata, RefreshLinks, RemoveInvalidEmails, RemoveUnusedAccounts, RenameDbPrefix, RenameRestrictions, ResetAuthenticationThrottle, ResetPageRandom, ResetUserEmail, ResetUserTokens, RollbackEdits, RunBatchedQuery, RunJobs, ShowJobs, ShowSiteStats, SqliteMaintenance, StorageTypeStats, SyncFileBackend, TableCleanup, TidyUpT39714, Undelete, UpdateArticleCount, UpdateCollation, UpdateDoubleWidthSearch, UpdateExtensionJsonSchema, UpdateMediaWiki, UpdateRestrictions, UpdateSearchIndex, UpdateSpecialPages, UppercaseTitlesForUnicodeTransition, UserOptionsMaintenance, ValidateRegistrationFile, ViewCLI, and WrapOldPasswords.

Collaboration diagram for Maintenance:

[legend]

Public Member Functions
	__construct ()
	Default constructor. More...

	checkRequiredExtensions ()
	Verify that the required extensions are installed. More...

	cleanupChanneled ()
	Clean up channeled output. More...

	clearParamsAndArgs ()
	Clear all params and arguments. More...

	execute ()
	Do the actual work. More...

	finalSetup ()
	Handle some last-minute setup here. More...

	getConfig ()

	getDbType ()
	Does the script need different DB access? By default, we give Maintenance scripts normal rights to the DB. More...

	getName ()
	Get the script's name. More...

	globals ()
	Potentially debug globals. More...

	isQuiet ()

	loadParamsAndArgs ( $self=null, $opts=null, $args=null)
	Process command line arguments $mOptions becomes an array with keys set to the option names $mArgs becomes a zero-based array containing the non-option arguments. More...

	loadSettings ()
	Generic setup for most installs. More...

	loadWithArgv ( $argv)
	Load params and arguments from a given array of command-line arguments. More...

	memoryLimit ()
	Normally we disable the memory_limit when running admin scripts. More...

	outputChanneled ( $msg, $channel=null)
	Message outputter with channeled message support. More...

	purgeRedundantText ( $delete=true)
	Support function for cleaning up redundant text records. More...

	runChild ( $maintClass, $classFile=null)
	Run a child maintenance script. More...

	setAgentAndTriggers ()
	Set triggers like when to try to run deferred updates. More...

	setConfig (Config $config)

	setDB (IMaintainableDatabase $db)
	Sets database object to be returned by getDB(). More...

	setup ()
	Do some sanity checking and basic setup. More...

	updateSearchIndex ( $maxLockTime, $callback, $dbw, $results)
	Perform a search index update with locking. More...

	updateSearchIndexForPage ( $dbw, $pageId)
	Update the searchindex table for a given pageid. More...

	validateParamsAndArgs ()
	Run some validation checks on the params, etc. More...

Static Public Member Functions
static	getTermSize ()
	Get the terminal size as a two-element array where the first element is the width (number of columns) and the second element is the height (number of rows). More...

static	posix_isatty ( $fd)
	Wrapper for posix_isatty() We default as considering stdin a tty (for nice readline methods) but treating stout as not a tty to avoid color codes. More...

static	readconsole ( $prompt='> ')
	Prompt the console for input. More...

static	requireTestsAutoloader ()
	Call this to set up the autoloader to allow classes to be used from the tests directory. More...

static	setLBFactoryTriggers (LBFactory $LBFactory, Config $config)

static	shouldExecute ()
	Should we execute the maintenance script, or just allow it to be included as a standalone class? It checks that the call stack only includes this function and "requires" (meaning was called from the file scope) More...

Public Attributes
resource	$fileHandle
	Used when creating separate schema files. More...

	$mDbPass

array	$orderedOptions = []
	Used to read the options in the order they were passed. More...

const	DB_ADMIN = 2

const	DB_NONE = 0
	Constants for DB access type. More...

const	DB_STD = 1

const	STDIN_ALL = 'all'

Protected Member Functions
	activateProfiler ()
	Activate the profiler (assuming $wgProfiler is set) More...

	addArg ( $arg, $description, $required=true)
	Add some args that are needed. More...

	addDefaultParams ()
	Add the default parameters to the scripts. More...

	addDescription ( $text)
	Set the description text. More...

	addOption ( $name, $description, $required=false, $withArg=false, $shortName=false, $multiOccurrence=false)
	Add a parameter to the script. More...

	adjustMemoryLimit ()
	Adjusts PHP's memory limit to better suit our needs, if needed. More...

	afterFinalSetup ()
	Execute a callback function at the end of initialisation. More...

	beginTransaction (IDatabase $dbw, $fname)
	Begin a transcation on a DB. More...

	commitTransaction (IDatabase $dbw, $fname)
	Commit the transcation on a DB handle and wait for replica DBs to catch up. More...

	countDown ( $seconds)
	Count down from $seconds to zero on the terminal, with a one-second pause between showing each number. More...

	deleteOption ( $name)
	Remove an option. More...

	error ( $err, $die=0)
	Throw an error to the user. More...

	fatalError ( $msg, $exitCode=1)
	Output a message and terminate the current script. More...

	getArg ( $argId=0, $default=null)
	Get an argument. More...

	getBatchSize ()
	Returns batch size. More...

	getDB ( $db, $groups=[], $dbDomain=false)
	Returns a database to be used by current maintenance script. More...

	getDir ()
	Get the maintenance directory. More...

	getOption ( $name, $default=null)
	Get an option, or return the default. More...

	getStdin ( $len=null)
	Return input from stdin. More...

	hasArg ( $argId=0)
	Does a given argument exist? More...

	hasOption ( $name)
	Checks to see if a particular option exists. More...

	loadSpecialVars ()
	Handle the special variables that are global to all scripts. More...

	maybeHelp ( $force=false)
	Maybe show the help. More...

	output ( $out, $channel=null)
	Throw some output to the user. More...

	requireExtension ( $name)
	Indicate that the specified extension must be loaded before the script can run. More...

	rollbackTransaction (IDatabase $dbw, $fname)
	Rollback the transcation on a DB handle. More...

	setAllowUnregisteredOptions ( $allow)
	Sets whether to allow unregistered options, which are options passed to a script that do not match an expected parameter. More...

	setBatchSize ( $s=0)
	Set the batch size. More...

	showHelp ()
	Definitely show the help. More...

	supportsOption ( $name)
	Checks to see if a particular option in supported. More...

Protected Attributes
	$mAllowUnregisteredOptions = false

	$mArgList = []

	$mArgs = []

int	$mBatchSize = null
	Batch size. More...

	$mDbUser

	$mDescription = ''

	$mInputLoaded = false

	$mOptions = []

array[]	$mParams = []
	Array of desired/allowed params. More...

	$mQuiet = false

	$mSelf

	$mShortParamsMap = []

Private Member Functions
	lockSearchindex ( $db)
	Lock the search index. More...

	relockSearchindex ( $db)
	Unlock and lock again Since the lock is low-priority, queued reads will be able to complete. More...

	setParam (&$options, $option, $value)
	Helper function used solely by loadParamsAndArgs to prevent code duplication. More...

	unlockSearchindex ( $db)
	Unlock the tables. More...

Static Private Member Functions
static	readlineEmulation ( $prompt)
	Emulate readline() More...

Private Attributes
	$atLineStart = true

Config	$config
	Accessible via getConfig() More...

	$lastChannel = null

float	$lastReplicationWait = 0.0
	UNIX timestamp. More...

IMaintainableDatabase	$mDb = null
	Used by getDB() / setDB() More...

array[]	$mDependantParameters = []
	Generic options which might or not be supported by the script. More...

array[]	$mGenericParameters = []
	Generic options added by addDefaultParams() More...

array	$requiredExtensions = []

Detailed Description

Abstract maintenance class for quickly writing and churning out maintenance scripts with minimal effort.

All that must be defined is the execute() method. See docs/maintenance.txt for more info and a quick demo of how to use it.

Terminology: params: registry of named values that may be passed to the script arg list: registry of positional values that may be passed to the script options: passed param values args: passed positional values

In the command: mwscript somescript.php –foo=bar baz foo is a param bar is the option value of the option for param foo baz is the arg value at index 0 in the arg list

Since: 1.16

Definition at line 86 of file Maintenance.php.

Constructor & Destructor Documentation

◆ __construct()

Maintenance::__construct ( )

Default constructor.

Children should call this first if implementing their own constructors

Reimplemented in LoggedUpdateMaintenance, SearchDump, FindDeprecated, CategoryChangesAsRdf, ImageBuilder, MWDocGen, UppercaseTitlesForUnicodeTransition, CLIParser, PurgeChangedFiles, BenchmarkTitleValue, PopulateContentTables, BackupReader, ConvertExtensionToRegistration, CompareParsers, FindHooks, GenerateCollationData, CompressOld, CleanupInvalidDbKeys, NamespaceDupes, PreprocessDump, DeleteLocalPasswords, GetConfiguration, BenchmarkParse, CleanupWatchlist, MediaWikiShell, CleanupImages, MoveBatch, CleanupCaps, RefreshImageMetadata, DumpRenderer, Benchmarker, TableCleanup, NukeNS, RecountCategories, RebuildLocalisationCache, ShowJobs, UpdateCollation, CopyFileBackend, Orphans, DeleteBatch, DumpCategoriesAsRdf, DumpIterator, Digit2Html, RebuildRecentchanges, CreateCommonPasswordCdb, DumpLinks, ImportImages, GenerateNormalizerDataAr, PopulateLogSearch, PurgeList, RefreshLinks, CommandLineInc, PopulateArchiveRevId, RebuildTextIndex, RunJobs, ShowSiteStats, UpdateSearchIndex, CleanupUsersWithNoId, ConvertLinks, CommandLineInstaller, GenerateUcfirstOverrides, MergeMessageFileList, PopulateIpChanges, PurgeChangedPages, PurgeParserCache, UpdateMediaWiki, AttachLatest, CleanupRemovedModules, TitleCleanup, CleanupUploadStash, ConvertUserOptions, DumpUploads, FetchText, MigrateActors, PopulateContentModel, PopulateInterwiki, ResetAuthenticationThrottle, MwSql, BenchmarkDeleteTruncate, BenchHttpHttps, DeleteOrphanedRevisions, EraseArchivedFile, FixTimestamps, InvalidateUserSesssions, DateFormats, LangMemUsage, GeneratePhpCharToUpperMappings, PopulateRevisionLength, CheckUsernames, CleanupBlocks, CreateAndPromote, FixDoubleRedirects, GenerateJsonI18n, GetTextMaint, GenerateNormalizerDataMl, PopulateCategory, PopulateLogUsertext, PopulateRevisionSha1, RebuildFileCache, ResetUserTokens, RunBatchedQuery, SqliteMaintenance, DumpRev, UpdateArticleCount, UpdateRestrictions, WrapOldPasswords, AddChangeTag, BenchIfSwitch, BenchWfIsWindows, BenchWikimediaBaseConvert, ChangePassword, CleanupPreferences, CleanupSpam, CopyJobQueue, DeleteArchivedRevisions, FileOpPerfTest, FixDefaultJsonContentPages, FixExtLinksProtocolRelative, ImportSiteScripts, ImportTextFiles, ListVariants, MigrateArchiveText, MigrateComments, MinifyScript, MysqlMaintenance, PopulateImageSha1, PopulateParentId, PopulateRecentChangesSource, PruneFileCache, ReassignEdits, OrphanStats, SyncFileBackend, UpdateDoubleWidthSearch, UpdateSpecialPages, BenchmarkHooks, CheckDependencies, CleanupAncientTables, CleanupEmptyCategories, DeleteArchivedFiles, DeleteDefaultMessages, EditCLI, FormatInstallDoc, GetLagTimes, GetReplicaServer, InitSiteStats, JSParseHelper, DatabaseLag, DumpMessages, McTest, MigrateFileRepoLayout, NukePage, PopulateExternallinksIndex60, RefreshExternallinksIndex, RefreshFileHeaders, RemoveUnusedAccounts, RenameDbPrefix, RollbackEdits, UserOptionsMaintenance, ViewCLI, BenchmarkStringReplacement, ClearInterwikiCache, DeleteEqualMessages, DeleteOldRevisions, DeleteSelfExternals, FixUserRegistration, AllTrans, MigrateImageCommentTemp, PatchSql, PopulateFilearchiveSha1, PurgeOldText, RebuildAll, RenameRestrictions, ResetUserEmail, AddRFCandPMIDInterwiki, BenchmarkJavaScriptMinifier, BenchmarkJSMinPlus, BenchmarkLruHash, BenchmarkPurge, CdbInspector, CheckBadRedirects, CheckImages, ManageJobs, MigrateUserGroup, PopulateBacklinkNamespace, Protect, PurgeExpiredUserrights, PurgeModuleDeps, PurgePage, RebuildMessages, ResetPageRandom, CheckLess, MakeTestEdits, ManageForeignResources, PopulatePPSortKey, BenchmarkCSSMin, BenchmarkSanitizer, CompareParserCache, EmptyUserGroup, InitEditCount, GenerateUpperCharTable, PopulateChangeTagDef, DeleteAutoPatrolLogs, PageExists, Undelete, DeduplicateArchiveRevId, FindMissingFiles, FindOrphanedFiles, AddSite, RemoveInvalidEmails, InitUserPreference, ExportSites, ImportSites, CleanupRevActorPage, DeleteTag, CheckComposerLockUpToDate, BenchmarkTidy, UpdateExtensionJsonSchema, and ValidateRegistrationFile.

Definition at line 199 of file Maintenance.php.

References $IP, and addDefaultParams().

Member Function Documentation

◆ activateProfiler()

Maintenance::activateProfiler ( )

protected

Activate the profiler (assuming $wgProfiler is set)

Definition at line 836 of file Maintenance.php.

References $wgProfileLimit, $wgProfiler, $wgTrxProfilerLimits, getOption(), Profiler\instance(), and Profiler\replaceStubInstance().

Referenced by finalSetup().

◆ addArg()

Maintenance::addArg	(	$arg,
		$description,
		$required = `true`
	)

protected

Add some args that are needed.

Parameters

string	$arg	Name of the arg, like 'start'
string	$description	Short description of the arg
bool	$required	Is this required?

Definition at line 323 of file Maintenance.php.

Referenced by ValidateRegistrationFile\__construct(), UpdateExtensionJsonSchema\__construct(), DeleteTag\__construct(), ImportSites\__construct(), ExportSites\__construct(), AddSite\__construct(), Undelete\__construct(), PageExists\__construct(), EmptyUserGroup\__construct(), ManageForeignResources\__construct(), Protect\__construct(), CdbInspector\__construct(), MigrateUserGroup\__construct(), PatchSql\__construct(), RenameRestrictions\__construct(), ResetUserEmail\__construct(), EditCLI\__construct(), UserOptionsMaintenance\__construct(), ViewCLI\__construct(), JSParseHelper\__construct(), McTest\__construct(), FormatInstallDoc\__construct(), NukePage\__construct(), ReassignEdits\__construct(), MysqlMaintenance\__construct(), ImportTextFiles\__construct(), CleanupSpam\__construct(), ImportSiteScripts\__construct(), MinifyScript\__construct(), GetTextMaint\__construct(), GenerateJsonI18n\__construct(), DumpRev\__construct(), CreateAndPromote\__construct(), FixTimestamps\__construct(), CommandLineInstaller\__construct(), ConvertLinks\__construct(), ImportImages\__construct(), CreateCommonPasswordCdb\__construct(), RefreshLinks\__construct(), DeleteBatch\__construct(), MoveBatch\__construct(), BenchmarkParse\__construct(), ConvertExtensionToRegistration\__construct(), BackupReader\__construct(), and CLIParser\__construct().

◆ addDefaultParams()

Maintenance::addDefaultParams ( )

protected

Add the default parameters to the scripts.

Definition at line 574 of file Maintenance.php.

References $mParams, addOption(), and getDbType().

Referenced by __construct().

◆ addDescription()

Maintenance::addDescription ( $text )

protected

Set the description text.

Parameters

string $text The text of the description

Definition at line 352 of file Maintenance.php.

◆ addOption()

Maintenance::addOption	(	$name,
		$description,
		$required = `false`,
		$withArg = `false`,
		$shortName = `false`,
		$multiOccurrence = `false`
	)

protected

Add a parameter to the script.

Will be displayed on –help with the associated description

Parameters

string	$name	The name of the param (help, version, etc)
string	$description	The description of the param to show on –help
bool	$required	Is the param required?
bool	$withArg	Is an argument required with this option?
string \| bool	$shortName	Character to use as short name
bool	$multiOccurrence	Can this option be passed multiple times?

Definition at line 271 of file Maintenance.php.

◆ adjustMemoryLimit()

Maintenance::adjustMemoryLimit ( )

protected

Adjusts PHP's memory limit to better suit our needs, if needed.

Definition at line 823 of file Maintenance.php.

References memoryLimit().

Referenced by finalSetup(), and setup().

◆ afterFinalSetup()

Maintenance::afterFinalSetup ( )

protected

Execute a callback function at the end of initialisation.

Reimplemented in UpdateMediaWiki.

Definition at line 1261 of file Maintenance.php.

Referenced by finalSetup().

◆ beginTransaction()

Maintenance::beginTransaction	(	IDatabase	$dbw,
			$fname
	)

protected

Begin a transcation on a DB.

This method makes it clear that begin() is called from a maintenance script, which has outermost scope. This is safe, unlike $dbw->begin() called in other places.

Parameters

IDatabase	$dbw
string	$fname	Caller name

Since: 1.27

Definition at line 1437 of file Maintenance.php.

References Wikimedia\Rdbms\IDatabase\begin().

Referenced by CleanupSpam\cleanupArticle(), CompressOld\compressWithConcat(), CleanupPreferences\deleteByWhere(), NukePage\deleteRevisions(), DeduplicateArchiveRevId\doDBUpdates(), PopulatePPSortKey\doDBUpdates(), PopulateLogUsertext\doDBUpdates(), MigrateImageCommentTemp\doDBUpdates(), MigrateArchiveText\doDBUpdates(), DeleteOldRevisions\doDelete(), PopulateRevisionLength\doLenUpdates(), ReassignEdits\doReassignEdits(), PopulateRevisionSha1\doSha1LegacyUpdates(), PopulateRevisionSha1\doSha1Updates(), PurgeModuleDeps\execute(), MigrateUserGroup\execute(), NukePage\execute(), DeleteArchivedFiles\execute(), UpdateRestrictions\execute(), DeleteOrphanedRevisions\execute(), CleanupRemovedModules\execute(), WrapOldPasswords\execute(), NukeNS\execute(), MoveBatch\execute(), RebuildFileCache\execute(), UpdateCollation\execute(), RemoveUnusedAccounts\isInactiveAccount(), NamespaceDupes\mergePage(), MigrateComments\migrateToTemp(), MigrateActors\migrateToTemp(), CleanupImages\pokeFile(), PopulateContentTables\populateContentTablesForRowBatch(), and purgeRedundantText().

◆ checkRequiredExtensions()

Maintenance::checkRequiredExtensions ( )

Verify that the required extensions are installed.

Since: 1.28

Definition at line 651 of file Maintenance.php.

References fatalError(), and ExtensionRegistry\getInstance().

◆ cleanupChanneled()

Maintenance::cleanupChanneled ( )

Clean up channeled output.

Output a newline if necessary.

Definition at line 519 of file Maintenance.php.

Referenced by output(), and outputChanneled().

◆ clearParamsAndArgs()

Maintenance::clearParamsAndArgs ( )

Clear all params and arguments.

Definition at line 864 of file Maintenance.php.

◆ commitTransaction()

Maintenance::commitTransaction	(	IDatabase	$dbw,
			$fname
	)

protected

Commit the transcation on a DB handle and wait for replica DBs to catch up.

This method makes it clear that commit() is called from a maintenance script, which has outermost scope. This is safe, unlike $dbw->commit() called in other places.

Parameters

IDatabase	$dbw
string	$fname	Caller name

Returns: bool Whether the replica DB wait succeeded

Since: 1.27

Definition at line 1452 of file Maintenance.php.

References Wikimedia\Rdbms\IDatabase\commit().

Referenced by CleanupSpam\cleanupArticle(), CompressOld\compressWithConcat(), CleanupPreferences\deleteByWhere(), NukePage\deleteRevisions(), DeduplicateArchiveRevId\doDBUpdates(), PopulatePPSortKey\doDBUpdates(), PopulateLogUsertext\doDBUpdates(), MigrateImageCommentTemp\doDBUpdates(), MigrateArchiveText\doDBUpdates(), DeleteOldRevisions\doDelete(), PopulateRevisionLength\doLenUpdates(), ReassignEdits\doReassignEdits(), PopulateRevisionSha1\doSha1LegacyUpdates(), PopulateRevisionSha1\doSha1Updates(), DeleteSelfExternals\execute(), PurgeModuleDeps\execute(), MigrateUserGroup\execute(), NukePage\execute(), DeleteArchivedFiles\execute(), UpdateRestrictions\execute(), DeleteOrphanedRevisions\execute(), CleanupRemovedModules\execute(), WrapOldPasswords\execute(), NukeNS\execute(), MoveBatch\execute(), RebuildFileCache\execute(), UpdateCollation\execute(), RemoveUnusedAccounts\isInactiveAccount(), NamespaceDupes\mergePage(), MigrateComments\migrateToTemp(), MigrateActors\migrateToTemp(), CleanupImages\pokeFile(), PopulateContentTables\populateContentTablesForRowBatch(), and purgeRedundantText().

◆ countDown()

Maintenance::countDown ( $seconds )

protected

Count down from $seconds to zero on the terminal, with a one-second pause between showing each number.

If the maintenance script is in quiet mode, this function does nothing.

Since: 1.31

@codeCoverageIgnore

Parameters

int $seconds

Definition at line 1583 of file Maintenance.php.

References isQuiet(), and output().

Referenced by ResetUserTokens\execute(), DeleteAutoPatrolLogs\execute(), and UpdateMediaWiki\execute().

◆ deleteOption()

Maintenance::deleteOption ( $name )

protected

Remove an option.

Useful for removing options that won't be used in your script.

Parameters

string $name The option to remove.

Definition at line 335 of file Maintenance.php.

◆ error()

Maintenance::error	(	$err,
		$die = `0`
	)

protected

Throw an error to the user.

Doesn't respect –quiet, so don't use this for non-error output

Parameters

string	$err	The error to display
int	$die	Deprecated since 1.31, use Maintenance::fatalError() instead

Definition at line 485 of file Maintenance.php.

References fatalError(), outputChanneled(), and wfDeprecated().

Referenced by MigrateActors\addActorsForRows(), SqliteMaintenance\backup(), CleanupImages\buildSafeTitle(), FindOrphanedFiles\checkFiles(), SqliteMaintenance\checkSyntax(), CleanupSpam\cleanupArticle(), CompressOld\compressPage(), CompressOld\compressWithConcat(), CompareParsers\conclusions(), CopyFileBackend\copyFileBatch(), CopyFileBackend\delFileBatch(), PopulateRecentChangesSource\doDBUpdates(), PopulateParentId\doDBUpdates(), FixExtLinksProtocolRelative\doDBUpdates(), RefreshExternallinksIndex\doDBUpdates(), MigrateImageCommentTemp\doDBUpdates(), MigrateActors\doDBUpdates(), PopulateLogSearch\doDBUpdates(), MigrateArchiveText\doDBUpdates(), UppercaseTitlesForUnicodeTransition\doMove(), CleanupUploadStash\doOperations(), UpdateSpecialPages\doSpecialPageCacheUpdates(), UppercaseTitlesForUnicodeTransition\doUpdate(), BenchmarkPurge\execute(), DeleteSelfExternals\execute(), CleanupAncientTables\execute(), DeleteArchivedFiles\execute(), MigrateFileRepoLayout\execute(), ImportSiteScripts\execute(), FixDoubleRedirects\execute(), ReassignEdits\execute(), PatchSql\execute(), Digit2Html\execute(), GenerateJsonI18n\execute(), RollbackEdits\execute(), DumpIterator\execute(), MysqlMaintenance\execute(), ImportTextFiles\execute(), PurgeChangedPages\execute(), GenerateNormalizerDataAr\execute(), MergeMessageFileList\execute(), CreateCommonPasswordCdb\execute(), DumpRenderer\execute(), SqliteMaintenance\execute(), MoveBatch\execute(), CreateAndPromote\execute(), PopulateInterwiki\execute(), UpdateSearchIndex\execute(), BenchmarkParse\execute(), ConvertLinks\execute(), PurgeChangedFiles\execute(), UpdateMediaWiki\execute(), CompressOld\execute(), UppercaseTitlesForUnicodeTransition\execute(), CategoryChangesAsRdf\execute(), fatalError(), DumpRenderer\handleRevision(), DumpIterator\handleRevision(), SqliteMaintenance\integrityCheck(), loadWithArgv(), MigrateActors\migrate(), MigrateActors\migrateLogSearch(), MigrateActors\migrateToTemp(), UppercaseTitlesForUnicodeTransition\mungeTitle(), CleanupImages\pokeFile(), PopulateContentModel\populateRevisionOrArchive(), PreprocessDump\processRevision(), CompareParsers\processRevision(), UppercaseTitlesForUnicodeTransition\processUsers(), PurgePage\purge(), PurgeChangedFiles\purgeFromArchiveTable(), PurgeChangedFiles\purgeFromLogType(), MergeMessageFileList\readFile(), RefreshLinks\refreshTrackingCategory(), UpdateSpecialPages\reopenAndWaitForReplicas(), runChild(), MysqlMaintenance\runMysql(), CommandLineInstaller\setDbPassOption(), setParam(), CommandLineInstaller\setPassOption(), MwSql\sqlDoQuery(), SyncFileBackend\syncBackends(), SyncFileBackend\syncFileBatch(), RefreshFileHeaders\updateFileHeaders(), GetConfiguration\validateParamsAndArgs(), validateParamsAndArgs(), and CLIParser\Wikitext().

◆ execute()

Maintenance::execute ( )

abstract

Do the actual work.

All child classes will need to implement this

Returns: bool|null|void True for success, false for failure. Not returning a value, or returning null, is also interpreted as success. Returning false for failure will cause doMaintenance.php to exit the process with a non-zero exit status.

Reimplemented in LoggedUpdateMaintenance, FakeMaintenance, BackupDumper, TextPassDumper, FindDeprecated, MWDocGen, DumpCategoriesAsRdf, ImportImages, CategoryChangesAsRdf, GetConfiguration, CommandLineInstaller, BackupReader, UppercaseTitlesForUnicodeTransition, DeleteEqualMessages, RefreshImageMetadata, DeleteLocalPasswords, CompressOld, PopulateContentTables, ImageBuilder, RecountCategories, CleanupInvalidDbKeys, UpdateMediaWiki, CLIParser, DumpBackup, PurgeChangedFiles, NamespaceDupes, ConvertExtensionToRegistration, UpdateCollation, PopulateCategory, ConvertLinks, BenchmarkParse, CdbInspector, CommandLineInc, FetchText, FindHooks, BenchmarkTitleValue, GenerateCollationData, RebuildLocalisationCache, UpdateSearchIndex, CleanupPreferences, ManageForeignResources, RebuildFileCache, RebuildRecentchanges, RunJobs, PopulateInterwiki, CopyFileBackend, MediaWikiShell, CreateAndPromote, MoveBatch, PopulateImageSha1, RefreshLinks, SqliteMaintenance, DeleteAutoPatrolLogs, CleanupWatchlist, PurgeList, DumpRenderer, CreateCommonPasswordCdb, MergeMessageFileList, ShowJobs, MwSql, CleanupCaps, MinifyScript, NukeNS, Orphans, PurgeParserCache, DeleteBatch, GenerateNormalizerDataAr, RefreshFileHeaders, ResetUserTokens, UserOptionsMaintenance, ImportTextFiles, MysqlMaintenance, PurgeChangedPages, ResetAuthenticationThrottle, UpdateDoubleWidthSearch, TableCleanup, DumpIterator, EditCLI, SyncFileBackend, RebuildTextIndex, RollbackEdits, RunBatchedQuery, DumpUploads, GenerateJsonI18n, GenerateUcfirstOverrides, ResetPageRandom, OrphanStats, InvalidateUserSesssions, Digit2Html, McTest, WrapOldPasswords, AttachLatest, CleanupSpam, DumpLinks, FileOpPerfTest, PatchSql, PopulateContentModel, CleanupRemovedModules, EraseArchivedFile, FixTimestamps, GenerateNormalizerDataMl, ReassignEdits, ShowSiteStats, CleanupUploadStash, ConvertUserOptions, CopyJobQueue, DeleteOrphanedRevisions, FixDoubleRedirects, RenameDbPrefix, UpdateSpecialPages, AddChangeTag, BenchWikimediaBaseConvert, ChangePassword, CheckDependencies, GetTextMaint, ImportSiteScripts, LangMemUsage, MigrateFileRepoLayout, Protect, ResetUserEmail, UpdateArticleCount, BenchmarkDeleteTruncate, BenchHttpHttps, CheckUsernames, CleanupBlocks, DeleteArchivedRevisions, InitEditCount, InitSiteStats, DateFormats, ListVariants, GeneratePhpCharToUpperMappings, PruneFileCache, RebuildAll, UpdateRestrictions, DeleteArchivedFiles, DeleteDefaultMessages, FormatInstallDoc, NukePage, RemoveUnusedAccounts, DumpRev, AddSite, BenchIfSwitch, BenchWfIsWindows, CleanupAncientTables, DeleteOldRevisions, GetLagTimes, GetReplicaServer, JSParseHelper, DatabaseLag, MakeTestEdits, MigrateUserGroup, RenameRestrictions, ViewCLI, BenchmarkHooks, DeleteSelfExternals, FixUserRegistration, DumpMessages, ManageJobs, PurgeModuleDeps, PurgeOldText, BenchmarkJavaScriptMinifier, BenchmarkJSMinPlus, BenchmarkLruHash, BenchmarkSanitizer, BenchmarkStringReplacement, CheckImages, ClearInterwikiCache, AllTrans, PurgePage, BenchmarkCSSMin, BenchmarkPurge, CheckBadRedirects, CheckLess, CompareParserCache, InitUserPreference, PurgeExpiredUserrights, RebuildMessages, EmptyUserGroup, GenerateUpperCharTable, Undelete, FindMissingFiles, FindOrphanedFiles, PageExists, ExportSites, ImportSites, RemoveInvalidEmails, StorageTypeStats, DeleteTag, CheckComposerLockUpToDate, BenchmarkTidy, ValidateRegistrationFile, UpdateExtensionJsonSchema, and TidyUpT39714.

◆ fatalError()

Maintenance::fatalError	(	$msg,
		$exitCode = `1`
	)

protected

Output a message and terminate the current script.

Parameters

string	$msg	Error message
int	$exitCode	PHP exit status. Should be in range 1-254.

Since: 1.31

Definition at line 508 of file Maintenance.php.

References error().

Referenced by CompareParsers\checkOptions(), checkRequiredExtensions(), ResetAuthenticationThrottle\clearLoginThrottle(), UpdateMediaWiki\compatChecks(), CopyFileBackend\copyFileBatch(), CopyFileBackend\delFileBatch(), PopulateRevisionSha1\doDBUpdates(), PopulateRevisionLength\doDBUpdates(), PopulateIpChanges\doDBUpdates(), PopulateImageSha1\doDBUpdates(), error(), UpdateExtensionJsonSchema\execute(), ValidateRegistrationFile\execute(), BenchmarkTidy\execute(), CheckComposerLockUpToDate\execute(), DeleteTag\execute(), ExportSites\execute(), FindOrphanedFiles\execute(), Undelete\execute(), BenchmarkJavaScriptMinifier\execute(), BenchmarkJSMinPlus\execute(), ManageJobs\execute(), MigrateUserGroup\execute(), ViewCLI\execute(), MakeTestEdits\execute(), FormatInstallDoc\execute(), RemoveUnusedAccounts\execute(), DeleteDefaultMessages\execute(), DumpRev\execute(), PruneFileCache\execute(), UpdateRestrictions\execute(), GeneratePhpCharToUpperMappings\execute(), MigrateFileRepoLayout\execute(), Protect\execute(), AddChangeTag\execute(), GetTextMaint\execute(), ResetUserEmail\execute(), LangMemUsage\execute(), ChangePassword\execute(), FixDoubleRedirects\execute(), UpdateSpecialPages\execute(), CopyJobQueue\execute(), CleanupUploadStash\execute(), RenameDbPrefix\execute(), FixTimestamps\execute(), EraseArchivedFile\execute(), CleanupSpam\execute(), PopulateContentModel\execute(), InvalidateUserSesssions\execute(), WrapOldPasswords\execute(), McTest\execute(), GenerateJsonI18n\execute(), OrphanStats\execute(), RebuildTextIndex\execute(), RollbackEdits\execute(), SyncFileBackend\execute(), DumpIterator\execute(), EditCLI\execute(), UpdateDoubleWidthSearch\execute(), ImportTextFiles\execute(), ResetAuthenticationThrottle\execute(), DeleteBatch\execute(), GenerateNormalizerDataAr\execute(), PurgeParserCache\execute(), MergeMessageFileList\execute(), CreateCommonPasswordCdb\execute(), MwSql\execute(), PurgeList\execute(), MoveBatch\execute(), CreateAndPromote\execute(), RefreshLinks\execute(), CopyFileBackend\execute(), MediaWikiShell\execute(), RebuildFileCache\execute(), RebuildRecentchanges\execute(), RunJobs\execute(), RebuildLocalisationCache\execute(), GenerateCollationData\execute(), FindHooks\execute(), CdbInspector\execute(), BenchmarkParse\execute(), ConvertExtensionToRegistration\execute(), DumpBackup\execute(), UpdateMediaWiki\execute(), RecountCategories\execute(), CompressOld\execute(), RefreshImageMetadata\execute(), DeleteEqualMessages\execute(), UppercaseTitlesForUnicodeTransition\execute(), BackupReader\execute(), ImportImages\execute(), MWDocGen\execute(), GenerateCollationData\generateFirstChars(), MinifyScript\getExtension(), CopyFileBackend\getListingDiffRel(), BackupReader\getNsIndex(), RefreshLinks\getPossibleCategories(), PopulateContentTables\getTables(), ConvertExtensionToRegistration\handleExtensionFunctions(), ConvertExtensionToRegistration\handleHooks(), BackupReader\importFromHandle(), ReassignEdits\initialiseUser(), DeleteLocalPasswords\initialize(), GenerateUcfirstOverrides\loadJson(), loadSettings(), MinifyScript\minify(), TitleCleanup\moveInconsistentPage(), PopulateContentTables\populateContentTablesForRowBatch(), DumpBackup\processOptions(), BackupDumper\processOptions(), MinifyScript\readFile(), CommandLineInstaller\setDbPassOption(), CommandLineInstaller\setPassOption(), setup(), RefreshImageMetadata\setupParameters(), UserOptionsMaintenance\showUsageStats(), MwSql\sqlDoQuery(), SyncFileBackend\syncBackends(), GenerateJsonI18n\transformI18nFile(), and SqliteMaintenance\vacuum().

◆ finalSetup()

Maintenance::finalSetup ( )

Handle some last-minute setup here.

Reimplemented in DumpIterator, GetConfiguration, RebuildLocalisationCache, and RebuildFileCache.

Definition at line 1188 of file Maintenance.php.

References $mDbPass, $mDbUser, $wgCommandLineMode, $wgDBadminpassword, $wgDBadminuser, $wgDBDefaultGroup, $wgDBpassword, $wgDBservers, $wgDBuser, $wgLBFactoryConf, $wgServer, $wgShowExceptionDetails, $wgShowHostnames, activateProfiler(), adjustMemoryLimit(), afterFinalSetup(), getDbType(), getOption(), and hasOption().

◆ getArg()

Maintenance::getArg	(	$argId = `0`,
		$default = `null`
	)

protected

Get an argument.

Parameters

int	$argId	The integer value (from zero) for the arg
mixed \| null	$default	The default if it doesn't exist

Returns: mixed

Definition at line 375 of file Maintenance.php.

References wfDeprecated().

Referenced by UpdateExtensionJsonSchema\execute(), ValidateRegistrationFile\execute(), DeleteTag\execute(), ImportSites\execute(), ExportSites\execute(), PageExists\execute(), Undelete\execute(), EmptyUserGroup\execute(), RenameRestrictions\execute(), AddSite\execute(), ViewCLI\execute(), MigrateUserGroup\execute(), DumpRev\execute(), FormatInstallDoc\execute(), NukePage\execute(), GetTextMaint\execute(), ResetUserEmail\execute(), ImportSiteScripts\execute(), Protect\execute(), ReassignEdits\execute(), FixTimestamps\execute(), CleanupSpam\execute(), McTest\execute(), GenerateJsonI18n\execute(), EditCLI\execute(), ImportTextFiles\execute(), DeleteBatch\execute(), CreateCommonPasswordCdb\execute(), MwSql\execute(), MoveBatch\execute(), CreateAndPromote\execute(), RefreshLinks\execute(), CdbInspector\execute(), BenchmarkParse\execute(), ConvertLinks\execute(), ConvertExtensionToRegistration\execute(), BackupReader\execute(), CommandLineInstaller\execute(), ImportImages\execute(), ImportSiteScripts\fetchScriptList(), UserOptionsMaintenance\showUsageStats(), UserOptionsMaintenance\updateOptions(), and CLIParser\Wikitext().

◆ getBatchSize()

Maintenance::getBatchSize ( )

protected

Returns batch size.

Since: 1.31

Returns: int|null

Definition at line 390 of file Maintenance.php.

References $mBatchSize.

Referenced by PopulateChangeTagDef\backpopulateChangeTagPerTag(), CleanupInvalidDbKeys\cleanupTable(), CopyJobQueue\copyJobs(), DeduplicateArchiveRevId\doDBUpdates(), PopulatePPSortKey\doDBUpdates(), PopulateRecentChangesSource\doDBUpdates(), PopulateChangeTagDef\doDBUpdates(), FixDefaultJsonContentPages\doDBUpdates(), PopulateBacklinkNamespace\doDBUpdates(), PopulateFilearchiveSha1\doDBUpdates(), PopulateParentId\doDBUpdates(), PopulateLogUsertext\doDBUpdates(), MigrateImageCommentTemp\doDBUpdates(), PopulateLogSearch\doDBUpdates(), PopulateArchiveRevId\doDBUpdates(), MigrateArchiveText\doDBUpdates(), PopulateIpChanges\doDBUpdates(), PopulateImageSha1\doDBUpdates(), PopulateRevisionLength\doLenUpdates(), PopulateRevisionSha1\doSha1Updates(), RecountCategories\doWork(), DeleteTag\execute(), RemoveInvalidEmails\execute(), FindMissingFiles\execute(), FindOrphanedFiles\execute(), InitUserPreference\execute(), CheckImages\execute(), FixUserRegistration\execute(), PurgeModuleDeps\execute(), MakeTestEdits\execute(), MigrateUserGroup\execute(), UpdateRestrictions\execute(), CheckUsernames\execute(), CleanupBlocks\execute(), MigrateFileRepoLayout\execute(), CleanupUploadStash\execute(), ConvertUserOptions\execute(), CleanupRemovedModules\execute(), WrapOldPasswords\execute(), InvalidateUserSesssions\execute(), ResetPageRandom\execute(), PurgeChangedPages\execute(), ResetUserTokens\execute(), RefreshFileHeaders\execute(), DeleteAutoPatrolLogs\execute(), RefreshLinks\execute(), CopyFileBackend\execute(), RebuildFileCache\execute(), RefreshImageMetadata\execute(), DumpCategoriesAsRdf\getCategoryIterator(), DumpCategoriesAsRdf\getCategoryLinksIterator(), DeleteAutoPatrolLogs\getRows(), DeleteAutoPatrolLogs\getRowsOld(), DeleteLocalPasswords\getUserBatches(), PopulateContentTables\loadContentMap(), MigrateComments\migrate(), MigrateComments\migrateToTemp(), PopulateContentModel\populatePage(), PopulateContentModel\populateRevisionOrArchive(), PopulateContentTables\populateTable(), UppercaseTitlesForUnicodeTransition\processTable(), UppercaseTitlesForUnicodeTransition\processUsers(), PurgeChangedFiles\purgeFromLogType(), PurgeList\purgeNamespace(), RebuildRecentchanges\rebuildRecentChangesTablePass1(), RebuildRecentchanges\rebuildRecentChangesTablePass2(), RebuildRecentchanges\rebuildRecentChangesTablePass3(), RebuildRecentchanges\rebuildRecentChangesTablePass4(), RebuildRecentchanges\rebuildRecentChangesTablePass5(), RefreshLinks\refreshCategory(), ManageJobs\repushAbandoned(), and SyncFileBackend\syncBackends().

◆ getConfig()

Maintenance::getConfig ( )

◆ getDB()

Maintenance::getDB	(	$db,
		$groups = `[]`,
		$dbDomain = `false`
	)

protected

Returns a database to be used by current maintenance script.

This uses the main LBFactory instance by default unless overriden via setDB().

This function has the same parameters as LoadBalancer::getConnection().

Parameters

int	$db	DB index (DB_REPLICA/DB_MASTER)
string \| string[]	$groups	default: empty array
string \| bool	$dbDomain	default: current wiki

Returns: IMaintainableDatabase

Reimplemented in OrphanStats.

Definition at line 1407 of file Maintenance.php.

References $mDb.

Referenced by ImageBuilder\buildTable(), NamespaceDupes\checkLinkTable(), Orphans\checkOrphans(), Orphans\checkSeparation(), CleanupUsersWithNoId\cleanup(), CleanupSpam\cleanupArticle(), CleanupInvalidDbKeys\cleanupTable(), RebuildTextIndex\clearSearchIndex(), CompressOld\compressOldPages(), CompressOld\compressPage(), CompressOld\compressWithConcat(), RebuildTextIndex\createMysqlTextIndex(), ConvertLinks\createTempTable(), RefreshLinks\deleteLinksFromNonexistent(), NukePage\deleteRevisions(), RefreshLinks\dfnCheckInterval(), CleanupRevActorPage\doDBUpdates(), PopulatePPSortKey\doDBUpdates(), DeduplicateArchiveRevId\doDBUpdates(), PopulateRecentChangesSource\doDBUpdates(), AddRFCandPMIDInterwiki\doDBUpdates(), PopulateBacklinkNamespace\doDBUpdates(), PopulateFilearchiveSha1\doDBUpdates(), FixDefaultJsonContentPages\doDBUpdates(), PopulateRevisionSha1\doDBUpdates(), PopulateRevisionLength\doDBUpdates(), PopulateParentId\doDBUpdates(), PopulateExternallinksIndex60\doDBUpdates(), FixExtLinksProtocolRelative\doDBUpdates(), PopulateLogUsertext\doDBUpdates(), RefreshExternallinksIndex\doDBUpdates(), MigrateImageCommentTemp\doDBUpdates(), MigrateActors\doDBUpdates(), PopulateLogSearch\doDBUpdates(), MigrateArchiveText\doDBUpdates(), PopulateArchiveRevId\doDBUpdates(), PopulateIpChanges\doDBUpdates(), PopulateImageSha1\doDBUpdates(), DeleteOldRevisions\doDelete(), PopulateRevisionLength\doLenUpdates(), ReassignEdits\doReassignEdits(), RefreshLinks\doRefreshLinks(), PopulateRevisionSha1\doSha1LegacyUpdates(), PopulateRevisionSha1\doSha1Updates(), UpdateSearchIndex\doUpdateSearchIndex(), RecountCategories\doWork(), RebuildTextIndex\dropMysqlTextIndex(), TidyUpT39714\execute(), DeleteTag\execute(), RemoveInvalidEmails\execute(), StorageTypeStats\execute(), CheckBadRedirects\execute(), CompareParserCache\execute(), InitUserPreference\execute(), ClearInterwikiCache\execute(), CheckImages\execute(), DeleteSelfExternals\execute(), FixUserRegistration\execute(), PurgeModuleDeps\execute(), MigrateUserGroup\execute(), CleanupAncientTables\execute(), GetReplicaServer\execute(), RemoveUnusedAccounts\execute(), DeleteDefaultMessages\execute(), NukePage\execute(), DeleteArchivedFiles\execute(), CheckUsernames\execute(), UpdateRestrictions\execute(), DeleteArchivedRevisions\execute(), CleanupBlocks\execute(), BenchmarkDeleteTruncate\execute(), RebuildAll\execute(), InitEditCount\execute(), InitSiteStats\execute(), UpdateArticleCount\execute(), RenameDbPrefix\execute(), UpdateSpecialPages\execute(), DeleteOrphanedRevisions\execute(), FixDoubleRedirects\execute(), ConvertUserOptions\execute(), ShowSiteStats\execute(), CleanupRemovedModules\execute(), EraseArchivedFile\execute(), FixTimestamps\execute(), CleanupSpam\execute(), PatchSql\execute(), PopulateContentModel\execute(), DumpLinks\execute(), AttachLatest\execute(), WrapOldPasswords\execute(), ResetPageRandom\execute(), RunBatchedQuery\execute(), RebuildTextIndex\execute(), UpdateDoubleWidthSearch\execute(), PurgeChangedPages\execute(), RefreshFileHeaders\execute(), ResetUserTokens\execute(), NukeNS\execute(), MoveBatch\execute(), CleanupPreferences\execute(), RebuildFileCache\execute(), ConvertLinks\execute(), PopulateCategory\execute(), UpdateCollation\execute(), PurgeChangedFiles\execute(), UpdateMediaWiki\execute(), ImageBuilder\execute(), RefreshImageMetadata\execute(), DeleteEqualMessages\execute(), UppercaseTitlesForUnicodeTransition\execute(), CategoryChangesAsRdf\execute(), DumpCategoriesAsRdf\execute(), LoggedUpdateMaintenance\execute(), DumpUploads\fetchLocal(), DumpUploads\fetchUsed(), TitleCleanup\fileExists(), RefreshLinks\fixRedirect(), BenchmarkParse\getRevIdForTime(), RollbackEdits\getRollbackTitles(), NamespaceDupes\getTargetList(), DeleteLocalPasswords\getUserBatches(), DeleteLocalPasswords\getUserDB(), FixDefaultJsonContentPages\handleRow(), BackupReader\handleUpload(), BackupDumper\initProgress(), PopulateContentTables\initServices(), RemoveUnusedAccounts\isInactiveAccount(), CleanupImages\killRow(), PopulateContentTables\loadContentMap(), NamespaceDupes\mergePage(), MigrateComments\migrate(), MigrateActors\migrate(), MigrateActors\migrateLogSearch(), MigrateComments\migrateToTemp(), MigrateActors\migrateToTemp(), TitleCleanup\moveIllegalPage(), TitleCleanup\moveInconsistentPage(), NamespaceDupes\movePage(), CleanupImages\pokeFile(), RebuildTextIndex\populateSearchIndex(), PurgeChangedFiles\purgeFromLogType(), PurgeList\purgeNamespace(), purgeRedundantText(), RebuildRecentchanges\rebuildRecentChangesTablePass1(), RebuildRecentchanges\rebuildRecentChangesTablePass2(), RebuildRecentchanges\rebuildRecentChangesTablePass3(), RebuildRecentchanges\rebuildRecentChangesTablePass4(), RefreshLinks\refreshCategory(), CleanupWatchlist\removeWatch(), TableCleanup\runTable(), EraseArchivedFile\scrubAllVersions(), MediaWikiShell\setupLegacy(), PopulateRevisionSha1\upgradeLegacyArchiveRow(), PopulateRevisionLength\upgradeRow(), and PopulateRevisionSha1\upgradeRow().

◆ getDbType()

Maintenance::getDbType ( )

Does the script need different DB access? By default, we give Maintenance scripts normal rights to the DB.

Sometimes, a script needs admin rights access for a reason and sometimes they want no access. Subclasses should override and return one of the following values, as needed: Maintenance::DB_NONE - For no DB access at all Maintenance::DB_STD - For normal DB access, default Maintenance::DB_ADMIN - For admin DB access

Returns: int

Reimplemented in MwSql, SearchDump, RunBatchedQuery, CommandLineInstaller, MWDocGen, ConvertLinks, FindHooks, UpdateMediaWiki, PreprocessDump, UpdateSearchIndex, SqliteMaintenance, GenerateNormalizerDataAr, UpdateDoubleWidthSearch, RebuildTextIndex, PatchSql, GenerateNormalizerDataMl, RenameDbPrefix, and RebuildAll.

Definition at line 567 of file Maintenance.php.

References DB_STD.

Referenced by addDefaultParams(), DumpIterator\finalSetup(), and finalSetup().

◆ getDir()

Maintenance::getDir ( )

protected

Get the maintenance directory.

Returns: string

Definition at line 1391 of file Maintenance.php.

◆ getName()

Maintenance::getName ( )

Get the script's name.

Returns: string

Definition at line 420 of file Maintenance.php.

References $mSelf.

◆ getOption()

Maintenance::getOption	(	$name,
		$default = `null`
	)

protected

Get an option, or return the default.

If the option was added to support multiple occurrences, this will return an array.

Parameters

string	$name	The name of the param
mixed \| null	$default	Anything you want, default null

Returns: mixed

Definition at line 306 of file Maintenance.php.

References hasOption().

Referenced by activateProfiler(), PopulateChangeTagDef\backpopulateChangeTagPerTag(), Benchmarker\bench(), PreprocessDump\checkOptions(), CompareParsers\checkOptions(), SqliteMaintenance\checkSyntax(), PopulateChangeTagDef\doDBUpdates(), PopulateBacklinkNamespace\doDBUpdates(), CleanupUsersWithNoId\doDBUpdates(), MigrateActors\doDBUpdates(), PopulateIpChanges\doDBUpdates(), PopulateImageSha1\doDBUpdates(), FileOpPerfTest\doPerfTest(), UpdateSpecialPages\doSpecialPageCacheUpdates(), BenchmarkTidy\execute(), FindMissingFiles\execute(), FindOrphanedFiles\execute(), Undelete\execute(), GenerateUpperCharTable\execute(), BenchmarkCSSMin\execute(), CompareParserCache\execute(), BenchmarkPurge\execute(), InitUserPreference\execute(), BenchmarkLruHash\execute(), BenchmarkSanitizer\execute(), BenchmarkJavaScriptMinifier\execute(), BenchmarkJSMinPlus\execute(), ManageJobs\execute(), MakeTestEdits\execute(), AddSite\execute(), GetReplicaServer\execute(), FormatInstallDoc\execute(), RemoveUnusedAccounts\execute(), PruneFileCache\execute(), AddChangeTag\execute(), MigrateFileRepoLayout\execute(), BenchWikimediaBaseConvert\execute(), Protect\execute(), ImportSiteScripts\execute(), ChangePassword\execute(), CheckDependencies\execute(), UpdateSpecialPages\execute(), FixDoubleRedirects\execute(), CopyJobQueue\execute(), RenameDbPrefix\execute(), EraseArchivedFile\execute(), FileOpPerfTest\execute(), PopulateContentModel\execute(), InvalidateUserSesssions\execute(), WrapOldPasswords\execute(), McTest\execute(), GenerateUcfirstOverrides\execute(), DumpUploads\execute(), GenerateJsonI18n\execute(), ResetPageRandom\execute(), RunBatchedQuery\execute(), RollbackEdits\execute(), SyncFileBackend\execute(), DumpIterator\execute(), EditCLI\execute(), UpdateDoubleWidthSearch\execute(), MysqlMaintenance\execute(), PurgeChangedPages\execute(), ImportTextFiles\execute(), ResetAuthenticationThrottle\execute(), GenerateNormalizerDataAr\execute(), ResetUserTokens\execute(), RefreshFileHeaders\execute(), DeleteBatch\execute(), CleanupCaps\execute(), MinifyScript\execute(), NukeNS\execute(), PurgeParserCache\execute(), MergeMessageFileList\execute(), CreateCommonPasswordCdb\execute(), ShowJobs\execute(), MwSql\execute(), PurgeList\execute(), DumpRenderer\execute(), DeleteAutoPatrolLogs\execute(), MoveBatch\execute(), SqliteMaintenance\execute(), PopulateImageSha1\execute(), CreateAndPromote\execute(), RefreshLinks\execute(), CopyFileBackend\execute(), PopulateInterwiki\execute(), RunJobs\execute(), RebuildFileCache\execute(), UpdateSearchIndex\execute(), GenerateCollationData\execute(), RebuildLocalisationCache\execute(), BenchmarkParse\execute(), PopulateCategory\execute(), ConvertExtensionToRegistration\execute(), UpdateCollation\execute(), NamespaceDupes\execute(), PurgeChangedFiles\execute(), UpdateMediaWiki\execute(), CleanupInvalidDbKeys\execute(), RecountCategories\execute(), PopulateContentTables\execute(), CompressOld\execute(), RefreshImageMetadata\execute(), DeleteEqualMessages\execute(), UppercaseTitlesForUnicodeTransition\execute(), BackupReader\execute(), CommandLineInstaller\execute(), GetConfiguration\execute(), CategoryChangesAsRdf\execute(), ImportImages\execute(), DumpCategoriesAsRdf\execute(), GetConfiguration\finalSetup(), finalSetup(), RefreshImageMetadata\getConditions(), DeleteAutoPatrolLogs\getRows(), DeleteAutoPatrolLogs\getRowsOld(), PopulateContentTables\getTables(), CLIParser\getTitle(), BackupReader\importFromHandle(), MWDocGen\init(), DeleteLocalPasswords\initialize(), loadSpecialVars(), memoryLimit(), MinifyScript\minify(), CLIParser\parse(), PopulateContentTables\populateTable(), DumpBackup\processOptions(), TextPassDumper\processOptions(), BackupDumper\processOptions(), CompareParsers\processRevision(), SearchDump\processRevision(), DeleteLocalPasswords\processUsers(), UppercaseTitlesForUnicodeTransition\processUsers(), PurgePage\purge(), PurgeChangedFiles\purgeFromLogType(), RebuildRecentchanges\rebuildRecentChangesTablePass1(), CommandLineInstaller\setDbPassOption(), CommandLineInstaller\setPassOption(), MediaWikiShell\setupLegacy(), SyncFileBackend\syncFileBatch(), UserOptionsMaintenance\updateOptions(), and GetConfiguration\validateParamsAndArgs().

◆ getStdin()

Maintenance::getStdin ( $len = null )

protected

Return input from stdin.

Parameters

int | null $len The number of bytes to read. If null, just return the handle. Maintenance::STDIN_ALL returns the full length

Returns: mixed

Definition at line 430 of file Maintenance.php.

Referenced by PurgeList\doPurge(), PurgePage\execute(), DumpIterator\execute(), EditCLI\execute(), DeleteBatch\execute(), DumpRenderer\execute(), MoveBatch\execute(), FetchText\execute(), and MinifyScript\readFile().

◆ getTermSize()

static Maintenance::getTermSize ( )

static

Get the terminal size as a two-element array where the first element is the width (number of columns) and the second element is the height (number of rows).

Returns: array

Definition at line 1689 of file Maintenance.php.

References wfIsWindows().

◆ globals()

Maintenance::globals ( )

Potentially debug globals.

Originally a feature only for refreshLinks

Definition at line 1272 of file Maintenance.php.

References $GLOBALS, and hasOption().

◆ hasArg()

Maintenance::hasArg ( $argId = 0 )

protected

Does a given argument exist?

Parameters

int $argId The integer value (from zero) for the arg

Returns: bool

Definition at line 361 of file Maintenance.php.

References wfDeprecated().

Referenced by JSParseHelper\execute(), FormatInstallDoc\execute(), ReassignEdits\execute(), McTest\execute(), DeleteBatch\execute(), UserOptionsMaintenance\execute(), MwSql\execute(), MoveBatch\execute(), BackupReader\execute(), and validateParamsAndArgs().

◆ hasOption()

Maintenance::hasOption ( $name )

protected

Checks to see if a particular option exists.

Parameters

string $name The name of the option

Returns: bool

Definition at line 292 of file Maintenance.php.

Referenced by PopulateChangeTagDef\backpopulateChangeTagPerTag(), Benchmarker\bench(), PreprocessDump\checkOptions(), CompareParsers\checkOptions(), CleanupSpam\cleanupArticle(), CleanupInvalidDbKeys\cleanupTable(), CopyFileBackend\copyFileBatch(), ConvertLinks\createTempTable(), CleanupPreferences\deleteByWhere(), PopulateChangeTagDef\doDBUpdates(), MigrateArchiveText\doDBUpdates(), PopulateImageSha1\doDBUpdates(), FileOpPerfTest\doPerfTest(), UpdateSpecialPages\doSpecialPageCacheUpdates(), BenchmarkTidy\execute(), RemoveInvalidEmails\execute(), FindOrphanedFiles\execute(), BenchmarkPurge\execute(), BenchmarkCSSMin\execute(), PurgeOldText\execute(), CleanupAncientTables\execute(), DatabaseLag\execute(), DeleteOldRevisions\execute(), GetLagTimes\execute(), GetReplicaServer\execute(), DeleteDefaultMessages\execute(), NukePage\execute(), FormatInstallDoc\execute(), DeleteArchivedFiles\execute(), RemoveUnusedAccounts\execute(), ListVariants\execute(), DeleteArchivedRevisions\execute(), InitEditCount\execute(), InitSiteStats\execute(), CheckDependencies\execute(), Protect\execute(), GetTextMaint\execute(), ResetUserEmail\execute(), ChangePassword\execute(), UpdateArticleCount\execute(), DeleteOrphanedRevisions\execute(), FixDoubleRedirects\execute(), UpdateSpecialPages\execute(), EraseArchivedFile\execute(), ReassignEdits\execute(), AttachLatest\execute(), CleanupSpam\execute(), WrapOldPasswords\execute(), DumpUploads\execute(), GenerateJsonI18n\execute(), RollbackEdits\execute(), TableCleanup\execute(), DumpIterator\execute(), EditCLI\execute(), SyncFileBackend\execute(), MysqlMaintenance\execute(), PurgeChangedPages\execute(), ImportTextFiles\execute(), UserOptionsMaintenance\execute(), GenerateNormalizerDataAr\execute(), RefreshFileHeaders\execute(), CleanupCaps\execute(), NukeNS\execute(), Orphans\execute(), ShowJobs\execute(), MergeMessageFileList\execute(), MwSql\execute(), CleanupWatchlist\execute(), PurgeList\execute(), DumpRenderer\execute(), DeleteAutoPatrolLogs\execute(), MoveBatch\execute(), SqliteMaintenance\execute(), PopulateImageSha1\execute(), RefreshLinks\execute(), CreateAndPromote\execute(), CopyFileBackend\execute(), MediaWikiShell\execute(), PopulateInterwiki\execute(), RunJobs\execute(), CleanupPreferences\execute(), RebuildFileCache\execute(), RebuildRecentchanges\execute(), UpdateSearchIndex\execute(), RebuildLocalisationCache\execute(), BenchmarkParse\execute(), ConvertLinks\execute(), PopulateCategory\execute(), UpdateCollation\execute(), ConvertExtensionToRegistration\execute(), NamespaceDupes\execute(), PurgeChangedFiles\execute(), DumpBackup\execute(), UpdateMediaWiki\execute(), CleanupInvalidDbKeys\execute(), ImageBuilder\execute(), RefreshImageMetadata\execute(), DeleteEqualMessages\execute(), BackupReader\execute(), CommandLineInstaller\execute(), ImportImages\execute(), LoggedUpdateMaintenance\execute(), CopyFileBackend\filesAreSame(), GetConfiguration\finalSetup(), finalSetup(), UpdateCollation\getBatchCondition(), CommandLineInstaller\getDbType(), FindHooks\getHooksFromDoc(), getOption(), globals(), ConvertExtensionToRegistration\handleResourceModules(), BackupReader\importFromHandle(), MWDocGen\init(), DeleteLocalPasswords\initialize(), loadSpecialVars(), maybeHelp(), RunJobs\memoryLimit(), PopulateContentTables\populateTable(), DumpBackup\processOptions(), TextPassDumper\processOptions(), BackupDumper\processOptions(), PurgeChangedFiles\purgeFromLogType(), RebuildRecentchanges\rebuildRecentChangesTablePass1(), CleanupWatchlist\removeWatch(), EraseArchivedFile\scrubVersion(), PurgeList\sendPurgeRequest(), PopulateChangeTagDef\setUserDefinedTags(), MwSql\sqlPrintResult(), PopulateChangeTagDef\updateCountTag(), PopulateChangeTagDef\updateCountTagId(), UserOptionsMaintenance\updateOptions(), CommandLineInstaller\validateParamsAndArgs(), validateParamsAndArgs(), PurgeChangedFiles\verbose(), and UserOptionsMaintenance\warn().

◆ isQuiet()

Maintenance::isQuiet ( )

Returns: bool

Definition at line 447 of file Maintenance.php.

References $mQuiet.

Referenced by countDown(), SyncFileBackend\execute(), and CdbInspector\execute().

◆ loadParamsAndArgs()

Maintenance::loadParamsAndArgs	(	$self = `null`,
		$opts = `null`,
		$args = `null`
	)

Process command line arguments $mOptions becomes an array with keys set to the option names $mArgs becomes a zero-based array containing the non-option arguments.

Parameters

string \| null	$self	The name of the script, if any
array \| null	$opts	An array of options, in form of key=>value
array \| null	$args	An array of command line arguments

Definition at line 983 of file Maintenance.php.

References $args, $self, loadSpecialVars(), and loadWithArgv().

Referenced by setup().

◆ loadSettings()

Maintenance::loadSettings ( )

Generic setup for most installs.

Returns the location of LocalSettings

Returns: string

Definition at line 1282 of file Maintenance.php.

References $IP, $wgCommandLineMode, and fatalError().

◆ loadSpecialVars()

Maintenance::loadSpecialVars ( )

protected

Handle the special variables that are global to all scripts.

Definition at line 1047 of file Maintenance.php.

References getOption(), and hasOption().

Referenced by loadParamsAndArgs(), and loadWithArgv().

◆ loadWithArgv()

Maintenance::loadWithArgv ( $argv )

Load params and arguments from a given array of command-line arguments.

Since: 1.27

Parameters

array $argv

Definition at line 877 of file Maintenance.php.

References $args, error(), loadSpecialVars(), maybeHelp(), and setParam().

Referenced by DumpBackup\__construct(), TextPassDumper\__construct(), BackupDumper\__construct(), and loadParamsAndArgs().

◆ lockSearchindex()

Maintenance::lockSearchindex ( $db )

private

Lock the search index.

Parameters

IMaintainableDatabase $db

Definition at line 1480 of file Maintenance.php.

Referenced by relockSearchindex(), and updateSearchIndex().

◆ maybeHelp()

Maintenance::maybeHelp ( $force = false )

protected

Maybe show the help.

If the help is shown, exit.

Parameters

bool $force Whether to force the help to show, default false

Reimplemented in CommandLineInc.

Definition at line 1067 of file Maintenance.php.

References hasOption(), and showHelp().

Referenced by JSParseHelper\execute(), GenerateJsonI18n\execute(), PurgeChangedPages\execute(), UserOptionsMaintenance\execute(), CreateAndPromote\execute(), PurgeChangedFiles\execute(), BackupReader\importFromStdin(), loadWithArgv(), setParam(), GetConfiguration\validateParamsAndArgs(), and validateParamsAndArgs().

◆ memoryLimit()

Maintenance::memoryLimit ( )

Normally we disable the memory_limit when running admin scripts.

Some scripts may wish to actually set a limit, however, to avoid blowing up unexpectedly. We also support a –memory-limit option, to allow sysadmins to explicitly set one if they'd prefer to override defaults (or for people using Suhosin which yells at you for trying to disable the limits)

Returns: string

Reimplemented in RunJobs.

Definition at line 814 of file Maintenance.php.

References getOption().

Referenced by adjustMemoryLimit().

◆ output()

Maintenance::output	(	$out,
		$channel = `null`
	)

protected

Throw some output to the user.

Scripts can call this with no fears, as we handle all –quiet stuff here

Parameters

string	$out	The text to show to the user
mixed \| null	$channel	Unique identifier for the channel. See function outputChanneled.

Definition at line 457 of file Maintenance.php.

References cleanupChanneled(), MediaWiki\emitBufferedStatsdData(), getConfig(), and outputChanneled().

Referenced by DumpBackup\__construct(), TextPassDumper\__construct(), ImageBuilder\addMissingImage(), Benchmarker\addResult(), PopulateChangeTagDef\backpopulateChangeTagPerTag(), SqliteMaintenance\backup(), McTest\benchmarkMultiKeyOpsDeferredBlocking(), McTest\benchmarkMultiKeyOpsImmediateBlocking(), McTest\benchmarkSingleKeyOps(), ImageBuilder\buildTable(), NamespaceDupes\checkAll(), FindOrphanedFiles\checkFiles(), NamespaceDupes\checkLinkTable(), NamespaceDupes\checkNamespace(), Orphans\checkOrphans(), NamespaceDupes\checkPrefix(), Orphans\checkSeparation(), SqliteMaintenance\checkSyntax(), CleanupUsersWithNoId\cleanup(), CleanupSpam\cleanupArticle(), ResetAuthenticationThrottle\clearLoginThrottle(), RebuildTextIndex\clearSearchIndex(), ResetAuthenticationThrottle\clearSignupThrottle(), CompressOld\compressOldPages(), CompressOld\compressWithConcat(), CompareParsers\conclusions(), CopyFileBackend\copyFileBatch(), countDown(), RebuildTextIndex\createMysqlTextIndex(), ConvertLinks\createTempTable(), RunJobs\debugInternal(), ManageJobs\delete(), CleanupPreferences\deleteByWhere(), RefreshLinks\deleteLinksFromNonexistent(), CopyFileBackend\delFileBatch(), RefreshLinks\dfnCheckInterval(), CleanupRevActorPage\doDBUpdates(), PopulatePPSortKey\doDBUpdates(), DeduplicateArchiveRevId\doDBUpdates(), PopulateRecentChangesSource\doDBUpdates(), PopulateBacklinkNamespace\doDBUpdates(), FixDefaultJsonContentPages\doDBUpdates(), PopulateFilearchiveSha1\doDBUpdates(), PopulateRevisionSha1\doDBUpdates(), PopulateRevisionLength\doDBUpdates(), PopulateParentId\doDBUpdates(), PopulateExternallinksIndex60\doDBUpdates(), FixExtLinksProtocolRelative\doDBUpdates(), PopulateLogUsertext\doDBUpdates(), RefreshExternallinksIndex\doDBUpdates(), MigrateImageCommentTemp\doDBUpdates(), MigrateActors\doDBUpdates(), PopulateLogSearch\doDBUpdates(), MigrateArchiveText\doDBUpdates(), PopulateArchiveRevId\doDBUpdates(), PopulateIpChanges\doDBUpdates(), PopulateImageSha1\doDBUpdates(), DeleteOldRevisions\doDelete(), PopulateRevisionLength\doLenUpdates(), UppercaseTitlesForUnicodeTransition\doMove(), FileOpPerfTest\doPerfTest(), PopulateInterwiki\doPopulate(), PurgeList\doPurge(), ReassignEdits\doReassignEdits(), RebuildLocalisationCache\doRebuild(), RefreshLinks\doRefreshLinks(), PopulateRevisionSha1\doSha1LegacyUpdates(), PopulateRevisionSha1\doSha1Updates(), UpdateSpecialPages\doSpecialPageCacheUpdates(), UppercaseTitlesForUnicodeTransition\doUpdate(), UpdateSearchIndex\doUpdateSearchIndex(), RecountCategories\doWork(), RebuildTextIndex\dropMysqlTextIndex(), TidyUpT39714\execute(), UpdateExtensionJsonSchema\execute(), ValidateRegistrationFile\execute(), CheckComposerLockUpToDate\execute(), DeleteTag\execute(), RemoveInvalidEmails\execute(), ExportSites\execute(), ImportSites\execute(), PageExists\execute(), FindMissingFiles\execute(), FindOrphanedFiles\execute(), Undelete\execute(), EmptyUserGroup\execute(), CheckBadRedirects\execute(), CompareParserCache\execute(), PurgeExpiredUserrights\execute(), BenchmarkPurge\execute(), RebuildMessages\execute(), InitUserPreference\execute(), ClearInterwikiCache\execute(), CheckImages\execute(), AllTrans\execute(), DeleteSelfExternals\execute(), FixUserRegistration\execute(), PurgeModuleDeps\execute(), DumpMessages\execute(), DeleteOldRevisions\execute(), MakeTestEdits\execute(), ViewCLI\execute(), MigrateUserGroup\execute(), GetLagTimes\execute(), GetReplicaServer\execute(), CleanupAncientTables\execute(), JSParseHelper\execute(), DatabaseLag\execute(), DumpRev\execute(), NukePage\execute(), DeleteArchivedFiles\execute(), RemoveUnusedAccounts\execute(), DeleteDefaultMessages\execute(), UpdateRestrictions\execute(), GeneratePhpCharToUpperMappings\execute(), PruneFileCache\execute(), RebuildAll\execute(), CheckUsernames\execute(), CleanupBlocks\execute(), InitEditCount\execute(), InitSiteStats\execute(), DeleteArchivedRevisions\execute(), DateFormats\execute(), UpdateArticleCount\execute(), MigrateFileRepoLayout\execute(), AddChangeTag\execute(), CheckDependencies\execute(), Protect\execute(), GetTextMaint\execute(), ImportSiteScripts\execute(), ChangePassword\execute(), ResetUserEmail\execute(), LangMemUsage\execute(), CleanupUploadStash\execute(), UpdateSpecialPages\execute(), FixDoubleRedirects\execute(), DeleteOrphanedRevisions\execute(), ConvertUserOptions\execute(), CopyJobQueue\execute(), RenameDbPrefix\execute(), EraseArchivedFile\execute(), FixTimestamps\execute(), CleanupRemovedModules\execute(), ReassignEdits\execute(), ShowSiteStats\execute(), CleanupSpam\execute(), DumpLinks\execute(), PatchSql\execute(), AttachLatest\execute(), McTest\execute(), Digit2Html\execute(), WrapOldPasswords\execute(), InvalidateUserSesssions\execute(), OrphanStats\execute(), GenerateJsonI18n\execute(), ResetPageRandom\execute(), RebuildTextIndex\execute(), RollbackEdits\execute(), RunBatchedQuery\execute(), EditCLI\execute(), SyncFileBackend\execute(), TableCleanup\execute(), UpdateDoubleWidthSearch\execute(), PurgeChangedPages\execute(), ImportTextFiles\execute(), ResetUserTokens\execute(), RefreshFileHeaders\execute(), DeleteBatch\execute(), CleanupCaps\execute(), MinifyScript\execute(), NukeNS\execute(), PurgeParserCache\execute(), CreateCommonPasswordCdb\execute(), ShowJobs\execute(), CleanupWatchlist\execute(), PurgeList\execute(), DeleteAutoPatrolLogs\execute(), MoveBatch\execute(), CreateAndPromote\execute(), CopyFileBackend\execute(), ManageForeignResources\execute(), CleanupPreferences\execute(), RunJobs\execute(), RebuildFileCache\execute(), RebuildRecentchanges\execute(), RebuildLocalisationCache\execute(), FetchText\execute(), FindHooks\execute(), ConvertLinks\execute(), PopulateCategory\execute(), UpdateCollation\execute(), ConvertExtensionToRegistration\execute(), NamespaceDupes\execute(), UpdateMediaWiki\execute(), RecountCategories\execute(), CompressOld\execute(), DeleteLocalPasswords\execute(), RefreshImageMetadata\execute(), DeleteEqualMessages\execute(), BackupReader\execute(), CommandLineInstaller\execute(), GetConfiguration\execute(), ImportImages\execute(), MWDocGen\execute(), LoggedUpdateMaintenance\execute(), DeleteEqualMessages\fetchMessageInfo(), ImportSiteScripts\fetchScriptList(), GetConfiguration\formatVarDump(), DeleteLocalPasswords\getUserBatches(), ConvertExtensionToRegistration\handleExtensionMessagesFiles(), ConvertExtensionToRegistration\handleHooks(), DumpRenderer\handleRevision(), DumpIterator\handleRevision(), FixDefaultJsonContentPages\handleRow(), MWDocGen\init(), SqliteMaintenance\integrityCheck(), CleanupImages\killRow(), UserOptionsMaintenance\listAvailableOptions(), MigrateComments\migrate(), MigrateActors\migrate(), MigrateActors\migrateLogSearch(), MigrateComments\migrateToTemp(), MigrateActors\migrateToTemp(), TitleCleanup\moveIllegalPage(), TitleCleanup\moveInconsistentPage(), CleanupCaps\movePage(), ImageBuilder\oldimageCallback(), DumpUploads\outputItem(), CleanupImages\pokeFile(), PopulateContentModel\populatePage(), PopulateContentModel\populateRevisionOrArchive(), RebuildTextIndex\populateSearchIndex(), FindHooks\printArray(), DeduplicateArchiveRevId\processArRevIds(), CompareParsers\processRevision(), SearchDump\processRevision(), TitleCleanup\processRow(), CleanupImages\processRow(), CleanupWatchlist\processRow(), CleanupCaps\processRowToLowercase(), CleanupCaps\processRowToUppercase(), UppercaseTitlesForUnicodeTransition\processTable(), UppercaseTitlesForUnicodeTransition\processUsers(), TableCleanup\progress(), ImageBuilder\progress(), PruneFileCache\prune_directory(), PurgePage\purge(), RebuildRecentchanges\purgeFeeds(), PurgeChangedFiles\purgeFromArchiveTable(), purgeRedundantText(), FixDoubleRedirects\queueJobs(), RebuildRecentchanges\rebuildRecentChangesTablePass1(), RebuildRecentchanges\rebuildRecentChangesTablePass2(), RebuildRecentchanges\rebuildRecentChangesTablePass3(), RebuildRecentchanges\rebuildRecentChangesTablePass4(), RebuildRecentchanges\rebuildRecentChangesTablePass5(), RefreshLinks\refreshCategory(), CleanupWatchlist\removeWatch(), UpdateSpecialPages\reopenAndWaitForReplicas(), ImportSites\reportException(), ManageJobs\repushAbandoned(), MigrateFileRepoLayout\runBatch(), TableCleanup\runTable(), EraseArchivedFile\scrubVersion(), PurgeList\sendPurgeRequest(), PopulateChangeTagDef\setUserDefinedTags(), showHelp(), PurgeParserCache\showProgressAndWait(), UpdateCollation\showSortKeySizeHistogram(), UserOptionsMaintenance\showUsageStats(), MwSql\sqlPrintResult(), Benchmarker\startBench(), SyncFileBackend\syncBackends(), SyncFileBackend\syncFileBatch(), GenerateJsonI18n\transformI18nFile(), PopulateChangeTagDef\updateCountTag(), PopulateChangeTagDef\updateCountTagId(), UserOptionsMaintenance\updateOptions(), PopulateContentModel\updatePageRows(), PopulateContentModel\updateRevisionOrArchiveRows(), updateSearchIndex(), updateSearchIndexForPage(), ResetUserTokens\updateUser(), PopulateRevisionSha1\upgradeLegacyArchiveRow(), PopulateRevisionLength\upgradeRow(), PopulateRevisionSha1\upgradeRow(), SqliteMaintenance\vacuum(), PurgeChangedFiles\verbose(), Benchmarker\verboseRun(), UserOptionsMaintenance\warn(), and PopulateContentTables\writeln().

◆ outputChanneled()

Maintenance::outputChanneled	(	$msg,
		$channel = `null`
	)

Message outputter with channeled message support.

Messages on the same channel are concatenated, but any intervening messages in another channel start a new line.

Parameters

string	$msg	The message without trailing newline
string \| null	$channel	Channel identifier or null for no channel. Channel comparison uses ===.

Definition at line 534 of file Maintenance.php.

References cleanupChanneled().

Referenced by error(), and output().

◆ posix_isatty()

static Maintenance::posix_isatty ( $fd )

static

Wrapper for posix_isatty() We default as considering stdin a tty (for nice readline methods) but treating stout as not a tty to avoid color codes.

Parameters

mixed $fd File descriptor

Returns: bool

Definition at line 1607 of file Maintenance.php.

Referenced by MwSql\execute(), FindDeprecated\execute(), and readconsole().

◆ purgeRedundantText()

Maintenance::purgeRedundantText ( $delete = true )

Support function for cleaning up redundant text records.

Parameters

bool $delete Whether or not to actually delete the records

Author: Rob Church robch.nosp@m.ur@g.nosp@m.mail..nosp@m.com

Definition at line 1319 of file Maintenance.php.

References $res, $wgMultiContentRevisionSchemaMigrationStage, beginTransaction(), commitTransaction(), DB_MASTER, getDB(), output(), and SCHEMA_COMPAT_READ_OLD.

Referenced by DeleteOldRevisions\doDelete(), PurgeOldText\execute(), NukePage\execute(), DeleteArchivedRevisions\execute(), DeleteOrphanedRevisions\execute(), and NukeNS\execute().

◆ readconsole()

static Maintenance::readconsole	(		$prompt = `'`,
		'
	)

static

Prompt the console for input.

Parameters

string $prompt What to begin the line with, like '> '

Returns: string Response

Definition at line 1620 of file Maintenance.php.

References posix_isatty(), and readlineEmulation().

Referenced by MwSql\execute(), and CdbInspector\execute().

◆ readlineEmulation()

static Maintenance::readlineEmulation ( $prompt )

staticprivate

Emulate readline()

Parameters

string $prompt What to begin the line with, like '> '

Returns: string

Definition at line 1652 of file Maintenance.php.

References $command, $line, ExecutableFinder\findInDefaultPaths(), and wfIsWindows().

Referenced by readconsole().

◆ relockSearchindex()

Maintenance::relockSearchindex ( $db )

private

Unlock and lock again Since the lock is low-priority, queued reads will be able to complete.

Parameters

IMaintainableDatabase $db

Definition at line 1507 of file Maintenance.php.

References lockSearchindex(), and unlockSearchindex().

Referenced by updateSearchIndex().

◆ requireExtension()

Maintenance::requireExtension ( $name )

protected

Indicate that the specified extension must be loaded before the script can run.

This must be called in the constructor.

Since: 1.28

Parameters

string $name

Definition at line 642 of file Maintenance.php.

◆ requireTestsAutoloader()

static Maintenance::requireTestsAutoloader ( )

static

Call this to set up the autoloader to allow classes to be used from the tests directory.

Definition at line 1719 of file Maintenance.php.

Referenced by CheckLess\execute().

◆ rollbackTransaction()

Maintenance::rollbackTransaction	(	IDatabase	$dbw,
			$fname
	)

protected

Rollback the transcation on a DB handle.

This method makes it clear that rollback() is called from a maintenance script, which has outermost scope. This is safe, unlike $dbw->rollback() called in other places.

Parameters

IDatabase	$dbw
string	$fname	Caller name

Since: 1.27

Definition at line 1472 of file Maintenance.php.

References Wikimedia\Rdbms\IDatabase\rollback().

Referenced by CleanupImages\pokeFile(), and PopulateContentTables\populateContentTablesForRowBatch().

◆ runChild()

Maintenance::runChild	(	$maintClass,
		$classFile = `null`
	)

Run a child maintenance script.

Pass all of the current arguments to it.

Parameters

string	$maintClass	A name of a child maintenance class
string \| null	$classFile	Full path of where the child is

Returns: Maintenance

Definition at line 731 of file Maintenance.php.

References $maintClass, and error().

Referenced by RebuildAll\execute(), NukeNS\execute(), and UpdateMediaWiki\execute().

◆ setAgentAndTriggers()

Maintenance::setAgentAndTriggers ( )

Set triggers like when to try to run deferred updates.

Since: 1.28

Definition at line 672 of file Maintenance.php.

References getConfig(), setLBFactoryTriggers(), and wfHostname().

◆ setAllowUnregisteredOptions()

Maintenance::setAllowUnregisteredOptions ( $allow )

protected

Sets whether to allow unregistered options, which are options passed to a script that do not match an expected parameter.

Parameters

bool $allow Should we allow?

Definition at line 344 of file Maintenance.php.

Referenced by CommandLineInc\__construct().

◆ setBatchSize()

Maintenance::setBatchSize ( $s = 0 )

protected

Set the batch size.

Parameters

int $s The number of operations to do in a batch

Definition at line 398 of file Maintenance.php.

References $s, and addOption().

◆ setConfig()

Maintenance::setConfig ( Config $config )

Since: 1.24

Parameters

Config $config

Definition at line 629 of file Maintenance.php.

References $config.

◆ setDB()

Maintenance::setDB ( IMaintainableDatabase $db )

Sets database object to be returned by getDB().

Parameters

IMaintainableDatabase $db

Reimplemented in BackupDumper.

Definition at line 1423 of file Maintenance.php.

Referenced by DatabaseUpdater\__construct().

◆ setLBFactoryTriggers()

static Maintenance::setLBFactoryTriggers	(	LBFactory	$LBFactory,
		Config	$config
	)

static

Parameters

LBFactory	$LBFactory
Config	$config

Since: 1.28

Definition at line 693 of file Maintenance.php.

References $config, MediaWiki\emitBufferedStatsdData(), Config\get(), and DeferredUpdates\tryOpportunisticExecute().

Referenced by setAgentAndTriggers().

◆ setParam()

Maintenance::setParam	(	&	$options,
			$option,
			$value
	)

private

Helper function used solely by loadParamsAndArgs to prevent code duplication.

This sets the param in the options array based on whether or not it can be specified multiple times.

Since: 1.27

Parameters

array	&$options
string	$option
mixed	$value

Definition at line 953 of file Maintenance.php.

References error(), and maybeHelp().

Referenced by loadWithArgv().

◆ setup()

Maintenance::setup ( )

Do some sanity checking and basic setup.

Definition at line 757 of file Maintenance.php.

References $IP, $wgCommandLineMode, adjustMemoryLimit(), fatalError(), and loadParamsAndArgs().

◆ shouldExecute()

static Maintenance::shouldExecute ( )

static

Should we execute the maintenance script, or just allow it to be included as a standalone class? It checks that the call stack only includes this function and "requires" (meaning was called from the file scope)

Returns: bool

Definition at line 214 of file Maintenance.php.

References $wgCommandLineMode.

◆ showHelp()

Maintenance::showHelp ( )

protected

Definitely show the help.

Does not exit.

Definition at line 1078 of file Maintenance.php.

References $mDependantParameters, and output().

Referenced by maybeHelp().

◆ supportsOption()

Maintenance::supportsOption ( $name )

protected

Checks to see if a particular option in supported.

Normally this means it has been registered by the script via addOption.

Parameters

string $name The name of the option

Returns: bool true if the option exists, false otherwise

Definition at line 256 of file Maintenance.php.

Referenced by validateParamsAndArgs().

◆ unlockSearchindex()

Maintenance::unlockSearchindex ( $db )

private

Unlock the tables.

Parameters

IMaintainableDatabase $db

Definition at line 1498 of file Maintenance.php.

Referenced by relockSearchindex(), and updateSearchIndex().

◆ updateSearchIndex()

Maintenance::updateSearchIndex	(	$maxLockTime,
		$callback,
		$dbw,
		$results
	)

Perform a search index update with locking.

Parameters

int	$maxLockTime	The maximum time to keep the search index locked.
callable	$callback	The function that will update the function.
IMaintainableDatabase	$dbw
array \| IResultWrapper	$results

Definition at line 1519 of file Maintenance.php.

References lockSearchindex(), output(), relockSearchindex(), and unlockSearchindex().

Referenced by UpdateSearchIndex\doUpdateSearchIndex(), and UpdateDoubleWidthSearch\execute().

◆ updateSearchIndexForPage()

Maintenance::updateSearchIndexForPage	(	$dbw,
		$pageId
	)

Update the searchindex table for a given pageid.

Parameters

IDatabase	$dbw	A database write handle
int	$pageId	The page ID to update.

Returns: null|string

Definition at line 1556 of file Maintenance.php.

References $title, Revision\loadFromPageId(), and output().

Referenced by UpdateDoubleWidthSearch\searchIndexUpdateCallback(), and UpdateSearchIndex\searchIndexUpdateCallback().

◆ validateParamsAndArgs()

Maintenance::validateParamsAndArgs ( )

Run some validation checks on the params, etc.

Reimplemented in UpdateMediaWiki, CommandLineInstaller, and GetConfiguration.

Definition at line 1015 of file Maintenance.php.

References error(), hasArg(), hasOption(), maybeHelp(), and supportsOption().

Member Data Documentation

◆ $atLineStart

Maintenance::$atLineStart = true

private

Definition at line 513 of file Maintenance.php.

◆ $config

Config Maintenance::$config

private

Accessible via getConfig()

Definition at line 174 of file Maintenance.php.

Referenced by PopulateImageSha1\doDBUpdates(), BenchmarkTidy\execute(), MediaWikiShell\execute(), getConfig(), setConfig(), setLBFactoryTriggers(), and UpdateExtensionJsonSchema\updateTo2().

◆ $fileHandle

resource Maintenance::$fileHandle

Used when creating separate schema files.

Definition at line 167 of file Maintenance.php.

Referenced by CdbInspector\execute(), and CdbInspector\loadFile().

◆ $lastChannel

Maintenance::$lastChannel = null

private

Definition at line 514 of file Maintenance.php.

◆ $lastReplicationWait

float Maintenance::$lastReplicationWait = 0.0

private

UNIX timestamp.

Definition at line 161 of file Maintenance.php.

Referenced by UppercaseTitlesForUnicodeTransition\processTable().

◆ $mAllowUnregisteredOptions

Maintenance::$mAllowUnregisteredOptions = false

protected

Definition at line 118 of file Maintenance.php.

◆ $mArgList

Maintenance::$mArgList = []

protected

Definition at line 109 of file Maintenance.php.

◆ $mArgs

Maintenance::$mArgs = []

protected

Definition at line 115 of file Maintenance.php.

Referenced by JSParseHelper\execute(), and CommandLineInc\execute().

◆ $mBatchSize

int Maintenance::$mBatchSize = null

protected

Batch size.

If a script supports this, they should set a default with setBatchSize()

Definition at line 139 of file Maintenance.php.

Referenced by CleanupRevActorPage\doDBUpdates(), PopulateExternallinksIndex60\doDBUpdates(), and getBatchSize().

◆ $mDb

IMaintainableDatabase Maintenance::$mDb = null

private

Used by getDB() / setDB()

Definition at line 158 of file Maintenance.php.

Referenced by getDB().

◆ $mDbPass

Maintenance::$mDbPass

Definition at line 125 of file Maintenance.php.

Referenced by finalSetup().

◆ $mDbUser

Maintenance::$mDbUser

protected

Definition at line 125 of file Maintenance.php.

Referenced by finalSetup().

◆ $mDependantParameters

array [] Maintenance::$mDependantParameters = []

private

Generic options which might or not be supported by the script.

-var array<string,array{desc:string,require:bool,withArg:string,shortName:string,multiOccurrence:bool}>

Definition at line 152 of file Maintenance.php.

Referenced by showHelp().

◆ $mDescription

Maintenance::$mDescription = ''

protected

Definition at line 128 of file Maintenance.php.

◆ $mGenericParameters

array [] Maintenance::$mGenericParameters = []

private

Generic options added by addDefaultParams()

-var array<string,array{desc:string,require:bool,withArg:string,shortName:string,multiOccurrence:bool}>

Definition at line 146 of file Maintenance.php.

◆ $mInputLoaded

Maintenance::$mInputLoaded = false

protected

Definition at line 131 of file Maintenance.php.

◆ $mOptions

Maintenance::$mOptions = []

protected

Definition at line 112 of file Maintenance.php.

Referenced by CommandLineInc\execute().

◆ $mParams

array [] Maintenance::$mParams = []

protected

Array of desired/allowed params.

-var array<string,array{desc:string,require:bool,withArg:string,shortName:string,multiOccurrence:bool}>

Definition at line 103 of file Maintenance.php.

Referenced by addDefaultParams().

◆ $mQuiet

Maintenance::$mQuiet = false

protected

Definition at line 124 of file Maintenance.php.

Referenced by isQuiet().

◆ $mSelf

Maintenance::$mSelf

protected

Definition at line 121 of file Maintenance.php.

Referenced by getName().

◆ $mShortParamsMap

Maintenance::$mShortParamsMap = []

protected

Definition at line 106 of file Maintenance.php.

◆ $orderedOptions

array Maintenance::$orderedOptions = []

Used to read the options in the order they were passed.

Useful for option chaining (Ex. dumpBackup.php). It will be an empty array if the options are passed in through loadParamsAndArgs( $self, $opts, $args ).

This is an array of arrays where 0 => the option and 1 => parameter value.

Definition at line 193 of file Maintenance.php.

Referenced by BackupDumper\processOptions().

◆ $requiredExtensions

array Maintenance::$requiredExtensions = []

private

See also: Maintenance::requireExtension

Definition at line 180 of file Maintenance.php.

◆ DB_ADMIN

const Maintenance::DB_ADMIN = 2

Definition at line 93 of file Maintenance.php.

Referenced by RebuildAll\getDbType(), RenameDbPrefix\getDbType(), PatchSql\getDbType(), RebuildTextIndex\getDbType(), UpdateDoubleWidthSearch\getDbType(), UpdateSearchIndex\getDbType(), UpdateMediaWiki\getDbType(), ConvertLinks\getDbType(), RunBatchedQuery\getDbType(), and MwSql\getDbType().

◆ DB_NONE

const Maintenance::DB_NONE = 0

Constants for DB access type.

See also: Maintenance::getDbType()

Definition at line 91 of file Maintenance.php.

Referenced by DumpIterator\finalSetup(), GenerateNormalizerDataMl\getDbType(), GenerateNormalizerDataAr\getDbType(), SqliteMaintenance\getDbType(), PreprocessDump\getDbType(), FindHooks\getDbType(), MWDocGen\getDbType(), CommandLineInstaller\getDbType(), and SearchDump\getDbType().

◆ DB_STD

const Maintenance::DB_STD = 1

Definition at line 92 of file Maintenance.php.

Referenced by getDbType().

◆ STDIN_ALL

const Maintenance::STDIN_ALL = 'all'

Definition at line 96 of file Maintenance.php.

Referenced by EditCLI\execute().

The documentation for this class was generated from the following file:

maintenance/Maintenance.php

Public Member Functions

Static Public Member Functions

Public Attributes

Protected Member Functions

Protected Attributes

Private Member Functions

Static Private Member Functions

Private Attributes

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ activateProfiler()

◆ addArg()

◆ addDefaultParams()

◆ addDescription()

◆ addOption()

◆ adjustMemoryLimit()

◆ afterFinalSetup()

◆ beginTransaction()

◆ checkRequiredExtensions()

◆ cleanupChanneled()

◆ clearParamsAndArgs()

◆ commitTransaction()

◆ countDown()

◆ deleteOption()

◆ error()

◆ execute()

◆ fatalError()

◆ finalSetup()

◆ getArg()

◆ getBatchSize()

◆ getConfig()

◆ getDB()

◆ getDbType()

◆ getDir()

◆ getName()

◆ getOption()

◆ getStdin()

◆ getTermSize()

◆ globals()

◆ hasArg()

◆ hasOption()

◆ isQuiet()

◆ loadParamsAndArgs()

◆ loadSettings()

◆ loadSpecialVars()

◆ loadWithArgv()

◆ lockSearchindex()

◆ maybeHelp()

◆ memoryLimit()

◆ output()

◆ outputChanneled()

◆ posix_isatty()

◆ purgeRedundantText()

◆ readconsole()

◆ readlineEmulation()

◆ relockSearchindex()

◆ requireExtension()

◆ requireTestsAutoloader()

◆ rollbackTransaction()

◆ runChild()

◆ setAgentAndTriggers()

◆ setAllowUnregisteredOptions()

◆ setBatchSize()

◆ setConfig()

◆ setDB()

◆ setLBFactoryTriggers()

◆ setParam()

◆ setup()

◆ shouldExecute()

◆ showHelp()

◆ supportsOption()

◆ unlockSearchindex()

◆ updateSearchIndex()

◆ updateSearchIndexForPage()

◆ validateParamsAndArgs()

Member Data Documentation

◆ $atLineStart

◆ $config