MediaWiki master
WikiFilePage.php
Go to the documentation of this file.
1<?php
26
32class WikiFilePage extends WikiPage {
34 protected $mFile = false;
36 protected $mRepo = null;
38 protected $mFileLoaded = false;
40 protected $mDupes = null;
41
45 public function __construct( $title ) {
46 parent::__construct( $title );
47 $this->mDupes = null;
48 $this->mRepo = null;
49 }
50
54 public function setFile( File $file ) {
55 $this->mFile = $file;
56 $this->mFileLoaded = true;
57 }
58
62 protected function loadFile() {
63 $services = MediaWikiServices::getInstance();
64 if ( $this->mFileLoaded ) {
65 return true;
66 }
67
68 $this->mFile = $services->getRepoGroup()->findFile( $this->mTitle );
69 if ( !$this->mFile ) {
70 $this->mFile = $services->getRepoGroup()->getLocalRepo()
71 ->newFile( $this->mTitle );
72 }
73
74 if ( !$this->mFile instanceof File ) {
75 throw new RuntimeException( 'Expected to find file. See T250767' );
76 }
77
78 $this->mRepo = $this->mFile->getRepo();
79 $this->mFileLoaded = true;
80 return true;
81 }
82
86 public function followRedirect() {
87 $this->loadFile();
88 if ( $this->mFile->isLocal() ) {
89 return parent::followRedirect();
90 }
91 $from = $this->mFile->getRedirected();
92 $to = $this->mFile->getName();
93 if ( $from === null || $from === $to ) {
94 return false;
95 }
96 return Title::makeTitle( NS_FILE, $to );
97 }
98
102 public function isRedirect() {
103 $this->loadFile();
104 if ( $this->mFile->isLocal() ) {
105 return parent::isRedirect();
106 }
107
108 return $this->mFile->getRedirected() !== null;
109 }
110
114 public function isLocal() {
115 $this->loadFile();
116 return $this->mFile->isLocal();
117 }
118
122 public function getFile(): File {
123 $this->loadFile();
124 return $this->mFile;
125 }
126
130 public function getDuplicates() {
131 $this->loadFile();
132 if ( $this->mDupes !== null ) {
133 return $this->mDupes;
134 }
135 $hash = $this->mFile->getSha1();
136 if ( !( $hash ) ) {
137 $this->mDupes = [];
138 return $this->mDupes;
139 }
140 $dupes = MediaWikiServices::getInstance()->getRepoGroup()->findBySha1( $hash );
141 // Remove duplicates with self and non matching file sizes
142 $self = $this->mFile->getRepoName() . ':' . $this->mFile->getName();
143 $size = $this->mFile->getSize();
144
148 foreach ( $dupes as $index => $file ) {
149 $key = $file->getRepoName() . ':' . $file->getName();
150 if ( $key === $self || $file->getSize() != $size ) {
151 unset( $dupes[$index] );
152 }
153 }
154 $this->mDupes = $dupes;
155 return $this->mDupes;
156 }
157
162 public function doPurge() {
163 $this->loadFile();
164
165 if ( $this->mFile->exists() ) {
166 wfDebug( 'ImagePage::doPurge purging ' . $this->mFile->getName() );
167 $job = HTMLCacheUpdateJob::newForBacklinks(
168 $this->mTitle,
169 'imagelinks',
170 [ 'causeAction' => 'file-purge' ]
171 );
172 MediaWikiServices::getInstance()->getJobQueueGroup()->lazyPush( $job );
173 } else {
174 wfDebug( 'ImagePage::doPurge no image for '
175 . $this->mFile->getName() . "; limiting purge to cache only" );
176 }
177
178 // even if the file supposedly doesn't exist, force any cached information
179 // to be updated (in case the cached information is wrong)
180
181 // Purge current version and its thumbnails
182 $this->mFile->purgeCache( [ 'forThumbRefresh' => true ] );
183
184 // Purge the old versions and their thumbnails
185 foreach ( $this->mFile->getHistory() as $oldFile ) {
186 $oldFile->purgeCache( [ 'forThumbRefresh' => true ] );
187 }
188
189 if ( $this->mRepo ) {
190 // Purge redirect cache
191 $this->mRepo->invalidateImageRedirect( $this->mTitle );
192 }
193
194 return parent::doPurge();
195 }
196
206 public function getForeignCategories() {
207 $this->loadFile();
208 $title = $this->mTitle;
209 $file = $this->mFile;
210 $titleFactory = MediaWikiServices::getInstance()->getTitleFactory();
211
212 if ( !$file instanceof LocalFile ) {
213 wfDebug( __METHOD__ . " is not supported for this file" );
214 return $titleFactory->newTitleArrayFromResult( new FakeResultWrapper( [] ) );
215 }
216
218 $repo = $file->getRepo();
219 $dbr = $repo->getReplicaDB();
220
221 $res = $dbr->newSelectQueryBuilder()
222 ->select( [ 'page_title' => 'cl_to', 'page_namespace' => (string)NS_CATEGORY ] )
223 ->from( 'page' )
224 ->join( 'categorylinks', null, 'page_id = cl_from' )
225 ->where( [ 'page_namespace' => $title->getNamespace(), 'page_title' => $title->getDBkey(), ] )
226 ->caller( __METHOD__ )->fetchResultSet();
227
228 return $titleFactory->newTitleArrayFromResult( $res );
229 }
230
235 public function getWikiDisplayName() {
236 return $this->getFile()->getRepo()->getDisplayName();
237 }
238
243 public function getSourceURL() {
244 return $this->getFile()->getDescriptionUrl();
245 }
246
250 public function getActionOverrides() {
251 $file = $this->getFile();
252 if ( $file->exists() && $file->isLocal() && !$file->getRedirected() ) {
253 // Would be an actual file deletion
254 return [ 'delete' => FileDeleteAction::class ] + parent::getActionOverrides();
255 }
256 // It should use the normal article deletion interface
257 return parent::getActionOverrides();
258 }
259}
const NS_FILE
Definition Defines.php:71
const NS_CATEGORY
Definition Defines.php:79
wfDebug( $text, $dest='all', array $context=[])
Sends a line to the debug log if enabled or, optionally, to a comment in output.
Title null $mTitle
getFile()
Get the file for this page, if one exists.
Implements some public methods and some protected utility functions which are required by multiple ch...
Definition File.php:76
Local file in the wiki's own database.
Definition LocalFile.php:74
Local repository that stores files in the local filesystem and registers them in the wiki's own datab...
Definition LocalRepo.php:49
Service locator for MediaWiki core services.
Represents a title within MediaWiki.
Definition Title.php:78
Special handling for representing file pages.
File false $mFile
array null $mDupes
getActionOverrides()
Move this UI stuff somewhere elseContentHandler::getActionOverrides array
__construct( $title)
doPurge()
Override handling of action=purge.
getForeignCategories()
Get the categories this file is a member of on the wiki where it was uploaded.
setFile(File $file)
LocalRepo null $mRepo
Base representation for an editable wiki page.
Definition WikiPage.php:83
Overloads the relevant methods of the real ResultWrapper so it doesn't go anywhere near an actual dat...
if(count( $args)< 1) $job