MediaWiki  1.34.0
WANCacheReapUpdate.php
Go to the documentation of this file.
1 <?php
2 
5 use Psr\Log\LoggerInterface;
7 
28  private $db;
30  private $logger;
31 
36  public function __construct( IDatabase $db, LoggerInterface $logger ) {
37  $this->db = $db;
38  $this->logger = $logger;
39  }
40 
41  function doUpdate() {
42  $reaper = new WANObjectCacheReaper(
43  MediaWikiServices::getInstance()->getMainWANObjectCache(),
45  [ $this, 'getTitleChangeEvents' ],
46  [ $this, 'getEventAffectedKeys' ],
47  [
48  'channel' => 'table:recentchanges:' . $this->db->getDomainID(),
49  'logger' => $this->logger
50  ]
51  );
52 
53  $reaper->invoke( 100 );
54  }
55 
65  public function getTitleChangeEvents( $start, $id, $end, $limit ) {
66  $db = $this->db;
67  $encStart = $db->addQuotes( $db->timestamp( $start ) );
68  $encEnd = $db->addQuotes( $db->timestamp( $end ) );
69  $id = (int)$id; // cast NULL => 0 since rc_id is an integer
70 
71  $res = $db->select(
72  'recentchanges',
73  [ 'rc_namespace', 'rc_title', 'rc_timestamp', 'rc_id' ],
74  [
75  $db->makeList( [
76  "rc_timestamp > $encStart",
77  "rc_timestamp = $encStart AND rc_id > " . $db->addQuotes( $id )
78  ], LIST_OR ),
79  "rc_timestamp < $encEnd"
80  ],
81  __METHOD__,
82  [ 'ORDER BY' => 'rc_timestamp ASC, rc_id ASC', 'LIMIT' => $limit ]
83  );
84 
85  $events = [];
86  foreach ( $res as $row ) {
87  $events[] = [
88  'id' => (int)$row->rc_id,
89  'pos' => (int)wfTimestamp( TS_UNIX, $row->rc_timestamp ),
90  'item' => new TitleValue( (int)$row->rc_namespace, $row->rc_title )
91  ];
92  }
93 
94  return $events;
95  }
96 
107  $entities = [];
108 
109  // You can't create a WikiPage for special pages (-1) or other virtual
110  // namespaces, but special pages do appear in RC sometimes, e.g. for logs
111  // of AbuseFilter filter changes.
112  if ( $t->getNamespace() >= 0 ) {
113  $entities[] = WikiPage::factory( Title::newFromLinkTarget( $t ) );
114  }
115 
116  if ( $t->inNamespace( NS_FILE ) ) {
117  $entities[] = MediaWikiServices::getInstance()->getRepoGroup()->getLocalRepo()
118  ->newFile( $t->getText() );
119  }
120  if ( $t->inNamespace( NS_USER ) ) {
121  $entities[] = User::newFromName( $t->getText(), false );
122  }
123 
124  $keys = [];
125  foreach ( $entities as $entity ) {
126  if ( $entity ) {
127  $keys = array_merge( $keys, $entity->getMutableCacheKeys( $cache ) );
128  }
129  }
130  if ( $keys ) {
131  $this->logger->debug( __CLASS__ . ': got key(s) ' . implode( ', ', $keys ) );
132  }
133 
134  return $keys;
135  }
136 }
WANCacheReapUpdate\$db
IDatabase $db
Definition: WANCacheReapUpdate.php:28
WANCacheReapUpdate\__construct
__construct(IDatabase $db, LoggerInterface $logger)
Definition: WANCacheReapUpdate.php:36
ObjectCache\getLocalClusterInstance
static getLocalClusterInstance()
Get the main cluster-local cache object.
Definition: ObjectCache.php:342
Wikimedia\Rdbms\IDatabase\makeList
makeList( $a, $mode=self::LIST_COMMA)
Makes an encoded list of strings from an array.
MediaWiki\MediaWikiServices
MediaWikiServices is the service locator for the application scope of MediaWiki.
Definition: MediaWikiServices.php:117
wfTimestamp
wfTimestamp( $outputtype=TS_UNIX, $ts=0)
Get a timestamp string in one of various formats.
Definition: GlobalFunctions.php:1869
NS_FILE
const NS_FILE
Definition: Defines.php:66
WANCacheReapUpdate
Class for fixing stale WANObjectCache keys using a purge event source.
Definition: WANCacheReapUpdate.php:26
User\newFromName
static newFromName( $name, $validate='valid')
Static factory method for creation from username.
Definition: User.php:515
$res
$res
Definition: testCompression.php:52
WANCacheReapUpdate\getTitleChangeEvents
getTitleChangeEvents( $start, $id, $end, $limit)
Definition: WANCacheReapUpdate.php:65
Wikimedia\Rdbms\IDatabase
Basic database interface for live and lazy-loaded relation database handles.
Definition: IDatabase.php:38
Wikimedia\Rdbms\IDatabase\timestamp
timestamp( $ts=0)
Convert a timestamp in one of the formats accepted by ConvertibleTimestamp to the format used for ins...
LIST_OR
const LIST_OR
Definition: Defines.php:42
WANCacheReapUpdate\getEventAffectedKeys
getEventAffectedKeys(WANObjectCache $cache, LinkTarget $t)
Gets a list of important cache keys associated with a title.
Definition: WANCacheReapUpdate.php:105
WikiPage\factory
static factory(Title $title)
Create a WikiPage object of the appropriate class for the given title.
Definition: WikiPage.php:142
$t
$t
Definition: make-normalization-table.php:143
WANCacheReapUpdate\$logger
LoggerInterface $logger
Definition: WANCacheReapUpdate.php:30
WANObjectCache
Multi-datacenter aware caching interface.
Definition: WANObjectCache.php:116
Title\newFromLinkTarget
static newFromLinkTarget(LinkTarget $linkTarget, $forceClone='')
Returns a Title given a LinkTarget.
Definition: Title.php:268
$cache
$cache
Definition: mcc.php:33
Wikimedia\Rdbms\IDatabase\addQuotes
addQuotes( $s)
Escape and quote a raw value string for use in a SQL query.
WANObjectCacheReaper\invoke
invoke( $n=100)
Check and reap stale keys based on a chunk of events.
Definition: WANObjectCacheReaper.php:108
$keys
$keys
Definition: testCompression.php:67
Wikimedia\Rdbms\IDatabase\select
select( $table, $vars, $conds='', $fname=__METHOD__, $options=[], $join_conds=[])
Execute a SELECT query constructed using the various parameters provided.
NS_USER
const NS_USER
Definition: Defines.php:62
WANObjectCacheReaper
Class for scanning through chronological, log-structured data or change logs and locally purging cach...
Definition: WANObjectCacheReaper.php:37
WANCacheReapUpdate\doUpdate
doUpdate()
Perform the actual work.
Definition: WANCacheReapUpdate.php:41
DeferrableUpdate
Interface that deferrable updates should implement.
Definition: DeferrableUpdate.php:9
MediaWiki\Linker\LinkTarget
Definition: LinkTarget.php:26
TitleValue
Represents a page (or page fragment) title within MediaWiki.
Definition: TitleValue.php:36