Page MenuHomeWickedGov Phorge
Files F4051345

EditResultCache.php
No OneTemporary
Actions

Size
3 KB
Referenced Files
None
Subscribers
None

EditResultCache.php
View Options

<?php
/**
* @license GPL-2.0-or-later
* @file
*/
namespace MediaWiki\Storage;
use MediaWiki\Config\ServiceOptions;
use MediaWiki\Json\FormatJson;
use MediaWiki\MainConfigNames;
use Wikimedia\ObjectCache\BagOStuff;
use Wikimedia\Rdbms\IConnectionProvider;
/**
* Class allowing easy storage and retrieval of EditResults associated with revisions.
*
* EditResults are stored in the main object stash and (depending on wiki's configuration)
* in revert change tags. This class stores the relevant data in the main stash. When
* asked to retrieve an EditResult for an edit and the requested key is not present in the
* main stash, the class will attempt to retrieve the EditResult from revert tags.
*
* @internal Used by RevertedTagUpdateManager
* @since 1.36
* @author Ostrzyciel
*/
class EditResultCache {
public const CONSTRUCTOR_OPTIONS = [
MainConfigNames::RCMaxAge,
];
private const CACHE_KEY_PREFIX = 'EditResult';
/** @var BagOStuff */
private $mainObjectStash;
/** @var IConnectionProvider */
private $dbProvider;
/** @var ServiceOptions */
private $options;
/**
* @param BagOStuff $mainObjectStash Main object stash, see
* MediaWikiServices::getMainObjectStash()
* @param IConnectionProvider $dbProvider
* @param ServiceOptions $options
*/
public function __construct(
BagOStuff $mainObjectStash,
IConnectionProvider $dbProvider,
ServiceOptions $options
) {
$options->assertRequiredOptions( self::CONSTRUCTOR_OPTIONS );
$this->mainObjectStash = $mainObjectStash;
$this->dbProvider = $dbProvider;
$this->options = $options;
}
/**
* Store the EditResult in the main object stash.
*
* @param int $revisionId
* @param EditResult $editResult
*
* @return bool Success
*/
public function set( int $revisionId, EditResult $editResult ): bool {
return $this->mainObjectStash->set(
$this->makeKey( $revisionId ),
FormatJson::encode( $editResult ),
// Patrol flags are not stored for longer than $wgRCMaxAge
$this->options->get( MainConfigNames::RCMaxAge ),
BagOStuff::WRITE_BACKGROUND
);
}
/**
* Get an EditResult for the given revision ID.
*
* Will first attempt to get the EditResult from the main stash. If this fails, it
* will try to retrieve the EditResult from revert change tags of this revision.
*
* @param int $revisionId
*
* @return EditResult|null Returns null on failure
*/
public function get( int $revisionId ): ?EditResult {
$result = $this->mainObjectStash->get( $this->makeKey( $revisionId ) );
// not found in stash, try change tags
if ( !$result ) {
$result = $this->dbProvider->getReplicaDatabase()->newSelectQueryBuilder()
->select( 'ct_params' )
->from( 'change_tag' )
->join( 'change_tag_def', null, 'ctd_id = ct_tag_id' )
->where( [
'ct_rev_id' => $revisionId,
'ctd_name' => [ 'mw-rollback', 'mw-undo', 'mw-manual-revert' ]
] )
->caller( __METHOD__ )->fetchField();
}
if ( !$result ) {
return null;
}
$decoded = FormatJson::decode( $result, true );
return $decoded ? EditResult::newFromArray( $decoded ) : null;
}
/**
* Generates a cache key for the given revision ID.
*
* @param int $revisionId
*
* @return string
*/
private function makeKey( int $revisionId ): string {
return $this->mainObjectStash->makeKey( self::CACHE_KEY_PREFIX, $revisionId );
}
}

File Metadata

Mime Type
text/x-php
Expires
Aug 15 2026, 17:59 (12 w, 3 d ago)
Storage Engine
local-disk
Storage Format
Raw Data
Storage Handle
4c/a1/7ab1699ee9792b42da68af66f28e
Default Alt Text
EditResultCache.php (3 KB)

Event Timeline