27require_once __DIR__ .
'/Maintenance.php';
37 parent::__construct();
38 $this->
addDescription(
'Reads in text files and imports their content to pages of the wiki' );
39 $this->
addOption(
'user',
'Username to which edits should be attributed. ' .
40 'Default: "Maintenance script"',
false,
true,
'u' );
41 $this->
addOption(
'summary',
'Specify edit summary for the edits',
false,
true,
's' );
42 $this->
addOption(
'use-timestamp',
'Use the modification date of the text file ' .
43 'as the timestamp for the edit' );
44 $this->
addOption(
'overwrite',
'Overwrite existing pages. If --use-timestamp is passed, this ' .
45 'will only overwrite pages if the file has been modified since the page was last modified.' );
46 $this->
addOption(
'prefix',
'A string to place in front of the file name',
false,
true,
'p' );
47 $this->
addOption(
'bot',
'Mark edits as bot edits in the recent changes list.' );
48 $this->
addOption(
'rc',
'Place revisions in RecentChanges.' );
49 $this->
addArg(
'files',
'Files to import' );
53 $userName = $this->
getOption(
'user',
false );
54 $summary = $this->
getOption(
'summary',
'Imported from text file' );
55 $useTimestamp = $this->
hasOption(
'use-timestamp' );
58 $overwrite = $this->
hasOption(
'overwrite' );
59 $prefix = $this->
getOption(
'prefix',
'' );
65 while ( $arg = $this->
getArg( $i++ ) ) {
66 if ( file_exists( $arg ) ) {
67 $files[$arg] = file_get_contents( $arg );
72 foreach ( glob( $arg ) as $filename ) {
74 $files[$filename] = file_get_contents( $filename );
77 $this->
fatalError(
"Fatal error: The file '$arg' does not exist!" );
82 $count = count( $files );
83 $this->
output(
"Importing $count pages...\n" );
85 if ( $userName ===
false ) {
94 if ( $user->isAnon() ) {
95 $user->addToDatabase();
104 $revLookup = MediaWikiServices::getInstance()->getRevisionLookup();
105 foreach ( $files as
$file => $text ) {
106 $pageName = $prefix . pathinfo(
$file, PATHINFO_FILENAME );
109 $title = Title::newFromText( $pageName );
112 $this->
error(
"Invalid title $pageName. Skipping.\n" );
117 $exists =
$title->exists();
118 $oldRevID =
$title->getLatestRevID();
119 $oldRevRecord = $oldRevID ? $revLookup->getRevisionById( $oldRevID ) :
null;
120 $actualTitle =
$title->getPrefixedText();
125 $this->
output(
"Title $actualTitle already exists. Skipping.\n" );
128 } elseif ( $useTimestamp && intval( $touched ) >= intval( $timestamp ) ) {
129 $this->
output(
"File for title $actualTitle has not been modified since the " .
130 "destination page was touched. Skipping.\n" );
137 $rev =
new WikiRevision( MediaWikiServices::getInstance()->getMainConfig() );
138 $rev->setContent( SlotRecord::MAIN,
$content );
140 $rev->setUserObj( $user );
141 $rev->setComment( $summary );
142 $rev->setTimestamp( $timestamp );
146 $rev->getContent()->equals( $oldRevRecord->getContent( SlotRecord::MAIN ) )
148 $this->
output(
"File for title $actualTitle contains no changes from the current " .
149 "revision. Skipping.\n" );
154 $status = $rev->importOldRevision();
155 $newId =
$title->getLatestRevID();
158 $action = $exists ?
'updated' :
'created';
159 $this->
output(
"Successfully $action $actualTitle\n" );
162 $action = $exists ?
'update' :
'create';
163 $this->
output(
"Failed to $action $actualTitle\n" );
169 if ( $rc && $status ) {
171 if ( is_object( $oldRevRecord ) ) {
172 $oldContent = $oldRevRecord->getContent( SlotRecord::MAIN );
173 RecentChange::notifyEdit(
180 $oldRevRecord->getTimestamp(),
183 $oldRevRecord->getSize(),
191 RecentChange::notifyNew(
207 $this->
output(
"Done! $successCount succeeded, $skipCount skipped.\n" );
209 $this->
fatalError(
"Import failed with $failCount failed pages.\n", $exit );
wfTimestampNow()
Convenience function; returns MediaWiki timestamp for the present time.
wfTimestamp( $outputtype=TS_UNIX, $ts=0)
Get a timestamp string in one of various formats.
const RUN_MAINTENANCE_IF_MAIN
Maintenance script which reads in text files and imports their content to a page of the wiki.
execute()
Do the actual work.
__construct()
Default constructor.
Abstract maintenance class for quickly writing and churning out maintenance scripts with minimal effo...
error( $err, $die=0)
Throw an error to the user.
addArg( $arg, $description, $required=true)
Add some args that are needed.
output( $out, $channel=null)
Throw some output to the user.
hasOption( $name)
Checks to see if a particular option was set.
getArg( $argId=0, $default=null)
Get an argument.
addDescription( $text)
Set the description text.
addOption( $name, $description, $required=false, $withArg=false, $shortName=false, $multiOccurrence=false)
Add a parameter to the script.
getOption( $name, $default=null)
Get an option, or return the default.
fatalError( $msg, $exitCode=1)
Output a message and terminate the current script.
static newFromName( $name, $validate='valid')
Static factory method for creation from username.
static newSystemUser( $name, $options=[])
Static factory method for creation of a "system" user from username.
Represents a revision, log entry or upload during the import process.
if(PHP_SAPI !='cli-server') if(!isset( $_SERVER['SCRIPT_FILENAME'])) $file
Item class for a filearchive table row.