d6f4e0422a
This property was introduced since 1.17 and was unused, then following the deprecation policy, it was deprecated in 1.29. Removing this now as it's been long enough and has been for several MW versions. Also, updated release notes to mention this removal. Change-Id: Ib6353dd37079bcfe7cd15600e8af1f67b245f4a3
669 lines
12 KiB
PHP
669 lines
12 KiB
PHP
<?php
|
|
/**
|
|
* MediaWiki page data importer.
|
|
*
|
|
* Copyright © 2003,2005 Brion Vibber <brion@pobox.com>
|
|
* https://www.mediawiki.org/
|
|
*
|
|
* This program is free software; you can redistribute it and/or modify
|
|
* it under the terms of the GNU General Public License as published by
|
|
* the Free Software Foundation; either version 2 of the License, or
|
|
* (at your option) any later version.
|
|
*
|
|
* This program is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
* GNU General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU General Public License along
|
|
* with this program; if not, write to the Free Software Foundation, Inc.,
|
|
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
|
|
* http://www.gnu.org/copyleft/gpl.html
|
|
*
|
|
* @file
|
|
* @ingroup SpecialPage
|
|
*/
|
|
use MediaWiki\Logger\LoggerFactory;
|
|
use MediaWiki\MediaWikiServices;
|
|
|
|
/**
|
|
* Represents a revision, log entry or upload during the import process.
|
|
* This class sticks closely to the structure of the XML dump.
|
|
*
|
|
* @since 1.2
|
|
*
|
|
* @ingroup SpecialPage
|
|
*/
|
|
class WikiRevision implements ImportableUploadRevision, ImportableOldRevision {
|
|
|
|
/**
|
|
* @since 1.2
|
|
* @var Title
|
|
*/
|
|
public $title = null;
|
|
|
|
/**
|
|
* @since 1.6.4
|
|
* @var int
|
|
*/
|
|
public $id = 0;
|
|
|
|
/**
|
|
* @since 1.2
|
|
* @var string
|
|
*/
|
|
public $timestamp = "20010115000000";
|
|
|
|
/**
|
|
* @since 1.2
|
|
* @var int
|
|
* @deprecated in 1.29. Unused.
|
|
* @note Introduced in 436a028086fb3f01c4605c5ad2964d56f9306aca, unused there, unused now.
|
|
*/
|
|
public $user = 0;
|
|
|
|
/**
|
|
* @since 1.2
|
|
* @var string
|
|
*/
|
|
public $user_text = "";
|
|
|
|
/**
|
|
* @since 1.27
|
|
* @var User
|
|
*/
|
|
public $userObj = null;
|
|
|
|
/**
|
|
* @since 1.21
|
|
* @var string
|
|
*/
|
|
public $model = null;
|
|
|
|
/**
|
|
* @since 1.21
|
|
* @var string
|
|
*/
|
|
public $format = null;
|
|
|
|
/**
|
|
* @since 1.2
|
|
* @var string
|
|
*/
|
|
public $text = "";
|
|
|
|
/**
|
|
* @since 1.12.2
|
|
* @var int
|
|
*/
|
|
protected $size;
|
|
|
|
/**
|
|
* @since 1.21
|
|
* @var Content
|
|
*/
|
|
public $content = null;
|
|
|
|
/**
|
|
* @since 1.24
|
|
* @var ContentHandler
|
|
*/
|
|
protected $contentHandler = null;
|
|
|
|
/**
|
|
* @since 1.2.6
|
|
* @var string
|
|
*/
|
|
public $comment = "";
|
|
|
|
/**
|
|
* @since 1.5.7
|
|
* @var bool
|
|
*/
|
|
public $minor = false;
|
|
|
|
/**
|
|
* @since 1.12.2
|
|
* @var string
|
|
*/
|
|
public $type = "";
|
|
|
|
/**
|
|
* @since 1.12.2
|
|
* @var string
|
|
*/
|
|
public $action = "";
|
|
|
|
/**
|
|
* @since 1.12.2
|
|
* @var string
|
|
*/
|
|
public $params = "";
|
|
|
|
/**
|
|
* @since 1.17
|
|
* @var string
|
|
*/
|
|
public $fileSrc = '';
|
|
|
|
/**
|
|
* @since 1.17
|
|
* @var bool|string
|
|
*/
|
|
public $sha1base36 = false;
|
|
|
|
/**
|
|
* @since 1.17
|
|
* @var string
|
|
*/
|
|
public $archiveName = '';
|
|
|
|
/**
|
|
* @since 1.12.2
|
|
*/
|
|
protected $filename;
|
|
|
|
/**
|
|
* @since 1.12.2
|
|
* @var string|null
|
|
*/
|
|
protected $src = null;
|
|
|
|
/**
|
|
* @since 1.18
|
|
* @var bool
|
|
* @todo Unused?
|
|
*/
|
|
public $isTemp = false;
|
|
|
|
/**
|
|
* @since 1.18
|
|
* @deprecated 1.29 use Wikirevision::isTempSrc()
|
|
* First written to in 43d5d3b682cc1733ad01a837d11af4a402d57e6a
|
|
* Actually introduced in 52cd34acf590e5be946b7885ffdc13a157c1c6cf
|
|
*/
|
|
public $fileIsTemp;
|
|
|
|
/** @var bool */
|
|
private $mNoUpdates = false;
|
|
|
|
/** @var Config $config */
|
|
private $config;
|
|
|
|
public function __construct( Config $config ) {
|
|
$this->config = $config;
|
|
}
|
|
|
|
/**
|
|
* @since 1.7 taking a Title object (string before)
|
|
* @param Title $title
|
|
* @throws MWException
|
|
*/
|
|
public function setTitle( $title ) {
|
|
if ( is_object( $title ) ) {
|
|
$this->title = $title;
|
|
} elseif ( is_null( $title ) ) {
|
|
throw new MWException( "WikiRevision given a null title in import. "
|
|
. "You may need to adjust \$wgLegalTitleChars." );
|
|
} else {
|
|
throw new MWException( "WikiRevision given non-object title in import." );
|
|
}
|
|
}
|
|
|
|
/**
|
|
* @since 1.6.4
|
|
* @param int $id
|
|
*/
|
|
public function setID( $id ) {
|
|
$this->id = $id;
|
|
}
|
|
|
|
/**
|
|
* @since 1.2
|
|
* @param string $ts
|
|
*/
|
|
public function setTimestamp( $ts ) {
|
|
# 2003-08-05T18:30:02Z
|
|
$this->timestamp = wfTimestamp( TS_MW, $ts );
|
|
}
|
|
|
|
/**
|
|
* @since 1.2
|
|
* @param string $user
|
|
*/
|
|
public function setUsername( $user ) {
|
|
$this->user_text = $user;
|
|
}
|
|
|
|
/**
|
|
* @since 1.27
|
|
* @param User $user
|
|
*/
|
|
public function setUserObj( $user ) {
|
|
$this->userObj = $user;
|
|
}
|
|
|
|
/**
|
|
* @since 1.2
|
|
* @param string $ip
|
|
*/
|
|
public function setUserIP( $ip ) {
|
|
$this->user_text = $ip;
|
|
}
|
|
|
|
/**
|
|
* @since 1.21
|
|
* @param string $model
|
|
*/
|
|
public function setModel( $model ) {
|
|
$this->model = $model;
|
|
}
|
|
|
|
/**
|
|
* @since 1.21
|
|
* @param string $format
|
|
*/
|
|
public function setFormat( $format ) {
|
|
$this->format = $format;
|
|
}
|
|
|
|
/**
|
|
* @since 1.2
|
|
* @param string $text
|
|
*/
|
|
public function setText( $text ) {
|
|
$this->text = $text;
|
|
}
|
|
|
|
/**
|
|
* @since 1.2.6
|
|
* @param string $text
|
|
*/
|
|
public function setComment( $text ) {
|
|
$this->comment = $text;
|
|
}
|
|
|
|
/**
|
|
* @since 1.5.7
|
|
* @param bool $minor
|
|
*/
|
|
public function setMinor( $minor ) {
|
|
$this->minor = (bool)$minor;
|
|
}
|
|
|
|
/**
|
|
* @since 1.12.2
|
|
* @param string|null $src
|
|
*/
|
|
public function setSrc( $src ) {
|
|
$this->src = $src;
|
|
}
|
|
|
|
/**
|
|
* @since 1.17
|
|
* @param string $src
|
|
* @param bool $isTemp
|
|
*/
|
|
public function setFileSrc( $src, $isTemp ) {
|
|
$this->fileSrc = $src;
|
|
$this->fileIsTemp = $isTemp;
|
|
$this->isTemp = $isTemp;
|
|
}
|
|
|
|
/**
|
|
* @since 1.17
|
|
* @param string $sha1base36
|
|
*/
|
|
public function setSha1Base36( $sha1base36 ) {
|
|
$this->sha1base36 = $sha1base36;
|
|
}
|
|
|
|
/**
|
|
* @since 1.12.2
|
|
* @param string $filename
|
|
*/
|
|
public function setFilename( $filename ) {
|
|
$this->filename = $filename;
|
|
}
|
|
|
|
/**
|
|
* @since 1.17
|
|
* @param string $archiveName
|
|
*/
|
|
public function setArchiveName( $archiveName ) {
|
|
$this->archiveName = $archiveName;
|
|
}
|
|
|
|
/**
|
|
* @since 1.12.2
|
|
* @param int $size
|
|
*/
|
|
public function setSize( $size ) {
|
|
$this->size = intval( $size );
|
|
}
|
|
|
|
/**
|
|
* @since 1.12.2
|
|
* @param string $type
|
|
*/
|
|
public function setType( $type ) {
|
|
$this->type = $type;
|
|
}
|
|
|
|
/**
|
|
* @since 1.12.2
|
|
* @param string $action
|
|
*/
|
|
public function setAction( $action ) {
|
|
$this->action = $action;
|
|
}
|
|
|
|
/**
|
|
* @since 1.12.2
|
|
* @param array $params
|
|
*/
|
|
public function setParams( $params ) {
|
|
$this->params = $params;
|
|
}
|
|
|
|
/**
|
|
* @since 1.18
|
|
* @param bool $noupdates
|
|
*/
|
|
public function setNoUpdates( $noupdates ) {
|
|
$this->mNoUpdates = $noupdates;
|
|
}
|
|
|
|
/**
|
|
* @since 1.2
|
|
* @return Title
|
|
*/
|
|
public function getTitle() {
|
|
return $this->title;
|
|
}
|
|
|
|
/**
|
|
* @since 1.6.4
|
|
* @return int
|
|
*/
|
|
public function getID() {
|
|
return $this->id;
|
|
}
|
|
|
|
/**
|
|
* @since 1.2
|
|
* @return string
|
|
*/
|
|
public function getTimestamp() {
|
|
return $this->timestamp;
|
|
}
|
|
|
|
/**
|
|
* @since 1.2
|
|
* @return string
|
|
*/
|
|
public function getUser() {
|
|
return $this->user_text;
|
|
}
|
|
|
|
/**
|
|
* @since 1.27
|
|
* @return User
|
|
*/
|
|
public function getUserObj() {
|
|
return $this->userObj;
|
|
}
|
|
|
|
/**
|
|
* @since 1.2
|
|
* @return string
|
|
*/
|
|
public function getText() {
|
|
return $this->text;
|
|
}
|
|
|
|
/**
|
|
* @since 1.24
|
|
* @return ContentHandler
|
|
*/
|
|
public function getContentHandler() {
|
|
if ( is_null( $this->contentHandler ) ) {
|
|
$this->contentHandler = ContentHandler::getForModelID( $this->getModel() );
|
|
}
|
|
|
|
return $this->contentHandler;
|
|
}
|
|
|
|
/**
|
|
* @since 1.21
|
|
* @return Content
|
|
*/
|
|
public function getContent() {
|
|
if ( is_null( $this->content ) ) {
|
|
$handler = $this->getContentHandler();
|
|
$this->content = $handler->unserializeContent( $this->text, $this->getFormat() );
|
|
}
|
|
|
|
return $this->content;
|
|
}
|
|
|
|
/**
|
|
* @since 1.21
|
|
* @return string
|
|
*/
|
|
public function getModel() {
|
|
if ( is_null( $this->model ) ) {
|
|
$this->model = $this->getTitle()->getContentModel();
|
|
}
|
|
|
|
return $this->model;
|
|
}
|
|
|
|
/**
|
|
* @since 1.21
|
|
* @return string
|
|
*/
|
|
public function getFormat() {
|
|
if ( is_null( $this->format ) ) {
|
|
$this->format = $this->getContentHandler()->getDefaultFormat();
|
|
}
|
|
|
|
return $this->format;
|
|
}
|
|
|
|
/**
|
|
* @since 1.2.6
|
|
* @return string
|
|
*/
|
|
public function getComment() {
|
|
return $this->comment;
|
|
}
|
|
|
|
/**
|
|
* @since 1.5.7
|
|
* @return bool
|
|
*/
|
|
public function getMinor() {
|
|
return $this->minor;
|
|
}
|
|
|
|
/**
|
|
* @since 1.12.2
|
|
* @return string|null
|
|
*/
|
|
public function getSrc() {
|
|
return $this->src;
|
|
}
|
|
|
|
/**
|
|
* @since 1.17
|
|
* @return bool|string
|
|
*/
|
|
public function getSha1() {
|
|
if ( $this->sha1base36 ) {
|
|
return Wikimedia\base_convert( $this->sha1base36, 36, 16 );
|
|
}
|
|
return false;
|
|
}
|
|
|
|
/**
|
|
* @since 1.31
|
|
* @return bool|string
|
|
*/
|
|
public function getSha1Base36() {
|
|
if ( $this->sha1base36 ) {
|
|
return $this->sha1base36;
|
|
}
|
|
return false;
|
|
}
|
|
|
|
/**
|
|
* @since 1.17
|
|
* @return string
|
|
*/
|
|
public function getFileSrc() {
|
|
return $this->fileSrc;
|
|
}
|
|
|
|
/**
|
|
* @since 1.17
|
|
* @return bool
|
|
*/
|
|
public function isTempSrc() {
|
|
return $this->isTemp;
|
|
}
|
|
|
|
/**
|
|
* @since 1.12.2
|
|
* @return mixed
|
|
*/
|
|
public function getFilename() {
|
|
return $this->filename;
|
|
}
|
|
|
|
/**
|
|
* @since 1.17
|
|
* @return string
|
|
*/
|
|
public function getArchiveName() {
|
|
return $this->archiveName;
|
|
}
|
|
|
|
/**
|
|
* @since 1.12.2
|
|
* @return mixed
|
|
*/
|
|
public function getSize() {
|
|
return $this->size;
|
|
}
|
|
|
|
/**
|
|
* @since 1.12.2
|
|
* @return string
|
|
*/
|
|
public function getType() {
|
|
return $this->type;
|
|
}
|
|
|
|
/**
|
|
* @since 1.12.2
|
|
* @return string
|
|
*/
|
|
public function getAction() {
|
|
return $this->action;
|
|
}
|
|
|
|
/**
|
|
* @since 1.12.2
|
|
* @return string
|
|
*/
|
|
public function getParams() {
|
|
return $this->params;
|
|
}
|
|
|
|
/**
|
|
* @since 1.4.1
|
|
* @deprecated in 1.31. Use OldRevisionImporter::import
|
|
* @return bool
|
|
*/
|
|
public function importOldRevision() {
|
|
if ( $this->mNoUpdates ) {
|
|
$importer = MediaWikiServices::getInstance()->getWikiRevisionOldRevisionImporterNoUpdates();
|
|
} else {
|
|
$importer = MediaWikiServices::getInstance()->getWikiRevisionOldRevisionImporter();
|
|
}
|
|
return $importer->import( $this );
|
|
}
|
|
|
|
/**
|
|
* @since 1.12.2
|
|
* @return bool
|
|
*/
|
|
public function importLogItem() {
|
|
$dbw = wfGetDB( DB_MASTER );
|
|
|
|
$user = $this->getUserObj() ?: User::newFromName( $this->getUser(), false );
|
|
|
|
# @todo FIXME: This will not record autoblocks
|
|
if ( !$this->getTitle() ) {
|
|
wfDebug( __METHOD__ . ": skipping invalid {$this->type}/{$this->action} log time, timestamp " .
|
|
$this->timestamp . "\n" );
|
|
return false;
|
|
}
|
|
# Check if it exists already
|
|
// @todo FIXME: Use original log ID (better for backups)
|
|
$prior = $dbw->selectField( 'logging', '1',
|
|
[ 'log_type' => $this->getType(),
|
|
'log_action' => $this->getAction(),
|
|
'log_timestamp' => $dbw->timestamp( $this->timestamp ),
|
|
'log_namespace' => $this->getTitle()->getNamespace(),
|
|
'log_title' => $this->getTitle()->getDBkey(),
|
|
'log_params' => $this->params ],
|
|
__METHOD__
|
|
);
|
|
// @todo FIXME: This could fail slightly for multiple matches :P
|
|
if ( $prior ) {
|
|
wfDebug( __METHOD__
|
|
. ": skipping existing item for Log:{$this->type}/{$this->action}, timestamp "
|
|
. $this->timestamp . "\n" );
|
|
return false;
|
|
}
|
|
$data = [
|
|
'log_type' => $this->type,
|
|
'log_action' => $this->action,
|
|
'log_timestamp' => $dbw->timestamp( $this->timestamp ),
|
|
'log_namespace' => $this->getTitle()->getNamespace(),
|
|
'log_title' => $this->getTitle()->getDBkey(),
|
|
'log_params' => $this->params
|
|
] + CommentStore::getStore()->insert( $dbw, 'log_comment', $this->getComment() )
|
|
+ ActorMigration::newMigration()->getInsertValues( $dbw, 'log_user', $user );
|
|
$dbw->insert( 'logging', $data, __METHOD__ );
|
|
|
|
return true;
|
|
}
|
|
|
|
/**
|
|
* @since 1.12.2
|
|
* @deprecated in 1.31. Use UploadImporter::import
|
|
* @return bool
|
|
*/
|
|
public function importUpload() {
|
|
$importer = MediaWikiServices::getInstance()->getWikiRevisionUploadImporter();
|
|
$statusValue = $importer->import( $this );
|
|
return $statusValue->isGood();
|
|
}
|
|
|
|
/**
|
|
* @since 1.12.2
|
|
* @deprecated in 1.31. Use UploadImporter::downloadSource
|
|
* @return bool|string
|
|
*/
|
|
public function downloadSource() {
|
|
$importer = new ImportableUploadRevisionImporter(
|
|
$this->config->get( 'EnableUploads' ),
|
|
LoggerFactory::getInstance( 'UploadRevisionImporter' )
|
|
);
|
|
return $importer->downloadSource( $this );
|
|
}
|
|
|
|
}
|