| Server IP : 167.235.224.122 / Your IP : 216.73.216.110 Web Server : Apache/2.4.58 (Ubuntu) System : Linux newplayground 6.8.0-136-generic #136-Ubuntu SMP PREEMPT_DYNAMIC Wed Jul 1 21:33:11 UTC 2026 aarch64 User : deploy ( 1000) PHP Version : 8.4.23 Disable Function : NONE MySQL : OFF | cURL : ON | WGET : ON | Perl : ON | Python : OFF | Sudo : ON | Pkexec : OFF Directory : /var/www/html/wiki/includes/Storage/ |
Upload File : |
<?php
/**
* 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
*/
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 );
}
}