MediaWiki
1.34.4
|
Copy all files in one container of one backend to another. More...
Public Member Functions | |
__construct () | |
Default constructor. More... | |
execute () | |
Do the actual work. 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 (IMaintainableDatabase $db) | |
Sets database object to be returned by getDB(). More... | |
setup () | |
Do some sanity checking and basic setup. More... | |
updateSearchIndex ( $maxLockTime, $callback, $dbw, $results) | |
Perform a search index update with locking. More... | |
updateSearchIndexForPage ( $dbw, $pageId) | |
Update the searchindex table for a given pageid. More... | |
validateParamsAndArgs () | |
Run some validation checks on the params, etc. More... | |
Protected Member Functions | |
copyFileBatch (array $srcPathsRel, $backendRel, FileBackend $src, FileBackend $dst) | |
delFileBatch (array $dstPathsRel, $backendRel, FileBackend $dst) | |
filesAreSame (FileBackend $src, FileBackend $dst, $sPath, $dPath) | |
getListingDiffRel (FileBackend $src, FileBackend $dst, $backendRel) | |
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=[], $dbDomain=false) | |
Returns a database to be used by current maintenance script. More... | |
getDir () | |
Get the maintenance directory. More... | |
getOption ( $name, $default=null) | |
Get an option, or return the default. More... | |
getStdin ( $len=null) | |
Return input from stdin. More... | |
hasArg ( $argId=0) | |
Does a given argument exist? More... | |
hasOption ( $name) | |
Checks to see if a particular option exists. More... | |
loadSpecialVars () | |
Handle the special variables that are global to all scripts. More... | |
maybeHelp ( $force=false) | |
Maybe show the help. More... | |
output ( $out, $channel=null) | |
Throw some output to the user. More... | |
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) | |
Set the batch size. More... | |
supportsOption ( $name) | |
Checks to see if a particular option in supported. More... | |
Protected Attributes | |
array null | $statCache = null |
(path sha1 => stat) Pre-computed dst stat entries from listings More... | |
Protected Attributes inherited from Maintenance | |
$mAllowUnregisteredOptions = false | |
$mArgList = [] | |
$mArgs = [] | |
int | $mBatchSize = null |
Batch size. More... | |
$mDbUser | |
$mDescription = '' | |
$mInputLoaded = false | |
$mOptions = [] | |
array[] | $mParams = [] |
Array of desired/allowed params. More... | |
$mQuiet = false | |
$mSelf | |
$mShortParamsMap = [] | |
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' |
Copy all files in one container of one backend to another.
This can also be used to re-shard the files for one backend using the config of second backend. The second backend should have the same config as the first, except for it having a different name and different sharding configuration. The backend should be made read-only while this runs. After this script finishes, the old files in the containers can be deleted.
Definition at line 37 of file copyFileBackend.php.
CopyFileBackend::__construct | ( | ) |
Default constructor.
Children should call this first if implementing their own constructors
Reimplemented from Maintenance.
Definition at line 41 of file copyFileBackend.php.
References Maintenance\addDescription(), Maintenance\addOption(), and Maintenance\setBatchSize().
|
protected |
string[] | $srcPathsRel | |
string | $backendRel | |
FileBackend | $src | |
FileBackend | $dst |
Definition at line 207 of file copyFileBackend.php.
References FileBackend\clearCache(), FileBackend\doQuickOperations(), Maintenance\error(), Maintenance\fatalError(), FileBackend\fileExists(), filesAreSame(), FileBackend\getDomainId(), FileBackend\getLocalReference(), FileBackend\getLocalReferenceMulti(), FileBackend\getRootStoragePath(), Maintenance\hasOption(), Maintenance\output(), FileBackend\prepare(), and Status\wrap().
Referenced by execute().
|
protected |
string[] | $dstPathsRel | |
string | $backendRel | |
FileBackend | $dst |
Definition at line 294 of file copyFileBackend.php.
References FileBackend\doQuickOperations(), Maintenance\error(), Maintenance\fatalError(), FileBackend\getDomainId(), FileBackend\getRootStoragePath(), Maintenance\output(), and Status\wrap().
Referenced by execute().
CopyFileBackend::execute | ( | ) |
Do the actual work.
All child classes will need to implement this
Reimplemented from Maintenance.
Definition at line 57 of file copyFileBackend.php.
References $path, copyFileBatch(), delFileBatch(), Maintenance\fatalError(), Maintenance\getBatchSize(), getListingDiffRel(), Maintenance\getOption(), Maintenance\hasOption(), Maintenance\output(), Maintenance\setBatchSize(), and FileBackendGroup\singleton().
|
protected |
FileBackend | $src | |
FileBackend | $dst | |
string | $sPath | |
string | $dPath |
Definition at line 332 of file copyFileBackend.php.
References FileBackend\getFileSha1Base36(), FileBackend\getFileStat(), and Maintenance\hasOption().
Referenced by copyFileBatch().
|
protected |
FileBackend | $src | |
FileBackend | $dst | |
string | $backendRel |
Definition at line 171 of file copyFileBackend.php.
References Maintenance\fatalError(), FileBackend\getFileList(), and FileBackend\getRootStoragePath().
Referenced by execute().
|
protected |
(path sha1 => stat) Pre-computed dst stat entries from listings
Definition at line 39 of file copyFileBackend.php.