wiki.techinc.nl/includes/deferred/LinksUpdate/ImageLinksTable.php
James D. Forrester 9bfb75ff90 Namespace ParserOutput
Most used non-namespaced class!

Bug: T353458
Change-Id: I4c2cbb0a808b3881a4d6ca489eee5d8c8ebf26cf
2023-12-14 14:57:34 -05:00

131 lines
3.2 KiB
PHP

<?php
namespace MediaWiki\Deferred\LinksUpdate;
use MediaWiki\DAO\WikiAwareEntity;
use MediaWiki\Page\PageReferenceValue;
use MediaWiki\Parser\ParserOutput;
use MediaWiki\Title\Title;
use PurgeJobUtils;
/**
* imagelinks
*
* Link ID format: string image name
*
* @since 1.38
*/
class ImageLinksTable extends TitleLinksTable {
/**
* @var array New links with the name in the key, value arbitrary
*/
private $newLinks;
/**
* @var array Existing links with the name in the key, value arbitrary
*/
private $existingLinks;
public function setParserOutput( ParserOutput $parserOutput ) {
$this->newLinks = $parserOutput->getImages();
}
protected function getTableName() {
return 'imagelinks';
}
protected function getFromField() {
return 'il_from';
}
protected function getExistingFields() {
return [ 'il_to' ];
}
protected function getNewLinkIDs() {
foreach ( $this->newLinks as $link => $unused ) {
yield (string)$link;
}
}
/**
* Get existing links with the name in the key, value arbitrary.
*
* @return array
*/
private function getExistingLinks() {
if ( $this->existingLinks === null ) {
$this->existingLinks = [];
foreach ( $this->fetchExistingRows() as $row ) {
$this->existingLinks[$row->il_to] = true;
}
}
return $this->existingLinks;
}
protected function getExistingLinkIDs() {
foreach ( $this->getExistingLinks() as $link => $unused ) {
yield (string)$link;
}
}
protected function isExisting( $linkId ) {
return \array_key_exists( $linkId, $this->getExistingLinks() );
}
protected function isInNewSet( $linkId ) {
return \array_key_exists( $linkId, $this->newLinks );
}
protected function needForcedLinkRefresh() {
return $this->isCrossNamespaceMove();
}
protected function insertLink( $linkId ) {
$this->insertRow( [
'il_from_namespace' => $this->getSourcePage()->getNamespace(),
'il_to' => $linkId
] );
}
protected function deleteLink( $linkId ) {
$this->deleteRow( [ 'il_to' => $linkId ] );
}
protected function makePageReferenceValue( $linkId ): PageReferenceValue {
return new PageReferenceValue( NS_FILE, $linkId, WikiAwareEntity::LOCAL );
}
protected function makeTitle( $linkId ): Title {
return Title::makeTitle( NS_FILE, $linkId );
}
protected function deduplicateLinkIds( $linkIds ) {
if ( !is_array( $linkIds ) ) {
$linkIds = iterator_to_array( $linkIds );
}
return array_unique( $linkIds );
}
protected function finishUpdate() {
// A update of namespace on cross namespace move is detected as insert + delete,
// but the updates are not needed there.
$allInsertedLinks = array_column( $this->insertedLinks, 0 );
$allDeletedLinks = array_column( $this->deletedLinks, 0 );
$insertedLinks = array_diff( $allInsertedLinks, $allDeletedLinks );
$deletedLinks = array_diff( $allDeletedLinks, $allInsertedLinks );
$this->invalidateImageDescriptions( $insertedLinks, $deletedLinks );
}
/**
* Invalidate all image description pages which had links added or removed
* @param array $insertedLinks
* @param array $deletedLinks
*/
private function invalidateImageDescriptions( array $insertedLinks, array $deletedLinks ) {
PurgeJobUtils::invalidatePages(
$this->getDB(), NS_FILE,
array_merge( $insertedLinks, $deletedLinks ) );
}
}