MediaWiki  master
LinksDeletionUpdate.php
Go to the documentation of this file.
1 <?php
23 use Wikimedia\ScopedCallback;
24 
30  protected $page;
32  protected $timestamp;
33 
40  public function __construct( WikiPage $page, $pageId = null, $timestamp = null ) {
41  $this->page = $page;
42  if ( $pageId ) {
43  $this->mId = $pageId; // page ID at time of deletion
44  } elseif ( $page->exists() ) {
45  $this->mId = $page->getId();
46  } else {
47  throw new InvalidArgumentException( "Page ID not known. Page doesn't exist?" );
48  }
49 
50  $this->timestamp = $timestamp ?: wfTimestampNow();
51 
52  $fakePO = new ParserOutput();
53  $fakePO->setCacheTime( $timestamp );
54  parent::__construct( $page->getTitle(), $fakePO, false );
55  }
56 
57  protected function doIncrementalUpdate() {
58  $services = MediaWikiServices::getInstance();
59  $config = $services->getMainConfig();
60  $lbFactory = $services->getDBLoadBalancerFactory();
61  $batchSize = $config->get( 'UpdateRowsPerQuery' );
62 
63  $id = $this->mId;
65 
66  $dbw = $this->getDB(); // convenience
67 
68  parent::doIncrementalUpdate();
69 
70  // Typically, a category is empty when deleted, so check that we don't leave
71  // spurious row in the category table.
72  if ( $title->getNamespace() === NS_CATEGORY ) {
73  // T166757: do the update after the main job DB commit
74  DeferredUpdates::addCallableUpdate( function () use ( $title ) {
75  $cat = Category::newFromName( $title->getDBkey() );
76  $cat->refreshCountsIfSmall();
77  } );
78  }
79 
80  // Delete restrictions for the deleted page
81  $dbw->delete( 'page_restrictions', [ 'pr_page' => $id ], __METHOD__ );
82 
83  // Delete any redirect entry
84  $dbw->delete( 'redirect', [ 'rd_from' => $id ], __METHOD__ );
85 
86  // Find recentchanges entries to clean up...
87  $rcIdsForTitle = $dbw->selectFieldValues(
88  'recentchanges',
89  'rc_id',
90  [
91  'rc_type != ' . RC_LOG,
92  'rc_namespace' => $title->getNamespace(),
93  'rc_title' => $title->getDBkey(),
94  'rc_timestamp < ' .
95  $dbw->addQuotes( $dbw->timestamp( $this->timestamp ) )
96  ],
97  __METHOD__
98  );
99  $rcIdsForPage = $dbw->selectFieldValues(
100  'recentchanges',
101  'rc_id',
102  [ 'rc_type != ' . RC_LOG, 'rc_cur_id' => $id ],
103  __METHOD__
104  );
105 
106  // T98706: delete by PK to avoid lock contention with RC delete log insertions
107  $rcIdBatches = array_chunk( array_merge( $rcIdsForTitle, $rcIdsForPage ), $batchSize );
108  foreach ( $rcIdBatches as $rcIdBatch ) {
109  $dbw->delete( 'recentchanges', [ 'rc_id' => $rcIdBatch ], __METHOD__ );
110  if ( count( $rcIdBatches ) > 1 ) {
111  $lbFactory->commitAndWaitForReplication(
112  __METHOD__, $this->ticket, [ 'domain' => $dbw->getDomainID() ]
113  );
114  }
115  }
116 
117  // Commit and release the lock (if set)
118  ScopedCallback::consume( $scopedLock );
119  }
120 
121  public function getAsJobSpecification() {
122  return [
123  'domain' => $this->getDB()->getDomainID(),
124  'job' => new JobSpecification(
125  'deleteLinks',
126  [ 'pageId' => $this->mId, 'timestamp' => $this->timestamp ],
127  [ 'removeDuplicates' => true ],
128  $this->mTitle
129  )
130  ];
131  }
132 }
ParserOutput
Definition: ParserOutput.php:25
MediaWiki\MediaWikiServices
MediaWikiServices is the service locator for the application scope of MediaWiki.
Definition: MediaWikiServices.php:149
LinksUpdate\$mId
int $mId
Page ID of the article linked from.
Definition: LinksUpdate.php:43
RC_LOG
const RC_LOG
Definition: Defines.php:133
LinksDeletionUpdate\$timestamp
string $timestamp
Definition: LinksDeletionUpdate.php:32
WikiPage
Class representing a MediaWiki article and history.
Definition: WikiPage.php:49
LinksUpdate
Class the manages updates of *_link tables as well as similar extension-managed tables.
Definition: LinksUpdate.php:37
LinksDeletionUpdate\$page
WikiPage $page
Definition: LinksDeletionUpdate.php:30
EnqueueableDataUpdate
Interface that marks a DataUpdate as enqueuable via the JobQueue.
Definition: EnqueueableDataUpdate.php:10
LinksDeletionUpdate\doIncrementalUpdate
doIncrementalUpdate()
Definition: LinksDeletionUpdate.php:57
LinksDeletionUpdate\getAsJobSpecification
getAsJobSpecification()
Definition: LinksDeletionUpdate.php:121
WikiPage\getId
getId()
Definition: WikiPage.php:570
WikiPage\getTitle
getTitle()
Get the title object of the article.
Definition: WikiPage.php:310
WikiPage\exists
exists()
Definition: WikiPage.php:580
LinksDeletionUpdate\__construct
__construct(WikiPage $page, $pageId=null, $timestamp=null)
Definition: LinksDeletionUpdate.php:40
$title
$title
Definition: testCompression.php:38
wfTimestampNow
wfTimestampNow()
Convenience function; returns MediaWiki timestamp for the present time.
Definition: GlobalFunctions.php:1835
NS_CATEGORY
const NS_CATEGORY
Definition: Defines.php:83
LinksUpdate\$mTitle
Title $mTitle
Title object of the article linked from.
Definition: LinksUpdate.php:46
LinksDeletionUpdate
Update object handling the cleanup of links tables after a page was deleted.
Definition: LinksDeletionUpdate.php:28
JobSpecification
Job queue task description base code.
Definition: JobSpecification.php:39
Category\newFromName
static newFromName( $name)
Factory function.
Definition: Category.php:133
LinksUpdate\getDB
getDB()
Definition: LinksUpdate.php:1229
DeferredUpdates\addCallableUpdate
static addCallableUpdate( $callable, $stage=self::POSTSEND, $dbw=null)
Add a callable update.
Definition: DeferredUpdates.php:145