MediaWiki  master
Maintenance Class Reference

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

Inheritance diagram for Maintenance:
Collaboration diagram for Maintenance:

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 (int $pageId)
 Update the searchindex table for a given pageid. More...
 
 validateParamsAndArgs ()
 Run some validation checks on the params, etc Stable for overriding. 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 @stable for overriding. 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...
 
 getHookContainer ()
 Get a HookContainer, for running extension hooks or for hook metadata. More...
 
 getHookRunner ()
 Get a HookRunner for running core hooks. 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 @stable for overriding. More...
 
 maybeHelp ( $force=false)
 Maybe show the help. More...
 
 output ( $out, $channel=null)
 Throw some output to the user. More...
 
 parseIntList ( $text)
 Utility function to parse a string (perhaps from a command line option) into a list of integers (perhaps some kind of numeric IDs). 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)
 
 showHelp ()
 Definitely show the help. More...
 
 supportsOption ( $name)
 Checks to see if a particular option in supported. More...
 

Protected Attributes

bool $mAllowUnregisteredOptions = false
 Allow arbitrary options to be passed, or only specified ones? More...
 
array $mArgList = []
 Desired/allowed args. More...
 
array $mArgs = []
 This is the list of arguments that were actually passed. More...
 
int $mBatchSize = null
 Batch size. More...
 
 $mDbUser
 
string $mDescription = ''
 A description of the script, children should change this via addDescription() More...
 
bool $mInputLoaded = false
 Have we already loaded our user input? More...
 
array $mOptions = []
 This is the list of options that were actually passed. More...
 
array[] $mParams = []
 Array of desired/allowed params. More...
 
bool $mQuiet = false
 Special vars for params that are always used. More...
 
string null $mSelf
 Name of the script currently running. More...
 
array $mShortParamsMap = []
 Mapping short parameters to long ones. More...
 

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...
 
HookContainer null $hookContainer
 
HookRunner null $hookRunner
 
 $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

Stable for subclassing

Since
1.16

Definition at line 55 of file Maintenance.php.

Constructor & Destructor Documentation

◆ __construct()

Maintenance::__construct ( )

Default constructor.

Children should call this first if implementing their own constructors

Stable for calling

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

Definition at line 176 of file Maintenance.php.

References addDefaultParams().

Member Function Documentation

◆ activateProfiler()

Maintenance::activateProfiler ( )
protected

Activate the profiler (assuming $wgProfiler is set)

Definition at line 816 of file Maintenance.php.

References $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$argName of the arg, like 'start'
string$descriptionShort description of the arg
bool$requiredIs this required?

Definition at line 298 of file Maintenance.php.

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

◆ addDefaultParams()

Maintenance::addDefaultParams ( )
protected

Add the default parameters to the scripts.

Definition at line 553 of file Maintenance.php.

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

Referenced by __construct().

◆ addDescription()

Maintenance::addDescription (   $text)
protected

Set the description text.

Parameters
string$textThe text of the description

Definition at line 327 of file Maintenance.php.

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

◆ 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$nameThe name of the param (help, version, etc)
string$descriptionThe description of the param to show on –help
bool$requiredIs the param required?
bool$withArgIs an argument required with this option?
string | bool$shortNameCharacter to use as short name
bool$multiOccurrenceCan this option be passed multiple times?

Definition at line 245 of file Maintenance.php.

Referenced by DumpBackup\__construct(), BackupDumper\__construct(), TextPassDumper\__construct(), AddChangeTag\__construct(), AddSite\__construct(), AttachLatest\__construct(), BenchWikimediaBaseConvert\__construct(), BenchmarkCSSMin\__construct(), BenchmarkJavaScriptMinifier\__construct(), BenchmarkJSMinPlus\__construct(), BenchmarkLruHash\__construct(), BenchmarkParse\__construct(), BenchmarkSanitizer\__construct(), BenchmarkTidy\__construct(), BlockUsers\__construct(), CategoryChangesAsRdf\__construct(), ChangePassword\__construct(), CheckDependencies\__construct(), CleanupAncientTables\__construct(), CleanupCaps\__construct(), CleanupInvalidDbKeys\__construct(), CleanupPreferences\__construct(), CleanupSpam\__construct(), CleanupUsersWithNoId\__construct(), CleanupWatchlist\__construct(), CommandLineInc\__construct(), CompareParserCache\__construct(), CompareParsers\__construct(), ConvertExtensionToRegistration\__construct(), CopyFileBackend\__construct(), CopyJobQueue\__construct(), CreateAndPromote\__construct(), CreateBotPassword\__construct(), DeleteArchivedFiles\__construct(), DeleteArchivedRevisions\__construct(), DeleteAutoPatrolLogs\__construct(), DeleteBatch\__construct(), DeleteDefaultMessages\__construct(), DeleteEqualMessages\__construct(), DeleteOldRevisions\__construct(), DeleteOrphanedRevisions\__construct(), DumpCategoriesAsRdf\__construct(), DumpIterator\__construct(), SearchDump\__construct(), DumpUploads\__construct(), EditCLI\__construct(), EraseArchivedFile\__construct(), FileOpPerfTest\__construct(), FindBadBlobs\__construct(), FindMissingActors\__construct(), FindMissingFiles\__construct(), FindOrphanedFiles\__construct(), FixDoubleRedirects\__construct(), FormatInstallDoc\__construct(), GenerateJsonI18n\__construct(), GenerateSchemaSql\__construct(), GenerateSitemap\__construct(), GetConfiguration\__construct(), GetLagTimes\__construct(), GetReplicaServer\__construct(), GetTextMaint\__construct(), BackupReader\__construct(), ImportImages\__construct(), ImportSiteScripts\__construct(), ImportTextFiles\__construct(), Benchmarker\__construct(), DeleteLocalPasswords\__construct(), LoggedUpdateMaintenance\__construct(), MigrateActors\__construct(), InitEditCount\__construct(), InitSiteStats\__construct(), InitUserPreference\__construct(), CommandLineInstaller\__construct(), InvalidateUserSesssions\__construct(), DatabaseLag\__construct(), GenerateCollationData\__construct(), GenerateNormalizerDataAr\__construct(), GenerateUcfirstOverrides\__construct(), GenerateUpperCharTable\__construct(), ListVariants\__construct(), MakeTestEdits\__construct(), ManageForeignResources\__construct(), ManageJobs\__construct(), McTest\__construct(), MergeMessageFileList\__construct(), MigrateArchiveText\__construct(), MigrateFileRepoLayout\__construct(), MinifyScript\__construct(), MoveBatch\__construct(), MWDocGen\__construct(), MysqlMaintenance\__construct(), NamespaceDupes\__construct(), NukeNS\__construct(), NukePage\__construct(), Orphans\__construct(), CLIParser\__construct(), PopulateBacklinkNamespace\__construct(), PopulateChangeTagDef\__construct(), PopulateContentTables\__construct(), PopulateImageSha1\__construct(), PopulateInterwiki\__construct(), PopulateIpChanges\__construct(), PreprocessDump\__construct(), Protect\__construct(), PruneFileCache\__construct(), PurgeChangedFiles\__construct(), PurgeChangedPages\__construct(), PurgeList\__construct(), PurgeOldText\__construct(), PurgePage\__construct(), PurgeParserCache\__construct(), ReassignEdits\__construct(), RebuildFileCache\__construct(), ImageBuilder\__construct(), RebuildLocalisationCache\__construct(), RebuildRecentchanges\__construct(), RecountCategories\__construct(), RefreshFileHeaders\__construct(), RefreshImageMetadata\__construct(), RefreshLinks\__construct(), RemoveInvalidEmails\__construct(), RemoveUnusedAccounts\__construct(), RenameDbPrefix\__construct(), DumpRenderer\__construct(), ResetAuthenticationThrottle\__construct(), ResetPageRandom\__construct(), ResetUserEmail\__construct(), ResetUserTokens\__construct(), RollbackEdits\__construct(), RunBatchedQuery\__construct(), RunJobs\__construct(), MediaWikiShell\__construct(), ShowJobs\__construct(), MwSql\__construct(), SqliteMaintenance\__construct(), CompressOld\__construct(), SyncFileBackend\__construct(), TableCleanup\__construct(), Undelete\__construct(), UpdateMediaWiki\__construct(), UpdateArticleCount\__construct(), UpdateCollation\__construct(), UpdateDoubleWidthSearch\__construct(), UpdateSearchIndex\__construct(), UpdateSpecialPages\__construct(), UppercaseTitlesForUnicodeTransition\__construct(), UserOptionsMaintenance\__construct(), WrapOldPasswords\__construct(), addDefaultParams(), setBatchSize(), and UpdateMediaWiki\validateParamsAndArgs().

◆ adjustMemoryLimit()

Maintenance::adjustMemoryLimit ( )
protected

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

Definition at line 803 of file Maintenance.php.

References memoryLimit().

Referenced by finalSetup(), and setup().

◆ afterFinalSetup()

Maintenance::afterFinalSetup ( )
protected

Execute a callback function at the end of initialisation @stable for overriding.

Reimplemented in UpdateMediaWiki.

Definition at line 1246 of file Maintenance.php.

Referenced by finalSetup().

◆ beginTransaction()

◆ checkRequiredExtensions()

Maintenance::checkRequiredExtensions ( )

Verify that the required extensions are installed.

Since
1.28

Definition at line 629 of file Maintenance.php.

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

◆ cleanupChanneled()

Maintenance::cleanupChanneled ( )

Clean up channeled output.

Output a newline if necessary.

Definition at line 497 of file Maintenance.php.

Referenced by output(), and outputChanneled().

◆ clearParamsAndArgs()

Maintenance::clearParamsAndArgs ( )

Clear all params and arguments.

Definition at line 844 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$fnameCaller name
Returns
bool Whether the replica DB wait succeeded
Since
1.27

Definition at line 1415 of file Maintenance.php.

References Wikimedia\Rdbms\IDatabase\commit().

Referenced by CleanupSpam\cleanupArticle(), CompressOld\compressWithConcat(), CleanupPreferences\deleteByWhere(), NukePage\deleteRevisions(), DeduplicateArchiveRevId\doDBUpdates(), MigrateArchiveText\doDBUpdates(), MigrateImageCommentTemp\doDBUpdates(), PopulateLogUsertext\doDBUpdates(), PopulatePPSortKey\doDBUpdates(), DeleteOldRevisions\doDelete(), PopulateRevisionLength\doLenUpdates(), ReassignEdits\doReassignEdits(), PopulateRevisionSha1\doSha1LegacyUpdates(), PopulateRevisionSha1\doSha1Updates(), CleanupRemovedModules\execute(), DeleteArchivedFiles\execute(), DeleteOrphanedRevisions\execute(), DeleteSelfExternals\execute(), MigrateUserGroup\execute(), MoveBatch\execute(), NukeNS\execute(), NukePage\execute(), PurgeModuleDeps\execute(), RebuildFileCache\execute(), UpdateCollation\execute(), UpdateRestrictions\execute(), WrapOldPasswords\execute(), RemoveUnusedAccounts\isInactiveAccount(), NamespaceDupes\mergePage(), MigrateActors\migrateToTemp(), MigrateComments\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 1547 of file Maintenance.php.

References isQuiet(), and output().

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

◆ deleteOption()

Maintenance::deleteOption (   $name)
protected

Remove an option.

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

Parameters
string$nameThe option to remove.

Definition at line 310 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 Stable for overriding

Parameters
string$errThe error to display
int$dieDeprecated since 1.31, use Maintenance::fatalError() instead

Definition at line 462 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(), FixExtLinksProtocolRelative\doDBUpdates(), MigrateActors\doDBUpdates(), MigrateArchiveText\doDBUpdates(), MigrateImageCommentTemp\doDBUpdates(), PopulateLogSearch\doDBUpdates(), PopulateParentId\doDBUpdates(), PopulateRecentChangesSource\doDBUpdates(), RefreshExternallinksIndex\doDBUpdates(), UppercaseTitlesForUnicodeTransition\doMove(), CleanupUploadStash\doOperations(), UpdateSpecialPages\doSpecialPageCacheUpdates(), UppercaseTitlesForUnicodeTransition\doUpdate(), BenchmarkParse\execute(), BenchmarkPurge\execute(), CategoryChangesAsRdf\execute(), CleanupAncientTables\execute(), ConvertLinks\execute(), CreateAndPromote\execute(), DeleteArchivedFiles\execute(), DeleteSelfExternals\execute(), DumpIterator\execute(), FixDoubleRedirects\execute(), GenerateJsonI18n\execute(), ImportSiteScripts\execute(), ImportTextFiles\execute(), Digit2Html\execute(), GenerateNormalizerDataAr\execute(), ManageForeignResources\execute(), MergeMessageFileList\execute(), MigrateFileRepoLayout\execute(), MoveBatch\execute(), MysqlMaintenance\execute(), PatchSql\execute(), PopulateInterwiki\execute(), PurgeChangedFiles\execute(), PurgeChangedPages\execute(), PurgeExpiredWatchlistItems\execute(), ReassignEdits\execute(), DumpRenderer\execute(), ResetUserEmail\execute(), RollbackEdits\execute(), SqliteMaintenance\execute(), CompressOld\execute(), UpdateSearchIndex\execute(), UppercaseTitlesForUnicodeTransition\execute(), fatalError(), DumpIterator\handleRevision(), DumpRenderer\handleRevision(), FindBadBlobs\handleStatus(), SqliteMaintenance\integrityCheck(), loadWithArgv(), MigrateActors\migrate(), MigrateActors\migrateLogSearch(), MigrateActors\migrateToTemp(), UppercaseTitlesForUnicodeTransition\mungeTitle(), CleanupImages\pokeFile(), CompareParsers\processRevision(), PreprocessDump\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 WrapOldPasswords, ViewCLI, Version, ValidateRegistrationFile, UserOptionsMaintenance, UppercaseTitlesForUnicodeTransition, UpdateSpecialPages, UpdateSearchIndex, UpdateRestrictions, UpdateExtensionJsonSchema, UpdateDoubleWidthSearch, UpdateCollation, UpdateArticleCount, UpdateMediaWiki, Undelete, TidyUpT39714, TableCleanup, SyncFileBackend, StorageTypeStats, OrphanStats, DumpRev, CompressOld, SqliteMaintenance, MwSql, ShowSiteStats, ShowJobs, MediaWikiShell, RunJobs, RunBatchedQuery, RollbackEdits, ResetUserTokens, ResetUserEmail, ResetPageRandom, ResetAuthenticationThrottle, DumpRenderer, RenameRestrictions, RenameDbPrefix, RemoveUnusedAccounts, RemoveInvalidEmails, RefreshLinks, RefreshImageMetadata, RefreshFileHeaders, RecountCategories, RebuildTextIndex, RebuildRecentchanges, RebuildMessages, RebuildLocalisationCache, ImageBuilder, RebuildFileCache, RebuildAll, ReassignEdits, PurgeParserCache, PurgePage, PurgeOldText, PurgeModuleDeps, PurgeList, PurgeExpiredWatchlistItems, PurgeExpiredUserrights, PurgeExpiredBlocks, PurgeChangedPages, PurgeChangedFiles, PruneFileCache, Protect, PopulateInterwiki, PopulateImageSha1, PopulateContentTables, PopulateCategory, PatchSql, CLIParser, PageExists, Orphans, NukePage, NukeNS, NamespaceDupes, MysqlMaintenance, MWDocGen, MoveBatch, MinifyScript, MigrateUserGroup, MigrateFileRepoLayout, MergeMessageFileList, GeneratePhpCharToUpperMappings, McTest, ManageJobs, ManageForeignResources, MakeTestEdits, ListVariants, LangMemUsage, GenerateUpperCharTable, GenerateUcfirstOverrides, GenerateNormalizerDataMl, GenerateNormalizerDataAr, GenerateCollationData, DumpMessages, Digit2Html, DateFormats, AllTrans, DatabaseLag, JSParseHelper, InvalidateUserSesssions, CommandLineInstaller, InitUserPreference, InitSiteStats, InitEditCount, TextPassDumper, LoggedUpdateMaintenance, FakeMaintenance, DeleteLocalPasswords, BackupDumper, ImportTextFiles, ImportSiteScripts, ImportSites, ImportImages, BackupReader, GetTextMaint, GetReplicaServer, GetLagTimes, GetConfiguration, GenerateSitemap, GenerateSchemaSql, GenerateJsonI18n, FormatInstallDoc, FixUserRegistration, FixTimestamps, FixDoubleRedirects, FindOrphanedFiles, FindMissingFiles, FindMissingActors, FindDeprecated, FindBadBlobs, FileOpPerfTest, FetchText, ExportSites, EraseArchivedFile, EmptyUserGroup, EditCLI, DumpUploads, DumpLinks, DumpIterator, DumpCategoriesAsRdf, DumpBackup, DeleteTag, DeleteSelfExternals, DeleteOrphanedRevisions, DeleteOldRevisions, DeleteEqualMessages, DeleteDefaultMessages, DeleteBatch, DeleteAutoPatrolLogs, DeleteArchivedRevisions, DeleteArchivedFiles, CreateBotPassword, CreateAndPromote, CopyJobQueue, CopyFileBackend, ConvertUserOptions, ConvertLinks, ConvertExtensionToRegistration, CompareParserCache, CommandLineInc, ClearInterwikiCache, CleanupWatchlist, CleanupUploadStash, CleanupSpam, CleanupRemovedModules, CleanupPreferences, CleanupInvalidDbKeys, CleanupCaps, CleanupBlocks, CleanupAncientTables, CheckUsernames, CheckLess, CheckImages, CheckDependencies, CheckComposerLockUpToDate, CheckBadRedirects, ChangePassword, CategoryChangesAsRdf, BlockUsers, BenchmarkTitleValue, BenchmarkTidy, BenchmarkStringReplacement, BenchmarkSanitizer, BenchmarkPurge, BenchmarkParse, BenchmarkLruHash, BenchmarkJSMinPlus, BenchmarkJavaScriptMinifier, BenchmarkHooks, BenchmarkCSSMin, BenchWikimediaBaseConvert, BenchUtf8TitleCheck, BenchIfSwitch, BenchHttpHttps, BenchmarkDeleteTruncate, AttachLatest, AddSite, and AddChangeTag.

◆ fatalError()

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

Output a message and terminate the current script.

Stable for overriding

Parameters
string$msgError message
int$exitCodePHP exit status. Should be in range 1-254.
Since
1.31

Definition at line 486 of file Maintenance.php.

References error().

Referenced by checkRequiredExtensions(), ResetAuthenticationThrottle\clearLoginThrottle(), UpdateMediaWiki\compatChecks(), CopyFileBackend\copyFileBatch(), CopyFileBackend\delFileBatch(), PopulateImageSha1\doDBUpdates(), PopulateIpChanges\doDBUpdates(), PopulateRevisionLength\doDBUpdates(), PopulateRevisionSha1\doDBUpdates(), error(), AddChangeTag\execute(), BenchmarkJavaScriptMinifier\execute(), BenchmarkJSMinPlus\execute(), BenchmarkParse\execute(), BenchmarkTidy\execute(), BlockUsers\execute(), ChangePassword\execute(), CheckComposerLockUpToDate\execute(), CleanupSpam\execute(), CleanupUploadStash\execute(), ConvertExtensionToRegistration\execute(), CopyFileBackend\execute(), CopyJobQueue\execute(), CreateAndPromote\execute(), CreateBotPassword\execute(), DeleteBatch\execute(), DeleteDefaultMessages\execute(), DeleteEqualMessages\execute(), DeleteTag\execute(), DumpBackup\execute(), DumpIterator\execute(), EditCLI\execute(), EraseArchivedFile\execute(), ExportSites\execute(), FindBadBlobs\execute(), FindMissingActors\execute(), FindOrphanedFiles\execute(), FixDoubleRedirects\execute(), FixTimestamps\execute(), FormatInstallDoc\execute(), GenerateJsonI18n\execute(), GenerateSitemap\execute(), GetTextMaint\execute(), BackupReader\execute(), ImportImages\execute(), ImportTextFiles\execute(), InvalidateUserSesssions\execute(), GenerateCollationData\execute(), GenerateNormalizerDataAr\execute(), LangMemUsage\execute(), MakeTestEdits\execute(), ManageJobs\execute(), McTest\execute(), GeneratePhpCharToUpperMappings\execute(), MergeMessageFileList\execute(), MigrateFileRepoLayout\execute(), MigrateUserGroup\execute(), MoveBatch\execute(), MWDocGen\execute(), Protect\execute(), PruneFileCache\execute(), PurgeList\execute(), PurgeParserCache\execute(), RebuildFileCache\execute(), RebuildLocalisationCache\execute(), RebuildRecentchanges\execute(), RebuildTextIndex\execute(), RecountCategories\execute(), RefreshImageMetadata\execute(), RefreshLinks\execute(), RemoveUnusedAccounts\execute(), RenameDbPrefix\execute(), DumpRenderer\execute(), ResetAuthenticationThrottle\execute(), ResetUserEmail\execute(), RollbackEdits\execute(), RunJobs\execute(), MediaWikiShell\execute(), MwSql\execute(), CompressOld\execute(), DumpRev\execute(), OrphanStats\execute(), SyncFileBackend\execute(), Undelete\execute(), UpdateMediaWiki\execute(), UpdateDoubleWidthSearch\execute(), UpdateExtensionJsonSchema\execute(), UpdateRestrictions\execute(), UpdateSpecialPages\execute(), UppercaseTitlesForUnicodeTransition\execute(), ValidateRegistrationFile\execute(), Version\execute(), ViewCLI\execute(), WrapOldPasswords\execute(), GenerateCollationData\generateFirstChars(), MinifyScript\getExtension(), CopyFileBackend\getListingDiffRel(), FindMissingActors\getNewActorId(), BackupReader\getNsIndex(), RefreshLinks\getPossibleCategories(), FindBadBlobs\getStartTimestamp(), PopulateContentTables\getTables(), ConvertExtensionToRegistration\handleExtensionFunctions(), ConvertExtensionToRegistration\handleHooks(), FindBadBlobs\handleStatus(), 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()

◆ getArg()

◆ getBatchSize()

Maintenance::getBatchSize ( )
protected

Returns batch size.

Since
1.31
Returns
int|null

Definition at line 366 of file Maintenance.php.

References $mBatchSize.

Referenced by PopulateChangeTagDef\backpopulateChangeTagPerTag(), CopyJobQueue\copyJobs(), DeduplicateArchiveRevId\doDBUpdates(), MigrateArchiveText\doDBUpdates(), MigrateImageCommentTemp\doDBUpdates(), PopulateArchiveRevId\doDBUpdates(), PopulateBacklinkNamespace\doDBUpdates(), PopulateChangeTagDef\doDBUpdates(), PopulateFilearchiveSha1\doDBUpdates(), PopulateImageSha1\doDBUpdates(), PopulateIpChanges\doDBUpdates(), PopulateLogSearch\doDBUpdates(), PopulateLogUsertext\doDBUpdates(), PopulateParentId\doDBUpdates(), PopulatePPSortKey\doDBUpdates(), PopulateRecentChangesSource\doDBUpdates(), PopulateRevisionLength\doLenUpdates(), PopulateRevisionSha1\doSha1Updates(), RecountCategories\doWork(), CheckUsernames\execute(), CleanupBlocks\execute(), CleanupRemovedModules\execute(), CleanupUploadStash\execute(), CopyFileBackend\execute(), DeleteAutoPatrolLogs\execute(), DeleteTag\execute(), EmptyUserGroup\execute(), FindMissingFiles\execute(), FindOrphanedFiles\execute(), InitUserPreference\execute(), InvalidateUserSesssions\execute(), MakeTestEdits\execute(), MigrateFileRepoLayout\execute(), MigrateUserGroup\execute(), PurgeChangedPages\execute(), PurgeExpiredWatchlistItems\execute(), PurgeModuleDeps\execute(), RebuildFileCache\execute(), RefreshFileHeaders\execute(), RefreshImageMetadata\execute(), RefreshLinks\execute(), ResetPageRandom\execute(), ResetUserTokens\execute(), UpdateRestrictions\execute(), FindMissingActors\findBadActors(), DumpCategoriesAsRdf\getCategoryIterator(), DumpCategoriesAsRdf\getCategoryLinksIterator(), DeleteAutoPatrolLogs\getRows(), DeleteAutoPatrolLogs\getRowsOld(), DeleteLocalPasswords\getUserBatches(), PopulateContentTables\loadContentMap(), MigrateComments\migrate(), MigrateComments\migrateToTemp(), PopulateContentTables\populateTable(), UppercaseTitlesForUnicodeTransition\processTable(), UppercaseTitlesForUnicodeTransition\processUsers(), PurgeChangedFiles\purgeFromLogType(), RebuildRecentchanges\rebuildRecentChangesTablePass1(), RebuildRecentchanges\rebuildRecentChangesTablePass2(), RebuildRecentchanges\rebuildRecentChangesTablePass3(), RebuildRecentchanges\rebuildRecentChangesTablePass4(), RebuildRecentchanges\rebuildRecentChangesTablePass5(), RefreshLinks\refreshCategory(), ManageJobs\repushAbandoned(), TableCleanup\runTable(), FindBadBlobs\scanRevisionsById(), FindBadBlobs\scanRevisionsByTimestamp(), and SyncFileBackend\syncBackends().

◆ 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().

@stable for overriding

Parameters
int$dbDB index (DB_REPLICA/DB_MASTER)
string | string[]$groupsdefault: empty array
string | bool$dbDomaindefault: current wiki
Returns
IMaintainableDatabase

Reimplemented in OrphanStats.

Definition at line 1369 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(), AddRFCandPMIDInterwiki\doDBUpdates(), CleanupRevActorPage\doDBUpdates(), DeduplicateArchiveRevId\doDBUpdates(), FixDefaultJsonContentPages\doDBUpdates(), FixExtLinksProtocolRelative\doDBUpdates(), MigrateActors\doDBUpdates(), MigrateArchiveText\doDBUpdates(), MigrateImageCommentTemp\doDBUpdates(), PopulateArchiveRevId\doDBUpdates(), PopulateBacklinkNamespace\doDBUpdates(), PopulateExternallinksIndex60\doDBUpdates(), PopulateFilearchiveSha1\doDBUpdates(), PopulateImageSha1\doDBUpdates(), PopulateIpChanges\doDBUpdates(), PopulateLogSearch\doDBUpdates(), PopulateLogUsertext\doDBUpdates(), PopulateParentId\doDBUpdates(), PopulatePPSortKey\doDBUpdates(), PopulateRecentChangesSource\doDBUpdates(), PopulateRevisionLength\doDBUpdates(), PopulateRevisionSha1\doDBUpdates(), RefreshExternallinksIndex\doDBUpdates(), DeleteOldRevisions\doDelete(), PopulateRevisionLength\doLenUpdates(), ReassignEdits\doReassignEdits(), RefreshLinks\doRefreshLinks(), PopulateRevisionSha1\doSha1LegacyUpdates(), PopulateRevisionSha1\doSha1Updates(), UpdateSearchIndex\doUpdateSearchIndex(), RecountCategories\doWork(), RebuildTextIndex\dropMysqlTextIndex(), AttachLatest\execute(), BenchmarkDeleteTruncate\execute(), CategoryChangesAsRdf\execute(), CheckBadRedirects\execute(), CheckImages\execute(), CheckUsernames\execute(), CleanupAncientTables\execute(), CleanupBlocks\execute(), CleanupPreferences\execute(), CleanupRemovedModules\execute(), CleanupSpam\execute(), ClearInterwikiCache\execute(), CompareParserCache\execute(), ConvertLinks\execute(), ConvertUserOptions\execute(), DeleteArchivedFiles\execute(), DeleteArchivedRevisions\execute(), DeleteDefaultMessages\execute(), DeleteEqualMessages\execute(), DeleteOrphanedRevisions\execute(), DeleteSelfExternals\execute(), DeleteTag\execute(), DumpCategoriesAsRdf\execute(), DumpLinks\execute(), EraseArchivedFile\execute(), FixDoubleRedirects\execute(), FixTimestamps\execute(), FixUserRegistration\execute(), GenerateSitemap\execute(), GetReplicaServer\execute(), LoggedUpdateMaintenance\execute(), InitEditCount\execute(), InitSiteStats\execute(), InitUserPreference\execute(), MigrateUserGroup\execute(), MoveBatch\execute(), NukeNS\execute(), NukePage\execute(), PatchSql\execute(), PopulateCategory\execute(), PurgeChangedFiles\execute(), PurgeChangedPages\execute(), PurgeModuleDeps\execute(), RebuildAll\execute(), RebuildFileCache\execute(), ImageBuilder\execute(), RebuildTextIndex\execute(), RefreshFileHeaders\execute(), RefreshImageMetadata\execute(), RemoveInvalidEmails\execute(), RemoveUnusedAccounts\execute(), RenameDbPrefix\execute(), ResetPageRandom\execute(), ResetUserTokens\execute(), RunBatchedQuery\execute(), ShowSiteStats\execute(), StorageTypeStats\execute(), TidyUpT39714\execute(), UpdateMediaWiki\execute(), UpdateArticleCount\execute(), UpdateCollation\execute(), UpdateDoubleWidthSearch\execute(), UpdateRestrictions\execute(), UpdateSpecialPages\execute(), UppercaseTitlesForUnicodeTransition\execute(), WrapOldPasswords\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(), MigrateActors\migrateToTemp(), MigrateComments\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(), PopulateRevisionSha1\upgradeRow(), and PopulateRevisionLength\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 Stable for overriding

Returns
int

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

Definition at line 546 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 1351 of file Maintenance.php.

◆ getHookContainer()

Maintenance::getHookContainer ( )
protected

Get a HookContainer, for running extension hooks or for hook metadata.

Since
1.35
Returns
HookContainer

Definition at line 1695 of file Maintenance.php.

References $hookContainer.

Referenced by getHookRunner().

◆ getHookRunner()

Maintenance::getHookRunner ( )
protected

Get a HookRunner for running core hooks.

Definition at line 1710 of file Maintenance.php.

References $hookRunner, and getHookContainer().

Referenced by CleanupUsersWithNoId\cleanup(), RefreshLinks\doRefreshLinks(), CleanupPreferences\execute(), and UpdateMediaWiki\validateParamsAndArgs().

◆ getName()

Maintenance::getName ( )

Get the script's name.

Returns
string

Definition at line 395 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$nameThe name of the param
mixed | null$defaultAnything you want, default null
Returns
mixed
-taint none

Definition at line 281 of file Maintenance.php.

References hasOption().

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

◆ getStdin()

Maintenance::getStdin (   $len = null)
protected

Return input from stdin.

Parameters
int | null$lenThe number of bytes to read. If null, just return the handle. Maintenance::STDIN_ALL returns the full length
Returns
mixed

Definition at line 405 of file Maintenance.php.

Referenced by PurgeList\doPurge(), BlockUsers\execute(), DeleteBatch\execute(), DumpIterator\execute(), EditCLI\execute(), FetchText\execute(), MoveBatch\execute(), PurgePage\execute(), DumpRenderer\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 1654 of file Maintenance.php.

References wfIsWindows().

◆ globals()

Maintenance::globals ( )

Potentially debug globals.

Originally a feature only for refreshLinks

Definition at line 1257 of file Maintenance.php.

References $GLOBALS, and hasOption().

◆ hasArg()

Maintenance::hasArg (   $argId = 0)
protected

Does a given argument exist?

Parameters
int$argIdThe integer value (from zero) for the arg
Returns
bool

Definition at line 336 of file Maintenance.php.

References wfDeprecated().

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

◆ hasOption()

Maintenance::hasOption (   $name)
protected

Checks to see if a particular option exists.

Parameters
string$nameThe name of the option
Returns
bool

Definition at line 266 of file Maintenance.php.

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

◆ isQuiet()

Maintenance::isQuiet ( )
Returns
bool

Definition at line 422 of file Maintenance.php.

References $mQuiet.

Referenced by countDown(), and SyncFileBackend\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$selfThe name of the script, if any
array | null$optsAn array of options, in form of key=>value
array | null$argsAn array of command line arguments

Definition at line 963 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 1267 of file Maintenance.php.

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

◆ loadSpecialVars()

Maintenance::loadSpecialVars ( )
protected

Handle the special variables that are global to all scripts @stable for overriding.

Definition at line 1029 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 857 of file Maintenance.php.

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

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

◆ lockSearchindex()

Maintenance::lockSearchindex (   $db)
private

Lock the search index.

Parameters
IMaintainableDatabase$db

Definition at line 1443 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$forceWhether to force the help to show, default false

Reimplemented in CommandLineInc.

Definition at line 1049 of file Maintenance.php.

References hasOption(), and showHelp().

Referenced by CreateAndPromote\execute(), GenerateJsonI18n\execute(), JSParseHelper\execute(), PurgeChangedFiles\execute(), PurgeChangedPages\execute(), UserOptionsMaintenance\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) Stable for overriding

Returns
string

Reimplemented in RunJobs.

Definition at line 794 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 Stable for overriding

Parameters
string$outThe text to show to the user
mixed | null$channelUnique identifier for the channel. See function outputChanneled.

Definition at line 433 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(), FindBadBlobs\checkRevision(), Orphans\checkSeparation(), FindBadBlobs\checkSlot(), 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(), DeduplicateArchiveRevId\doDBUpdates(), FixExtLinksProtocolRelative\doDBUpdates(), MigrateActors\doDBUpdates(), MigrateArchiveText\doDBUpdates(), MigrateImageCommentTemp\doDBUpdates(), PopulateArchiveRevId\doDBUpdates(), PopulateBacklinkNamespace\doDBUpdates(), PopulateExternallinksIndex60\doDBUpdates(), PopulateFilearchiveSha1\doDBUpdates(), PopulateImageSha1\doDBUpdates(), PopulateIpChanges\doDBUpdates(), PopulateLogSearch\doDBUpdates(), PopulateLogUsertext\doDBUpdates(), PopulateParentId\doDBUpdates(), PopulatePPSortKey\doDBUpdates(), PopulateRecentChangesSource\doDBUpdates(), PopulateRevisionLength\doDBUpdates(), PopulateRevisionSha1\doDBUpdates(), RefreshExternallinksIndex\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(), AddChangeTag\execute(), AttachLatest\execute(), BenchmarkPurge\execute(), BlockUsers\execute(), ChangePassword\execute(), CheckBadRedirects\execute(), CheckComposerLockUpToDate\execute(), CheckDependencies\execute(), CheckImages\execute(), CheckUsernames\execute(), CleanupAncientTables\execute(), CleanupBlocks\execute(), CleanupCaps\execute(), CleanupPreferences\execute(), CleanupRemovedModules\execute(), CleanupSpam\execute(), CleanupUploadStash\execute(), CleanupWatchlist\execute(), ClearInterwikiCache\execute(), CompareParserCache\execute(), ConvertExtensionToRegistration\execute(), ConvertLinks\execute(), ConvertUserOptions\execute(), CopyFileBackend\execute(), CopyJobQueue\execute(), CreateAndPromote\execute(), CreateBotPassword\execute(), DeleteArchivedFiles\execute(), DeleteArchivedRevisions\execute(), DeleteAutoPatrolLogs\execute(), DeleteBatch\execute(), DeleteDefaultMessages\execute(), DeleteEqualMessages\execute(), DeleteOldRevisions\execute(), DeleteOrphanedRevisions\execute(), DeleteSelfExternals\execute(), DeleteTag\execute(), DumpLinks\execute(), EditCLI\execute(), EmptyUserGroup\execute(), EraseArchivedFile\execute(), ExportSites\execute(), FetchText\execute(), FindBadBlobs\execute(), FindMissingActors\execute(), FindMissingFiles\execute(), FindOrphanedFiles\execute(), FixDoubleRedirects\execute(), FixTimestamps\execute(), FixUserRegistration\execute(), GenerateJsonI18n\execute(), GetConfiguration\execute(), GetLagTimes\execute(), GetReplicaServer\execute(), GetTextMaint\execute(), BackupReader\execute(), ImportImages\execute(), ImportSites\execute(), ImportSiteScripts\execute(), ImportTextFiles\execute(), DeleteLocalPasswords\execute(), LoggedUpdateMaintenance\execute(), InitEditCount\execute(), InitSiteStats\execute(), InitUserPreference\execute(), CommandLineInstaller\execute(), InvalidateUserSesssions\execute(), JSParseHelper\execute(), DatabaseLag\execute(), AllTrans\execute(), DateFormats\execute(), Digit2Html\execute(), DumpMessages\execute(), LangMemUsage\execute(), MakeTestEdits\execute(), ManageForeignResources\execute(), McTest\execute(), GeneratePhpCharToUpperMappings\execute(), MigrateFileRepoLayout\execute(), MigrateUserGroup\execute(), MinifyScript\execute(), MoveBatch\execute(), MWDocGen\execute(), NamespaceDupes\execute(), NukeNS\execute(), NukePage\execute(), PageExists\execute(), PatchSql\execute(), PopulateCategory\execute(), Protect\execute(), PruneFileCache\execute(), PurgeChangedPages\execute(), PurgeExpiredBlocks\execute(), PurgeExpiredUserrights\execute(), PurgeExpiredWatchlistItems\execute(), PurgeList\execute(), PurgeModuleDeps\execute(), PurgeParserCache\execute(), ReassignEdits\execute(), RebuildAll\execute(), RebuildFileCache\execute(), RebuildLocalisationCache\execute(), RebuildMessages\execute(), RebuildRecentchanges\execute(), RebuildTextIndex\execute(), RecountCategories\execute(), RefreshFileHeaders\execute(), RefreshImageMetadata\execute(), RemoveInvalidEmails\execute(), RemoveUnusedAccounts\execute(), RenameDbPrefix\execute(), ResetPageRandom\execute(), ResetUserEmail\execute(), ResetUserTokens\execute(), RollbackEdits\execute(), RunBatchedQuery\execute(), RunJobs\execute(), ShowJobs\execute(), ShowSiteStats\execute(), CompressOld\execute(), DumpRev\execute(), OrphanStats\execute(), SyncFileBackend\execute(), TableCleanup\execute(), TidyUpT39714\execute(), Undelete\execute(), UpdateMediaWiki\execute(), UpdateArticleCount\execute(), UpdateCollation\execute(), UpdateDoubleWidthSearch\execute(), UpdateExtensionJsonSchema\execute(), UpdateRestrictions\execute(), UpdateSpecialPages\execute(), ValidateRegistrationFile\execute(), Version\execute(), ViewCLI\execute(), WrapOldPasswords\execute(), DeleteEqualMessages\fetchMessageInfo(), ImportSiteScripts\fetchScriptList(), FindMissingActors\findBadActors(), FindMissingActors\getNewActorId(), DeleteLocalPasswords\getUserBatches(), ConvertExtensionToRegistration\handleExtensionMessagesFiles(), ConvertExtensionToRegistration\handleHooks(), DumpIterator\handleRevision(), DumpRenderer\handleRevision(), FixDefaultJsonContentPages\handleRow(), MWDocGen\init(), SqliteMaintenance\integrityCheck(), CleanupImages\killRow(), UserOptionsMaintenance\listAvailableOptions(), GenerateSitemap\main(), MigrateComments\migrate(), MigrateActors\migrate(), MigrateActors\migrateLogSearch(), MigrateActors\migrateToTemp(), MigrateComments\migrateToTemp(), TitleCleanup\moveIllegalPage(), TitleCleanup\moveInconsistentPage(), CleanupCaps\movePage(), ImageBuilder\oldimageCallback(), DumpUploads\outputItem(), FindMissingActors\overwriteActorIDs(), CleanupImages\pokeFile(), RebuildTextIndex\populateSearchIndex(), DeduplicateArchiveRevId\processArRevIds(), CompareParsers\processRevision(), SearchDump\processRevision(), CleanupImages\processRow(), TitleCleanup\processRow(), CleanupWatchlist\processRow(), CleanupCaps\processRowToLowercase(), CleanupCaps\processRowToUppercase(), UppercaseTitlesForUnicodeTransition\processTable(), UppercaseTitlesForUnicodeTransition\processUsers(), ImageBuilder\progress(), TableCleanup\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(), FindBadBlobs\scanRevisionsById(), FindBadBlobs\scanRevisionsByTimestamp(), EraseArchivedFile\scrubVersion(), PurgeList\sendPurgeRequest(), PopulateChangeTagDef\setUserDefinedTags(), CreateBotPassword\showGrants(), showHelp(), PurgeParserCache\showProgressAndWait(), UpdateCollation\showSortKeySizeHistogram(), UserOptionsMaintenance\showUsageStats(), MwSql\sqlPrintResult(), Benchmarker\startBench(), SyncFileBackend\syncBackends(), SyncFileBackend\syncFileBatch(), GenerateJsonI18n\transformI18nFile(), PopulateChangeTagDef\updateCountTag(), PopulateChangeTagDef\updateCountTagId(), UserOptionsMaintenance\updateOptions(), updateSearchIndex(), updateSearchIndexForPage(), ResetUserTokens\updateUser(), PopulateRevisionSha1\upgradeLegacyArchiveRow(), PopulateRevisionSha1\upgradeRow(), PopulateRevisionLength\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$msgThe message without trailing newline
string | null$channelChannel identifier or null for no channel. Channel comparison uses ===.

Definition at line 512 of file Maintenance.php.

References cleanupChanneled().

Referenced by error(), and output().

◆ parseIntList()

Maintenance::parseIntList (   $text)
protected

Utility function to parse a string (perhaps from a command line option) into a list of integers (perhaps some kind of numeric IDs).

Since
1.35
Parameters
string$text
Returns
int[]

Definition at line 1727 of file Maintenance.php.

Referenced by FindMissingActors\execute(), and FindBadBlobs\getRevisionIds().

◆ 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$fdFile descriptor
Returns
bool

Definition at line 1571 of file Maintenance.php.

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

◆ purgeRedundantText()

Maintenance::purgeRedundantText (   $delete = true)

Support function for cleaning up redundant text records.

Parameters
bool$deleteWhether or not to actually delete the records
Author
Rob Church robch.nosp@m.ur@g.nosp@m.mail..nosp@m.com

Definition at line 1304 of file Maintenance.php.

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

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

◆ readconsole()

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

Prompt the console for input.

Parameters
string$promptWhat to begin the line with, like '> '
Returns
string Response

Definition at line 1584 of file Maintenance.php.

References posix_isatty(), and readlineEmulation().

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

◆ readlineEmulation()

static Maintenance::readlineEmulation (   $prompt)
staticprivate

Emulate readline()

Parameters
string$promptWhat to begin the line with, like '> '
Returns
string

Definition at line 1616 of file Maintenance.php.

References $command, 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 1470 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 620 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 1685 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$fnameCaller name
Since
1.27

Definition at line 1435 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$maintClassA name of a child maintenance class
string | null$classFileFull path of where the child is
Returns
Maintenance

Definition at line 713 of file Maintenance.php.

References $maintClass, and error().

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

◆ setAgentAndTriggers()

Maintenance::setAgentAndTriggers ( )

Set triggers like when to try to run deferred updates.

Since
1.28

Definition at line 654 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$allowShould we allow?

Definition at line 319 of file Maintenance.php.

Referenced by CommandLineInc\__construct().

◆ setBatchSize()

Maintenance::setBatchSize (   $s = 0)
protected
Parameters
int$sThe number of operations to do in a batch

Definition at line 373 of file Maintenance.php.

References $s, and addOption().

Referenced by CategoryChangesAsRdf\__construct(), CheckImages\__construct(), CheckUsernames\__construct(), CleanupBlocks\__construct(), CleanupInvalidDbKeys\__construct(), CleanupPreferences\__construct(), CleanupRemovedModules\__construct(), CleanupRevActorPage\__construct(), TitleCleanup\__construct(), CleanupUploadStash\__construct(), CleanupUsersWithNoId\__construct(), ConvertUserOptions\__construct(), CopyFileBackend\__construct(), CopyJobQueue\__construct(), DeduplicateArchiveRevId\__construct(), DeleteAutoPatrolLogs\__construct(), DeleteSelfExternals\__construct(), DeleteTag\__construct(), DumpCategoriesAsRdf\__construct(), EmptyUserGroup\__construct(), FindBadBlobs\__construct(), FindMissingActors\__construct(), FindMissingFiles\__construct(), FindOrphanedFiles\__construct(), FixDefaultJsonContentPages\__construct(), FixUserRegistration\__construct(), DeleteLocalPasswords\__construct(), LoggedUpdateMaintenance\__construct(), MigrateActors\__construct(), InitUserPreference\__construct(), InvalidateUserSesssions\__construct(), MakeTestEdits\__construct(), MigrateComments\__construct(), MigrateFileRepoLayout\__construct(), MigrateUserGroup\__construct(), PopulateArchiveRevId\__construct(), PopulateChangeTagDef\__construct(), PopulateContentTables\__construct(), PopulateExternallinksIndex60\__construct(), PopulateLogSearch\__construct(), PopulateLogUsertext\__construct(), PopulatePPSortKey\__construct(), PopulateRecentChangesSource\__construct(), PopulateRevisionLength\__construct(), PopulateRevisionSha1\__construct(), PurgeChangedFiles\__construct(), PurgeChangedPages\__construct(), PurgeExpiredWatchlistItems\__construct(), PurgeList\__construct(), PurgeModuleDeps\__construct(), RebuildFileCache\__construct(), RebuildRecentchanges\__construct(), RecountCategories\__construct(), RefreshExternallinksIndex\__construct(), RefreshFileHeaders\__construct(), RefreshImageMetadata\__construct(), RefreshLinks\__construct(), RemoveInvalidEmails\__construct(), ResetPageRandom\__construct(), ResetUserTokens\__construct(), SyncFileBackend\__construct(), TableCleanup\__construct(), UpdateRestrictions\__construct(), UppercaseTitlesForUnicodeTransition\__construct(), WrapOldPasswords\__construct(), PopulateChangeTagDef\doDBUpdates(), CopyFileBackend\execute(), and DeleteAutoPatrolLogs\execute().

◆ setConfig()

Maintenance::setConfig ( Config  $config)
Since
1.24
Parameters
Config$config

Definition at line 607 of file Maintenance.php.

References $config.

◆ setDB()

Maintenance::setDB ( IMaintainableDatabase  $db)

Sets database object to be returned by getDB().

@stable for overriding

Parameters
IMaintainableDatabase$db

Reimplemented in BackupDumper.

Definition at line 1386 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 675 of file Maintenance.php.

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

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 933 of file Maintenance.php.

References error(), and maybeHelp().

Referenced by loadWithArgv().

◆ setup()

Maintenance::setup ( )

Do some sanity checking and basic setup.

Definition at line 739 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 188 of file Maintenance.php.

References $wgCommandLineMode.

◆ showHelp()

Maintenance::showHelp ( )
protected

Definitely show the help.

Does not exit.

Definition at line 1060 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$nameThe name of the option
Returns
bool true if the option exists, false otherwise

Definition at line 230 of file Maintenance.php.

Referenced by validateParamsAndArgs().

◆ unlockSearchindex()

Maintenance::unlockSearchindex (   $db)
private

Unlock the tables.

Parameters
IMaintainableDatabase$db

Definition at line 1461 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$maxLockTimeThe maximum time to keep the search index locked.
callable$callbackThe function that will update the function.
IMaintainableDatabase$dbw
array | IResultWrapper$results

Definition at line 1482 of file Maintenance.php.

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

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

◆ updateSearchIndexForPage()

Maintenance::updateSearchIndexForPage ( int  $pageId)

Update the searchindex table for a given pageid.

Parameters
int$pageIdThe page ID to update.
Returns
null|string

Definition at line 1518 of file Maintenance.php.

References $title, Title\newFromLinkTarget(), and output().

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

◆ validateParamsAndArgs()

Maintenance::validateParamsAndArgs ( )

Run some validation checks on the params, etc Stable for overriding.

Reimplemented in UpdateMediaWiki, CommandLineInstaller, and GetConfiguration.

Definition at line 996 of file Maintenance.php.

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

Member Data Documentation

◆ $atLineStart

Maintenance::$atLineStart = true
private

Definition at line 491 of file Maintenance.php.

◆ $config

◆ $fileHandle

resource Maintenance::$fileHandle

Used when creating separate schema files.

Definition at line 136 of file Maintenance.php.

◆ $hookContainer

HookContainer null Maintenance::$hookContainer
private

Definition at line 139 of file Maintenance.php.

Referenced by getHookContainer().

◆ $hookRunner

HookRunner null Maintenance::$hookRunner
private

Definition at line 142 of file Maintenance.php.

Referenced by getHookRunner().

◆ $lastChannel

Maintenance::$lastChannel = null
private

Definition at line 492 of file Maintenance.php.

◆ $lastReplicationWait

float Maintenance::$lastReplicationWait = 0.0
private

UNIX timestamp.

Definition at line 130 of file Maintenance.php.

Referenced by UppercaseTitlesForUnicodeTransition\processTable().

◆ $mAllowUnregisteredOptions

bool Maintenance::$mAllowUnregisteredOptions = false
protected

Allow arbitrary options to be passed, or only specified ones?

Definition at line 87 of file Maintenance.php.

◆ $mArgList

array Maintenance::$mArgList = []
protected

Desired/allowed args.

Definition at line 78 of file Maintenance.php.

◆ $mArgs

array Maintenance::$mArgs = []
protected

This is the list of arguments that were actually passed.

Definition at line 84 of file Maintenance.php.

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

◆ $mBatchSize

int Maintenance::$mBatchSize = null
protected

Batch size.

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

Definition at line 108 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 127 of file Maintenance.php.

Referenced by getDB().

◆ $mDbPass

Maintenance::$mDbPass

Definition at line 94 of file Maintenance.php.

Referenced by finalSetup().

◆ $mDbUser

Maintenance::$mDbUser
protected

Definition at line 94 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 121 of file Maintenance.php.

Referenced by showHelp().

◆ $mDescription

string Maintenance::$mDescription = ''
protected

A description of the script, children should change this via addDescription()

Definition at line 97 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 115 of file Maintenance.php.

◆ $mInputLoaded

bool Maintenance::$mInputLoaded = false
protected

Have we already loaded our user input?

Definition at line 100 of file Maintenance.php.

◆ $mOptions

array Maintenance::$mOptions = []
protected

This is the list of options that were actually passed.

Definition at line 81 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 72 of file Maintenance.php.

Referenced by addDefaultParams().

◆ $mQuiet

bool Maintenance::$mQuiet = false
protected

Special vars for params that are always used.

Definition at line 93 of file Maintenance.php.

Referenced by isQuiet().

◆ $mSelf

string null Maintenance::$mSelf
protected

Name of the script currently running.

Definition at line 90 of file Maintenance.php.

Referenced by getName().

◆ $mShortParamsMap

array Maintenance::$mShortParamsMap = []
protected

Mapping short parameters to long ones.

Definition at line 75 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 168 of file Maintenance.php.

Referenced by BackupDumper\processOptions().

◆ $requiredExtensions

array Maintenance::$requiredExtensions = []
private
See also
Maintenance::requireExtension

Definition at line 155 of file Maintenance.php.

◆ DB_ADMIN

◆ DB_NONE

◆ DB_STD

const Maintenance::DB_STD = 1

Definition at line 61 of file Maintenance.php.

Referenced by getDbType().

◆ STDIN_ALL

const Maintenance::STDIN_ALL = 'all'

Definition at line 65 of file Maintenance.php.

Referenced by EditCLI\execute().


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