Maintenance script that replaces text in pages. More...
Public Member Functions | |
| __construct () | |
| Default constructor. More... | |
| execute () | |
| @inheritDoc More... | |
 Public Member Functions inherited from Maintenance | |
| checkRequiredExtensions () | |
| Verify that the required extensions are installed. More... | |
| cleanupChanneled () | |
| Clean up channeled output. More... | |
| clearParamsAndArgs () | |
| Clear all params and arguments. 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 (IDatabase $db) | |
| Sets database object to be returned by getDB(). More... | |
| setup () | |
| Do some sanity checking and basic setup. More... | |
| updateSearchIndex ( $maxLockTime, $callback, $dbw, $results) | |
| Perform a search index update with locking. More... | |
| updateSearchIndexForPage ( $dbw, $pageId) | |
| Update the searchindex table for a given pageid. More... | |
| validateParamsAndArgs () | |
| Run some validation checks on the params, etc. More... | |
Private Member Functions | |
| getCategory () | |
| getNamespaces () | |
| getPrefix () | |
| getRename () | |
| getReplacement () | |
| getReplacements () | |
| getReply ( $question) | |
| getSummary ( $target, $replacement) | |
| getTarget () | |
| getUser () | |
| listNamespaces () | |
| listTitles ( $titles, $target, $replacement, $regex, $rename) | |
| localSetup () | |
| replaceTitles ( $titles, $target, $replacement, $useRegex, $rename) | |
| shouldContinueByDefault () | |
| showFileFormat () | |
| useRegex () | |
Private Attributes | |
| $category | |
| $defaultContinue | |
| $doAnnounce | |
| $namespaces | |
| $prefix | |
| $rename | |
| $replacement | |
| $target | |
| $titles | |
| $user | |
| $useRegex | |
Additional Inherited Members | |
| Static Public Member Functions inherited from Maintenance | |
| 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 inherited from Maintenance | |
| 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 inherited from Maintenance | |
| activateProfiler () | |
| Activate the profiler (assuming $wgProfiler is set) More... | |
| addArg ( $arg, $description, $required=true) | |
| Add some args that are needed. More... | |
| addDefaultParams () | |
| Add the default parameters to the scripts. More... | |
| addDescription ( $text) | |
| Set the description text. More... | |
| addOption ( $name, $description, $required=false, $withArg=false, $shortName=false, $multiOccurrence=false) | |
| Add a parameter to the script. More... | |
| adjustMemoryLimit () | |
| Adjusts PHP's memory limit to better suit our needs, if needed. More... | |
| afterFinalSetup () | |
| Execute a callback function at the end of initialisation. More... | |
| beginTransaction (IDatabase $dbw, $fname) | |
| Begin a transcation on a DB. More... | |
| commitTransaction (IDatabase $dbw, $fname) | |
| Commit the transcation on a DB handle and wait for replica DBs to catch up. More... | |
| countDown ( $seconds) | |
| Count down from $seconds to zero on the terminal, with a one-second pause between showing each number. More... | |
| deleteOption ( $name) | |
| Remove an option. More... | |
| error ( $err, $die=0) | |
| Throw an error to the user. More... | |
| fatalError ( $msg, $exitCode=1) | |
| Output a message and terminate the current script. More... | |
| getArg ( $argId=0, $default=null) | |
| Get an argument. More... | |
| getBatchSize () | |
| Returns batch size. More... | |
| getDB ( $db, $groups=[], $wiki=false) | |
| Returns a database to be used by current maintenance script. More... | |
| getDir () | |
| Get the maintenance directory. More... | |
| getOption ( $name, $default=null) | |
| Get an option, or return the default. More... | |
| getStdin ( $len=null) | |
| Return input from stdin. More... | |
| hasArg ( $argId=0) | |
| Does a given argument exist? More... | |
| hasOption ( $name) | |
| Checks to see if a particular option exists. More... | |
| loadSpecialVars () | |
| Handle the special variables that are global to all scripts. More... | |
| maybeHelp ( $force=false) | |
| Maybe show the help. More... | |
| output ( $out, $channel=null) | |
| Throw some output to the user. More... | |
| requireExtension ( $name) | |
| Indicate that the specified extension must be loaded before the script can run. More... | |
| rollbackTransaction (IDatabase $dbw, $fname) | |
| Rollback the transcation on a DB handle. More... | |
| setAllowUnregisteredOptions ( $allow) | |
| Sets whether to allow unregistered options, which are options passed to a script that do not match an expected parameter. More... | |
| setBatchSize ( $s=0) | |
| Set the batch size. More... | |
| supportsOption ( $name) | |
| Checks to see if a particular option in supported. More... | |
| Protected Attributes inherited from Maintenance | |
| $mAllowUnregisteredOptions = false | |
| $mArgList = [] | |
| $mArgs = [] | |
| int | $mBatchSize = null |
| Batch size. More... | |
| $mDbUser | |
| $mDescription = '' | |
| $mInputLoaded = false | |
| $mOptions = [] | |
| $mParams = [] | |
| $mQuiet = false | |
| $mSelf | |
| $mShortParamsMap = [] | |
Detailed Description
Maintenance script that replaces text in pages.
@SuppressWarnings(StaticAccess) @SuppressWarnings(LongVariable)
Definition at line 46 of file replaceAll.php.
Constructor & Destructor Documentation
◆ __construct()
| ReplaceAll::__construct | ( | ) |
Default constructor.
Children should call this first if implementing their own constructors
Reimplemented from Maintenance.
Definition at line 59 of file replaceAll.php.
References Maintenance\addArg(), Maintenance\addOption(), and Maintenance\requireExtension().
Member Function Documentation
◆ execute()
| ReplaceAll::execute | ( | ) |
@inheritDoc
Reimplemented from Maintenance.
Definition at line 347 of file replaceAll.php.
References $replacement, $res, $target, $titles, $useRegex, $wgShowExceptionDetails, as, captcha-old\count, ReplaceTextSearch\doSearchQuery(), Maintenance\error(), ReplaceTextSearch\getMatchingTitles(), Maintenance\getOption(), getReply(), listTitles(), localSetup(), namespaces, shouldContinueByDefault(), and useRegex().
◆ getCategory()
|
private |
Definition at line 255 of file replaceAll.php.
Referenced by localSetup().
◆ getNamespaces()
|
private |
Definition at line 222 of file replaceAll.php.
References $namespaces, MWNamespace\getCanonicalNamespaces(), Maintenance\getOption(), NS_MAIN, and use.
Referenced by localSetup().
◆ getPrefix()
|
private |
Definition at line 259 of file replaceAll.php.
Referenced by localSetup().
◆ getRename()
|
private |
Definition at line 267 of file replaceAll.php.
References Maintenance\hasOption().
Referenced by localSetup().
◆ getReplacement()
|
private |
Definition at line 125 of file replaceAll.php.
References $ret, Maintenance\error(), and Maintenance\getArg().
Referenced by localSetup().
◆ getReplacements()
|
private |
Definition at line 133 of file replaceAll.php.
References $file, $line, Maintenance\getOption(), true, and useRegex().
Referenced by localSetup().
◆ getReply()
|
private |
Definition at line 309 of file replaceAll.php.
References Maintenance\readconsole(), and shouldContinueByDefault().
Referenced by execute().
◆ getSummary()
|
private |
Definition at line 176 of file replaceAll.php.
References $replacement, $target, Maintenance\getOption(), plain, and wfMessage().
Referenced by replaceTitles().
◆ getTarget()
|
private |
Definition at line 117 of file replaceAll.php.
References $ret, Maintenance\error(), and Maintenance\getArg().
Referenced by localSetup().
◆ getUser()
|
private |
Definition at line 101 of file replaceAll.php.
References $user, Maintenance\error(), Maintenance\getOption(), User\newFromId(), and User\newFromName().
Referenced by localSetup().
◆ listNamespaces()
|
private |
Definition at line 187 of file replaceAll.php.
References as, and MWNamespace\getCanonicalNamespaces().
Referenced by localSetup().
◆ listTitles()
|
private |
Definition at line 271 of file replaceAll.php.
References $rename, $replacement, $target, $title, $titles, as, ReplaceTextSearch\getReplacedTitle(), and Maintenance\output().
Referenced by execute().
◆ localSetup()
|
private |
Definition at line 321 of file replaceAll.php.
References getCategory(), getNamespaces(), Maintenance\getOption(), getPrefix(), getRename(), getReplacement(), getReplacements(), getTarget(), getUser(), listNamespaces(), namespaces, showFileFormat(), user, and useRegex().
Referenced by execute().
◆ replaceTitles()
|
private |
Definition at line 283 of file replaceAll.php.
References $doAnnounce, $job, $params, $rename, $replacement, $target, $title, $titles, $useRegex, as, Maintenance\error(), getSummary(), true, and user.
◆ shouldContinueByDefault()
|
private |
Definition at line 166 of file replaceAll.php.
References $defaultContinue, Maintenance\getOption(), and true.
Referenced by execute(), and getReply().
◆ showFileFormat()
|
private |
Definition at line 199 of file replaceAll.php.
References a, and(), are, file, format, is, not, of, captcha-old\p, replace, text, and that.
Referenced by localSetup().
◆ useRegex()
|
private |
Definition at line 263 of file replaceAll.php.
References Maintenance\getOption().
Referenced by execute(), getReplacements(), and localSetup().
Member Data Documentation
◆ $category
|
private |
Definition at line 51 of file replaceAll.php.
◆ $defaultContinue
|
private |
Definition at line 55 of file replaceAll.php.
Referenced by shouldContinueByDefault().
◆ $doAnnounce
|
private |
Definition at line 56 of file replaceAll.php.
Referenced by replaceTitles().
◆ $namespaces
|
private |
Definition at line 50 of file replaceAll.php.
Referenced by getNamespaces().
◆ $prefix
|
private |
Definition at line 52 of file replaceAll.php.
◆ $rename
|
private |
Definition at line 57 of file replaceAll.php.
Referenced by listTitles(), and replaceTitles().
◆ $replacement
|
private |
Definition at line 49 of file replaceAll.php.
Referenced by execute(), getSummary(), listTitles(), and replaceTitles().
◆ $target
|
private |
Definition at line 48 of file replaceAll.php.
Referenced by execute(), getSummary(), listTitles(), and replaceTitles().
◆ $titles
|
private |
Definition at line 54 of file replaceAll.php.
Referenced by execute(), listTitles(), and replaceTitles().
◆ $user
|
private |
Definition at line 47 of file replaceAll.php.
Referenced by getUser().
◆ $useRegex
|
private |
Definition at line 53 of file replaceAll.php.
Referenced by execute(), and replaceTitles().
The documentation for this class was generated from the following file:
- extensions/ReplaceText/maintenance/replaceAll.php
