includes/page/WikiFilePage.php

   1 <?php
   2 /**
   3  * Special handling for file pages.
   4  *
   5  * This program is free software; you can redistribute it and/or modify
   6  * it under the terms of the GNU General Public License as published by
   7  * the Free Software Foundation; either version 2 of the License, or
   8  * (at your option) any later version.
   9  *
  10  * This program is distributed in the hope that it will be useful,
  11  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  12  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  13  * GNU General Public License for more details.
  14  *
  15  * You should have received a copy of the GNU General Public License along
  16  * with this program; if not, write to the Free Software Foundation, Inc.,
  17  * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  18  * http://www.gnu.org/copyleft/gpl.html
  19  *
  20  * @file
  21  */
  22
  23 use Wikimedia\Rdbms\FakeResultWrapper;
  24
  25 /**
  26  * Special handling for file pages
  27  *
  28  * @ingroup Media
  29  */
  30 class WikiFilePage extends WikiPage {
  31         /** @var File */
  32         protected $mFile = false;
  33         /** @var LocalRepo */
  34         protected $mRepo = null;
  35         /** @var bool */
  36         protected $mFileLoaded = false;
  37         /** @var array */
  38         protected $mDupes = null;
  39
  40         public function __construct( $title ) {
  41                 parent::__construct( $title );
  42                 $this->mDupes = null;
  43                 $this->mRepo = null;
  44         }
  45
  46         /**
  47          * @param File $file
  48          */
  49         public function setFile( $file ) {
  50                 $this->mFile = $file;
  51                 $this->mFileLoaded = true;
  52         }
  53
  54         /**
  55          * @return bool
  56          */
  57         protected function loadFile() {
  58                 if ( $this->mFileLoaded ) {
  59                         return true;
  60                 }
  61                 $this->mFileLoaded = true;
  62
  63                 $this->mFile = wfFindFile( $this->mTitle );
  64                 if ( !$this->mFile ) {
  65                         $this->mFile = wfLocalFile( $this->mTitle ); // always a File
  66                 }
  67                 $this->mRepo = $this->mFile->getRepo();
  68                 return true;
  69         }
  70
  71         /**
  72          * @return mixed|null|Title
  73          */
  74         public function getRedirectTarget() {
  75                 $this->loadFile();
  76                 if ( $this->mFile->isLocal() ) {
  77                         return parent::getRedirectTarget();
  78                 }
  79                 // Foreign image page
  80                 $from = $this->mFile->getRedirected();
  81                 $to = $this->mFile->getName();
  82                 if ( $from == $to ) {
  83                         return null;
  84                 }
  85                 $this->mRedirectTarget = Title::makeTitle( NS_FILE, $to );
  86                 return $this->mRedirectTarget;
  87         }
  88
  89         /**
  90          * @return bool|mixed|Title
  91          */
  92         public function followRedirect() {
  93                 $this->loadFile();
  94                 if ( $this->mFile->isLocal() ) {
  95                         return parent::followRedirect();
  96                 }
  97                 $from = $this->mFile->getRedirected();
  98                 $to = $this->mFile->getName();
  99                 if ( $from == $to ) {
 100                         return false;
 101                 }
 102                 return Title::makeTitle( NS_FILE, $to );
 103         }
 104
 105         /**
 106          * @return bool
 107          */
 108         public function isRedirect() {
 109                 $this->loadFile();
 110                 if ( $this->mFile->isLocal() ) {
 111                         return parent::isRedirect();
 112                 }
 113
 114                 return (bool)$this->mFile->getRedirected();
 115         }
 116
 117         /**
 118          * @return bool
 119          */
 120         public function isLocal() {
 121                 $this->loadFile();
 122                 return $this->mFile->isLocal();
 123         }
 124
 125         /**
 126          * @return bool|File
 127          */
 128         public function getFile() {
 129                 $this->loadFile();
 130                 return $this->mFile;
 131         }
 132
 133         /**
 134          * @return array|null
 135          */
 136         public function getDuplicates() {
 137                 $this->loadFile();
 138                 if ( !is_null( $this->mDupes ) ) {
 139                         return $this->mDupes;
 140                 }
 141                 $hash = $this->mFile->getSha1();
 142                 if ( !( $hash ) ) {
 143                         $this->mDupes = [];
 144                         return $this->mDupes;
 145                 }
 146                 $dupes = RepoGroup::singleton()->findBySha1( $hash );
 147                 // Remove duplicates with self and non matching file sizes
 148                 $self = $this->mFile->getRepoName() . ':' . $this->mFile->getName();
 149                 $size = $this->mFile->getSize();
 150
 151                 /**
 152                  * @var $file File
 153                  */
 154                 foreach ( $dupes as $index => $file ) {
 155                         $key = $file->getRepoName() . ':' . $file->getName();
 156                         if ( $key == $self ) {
 157                                 unset( $dupes[$index] );
 158                         }
 159                         if ( $file->getSize() != $size ) {
 160                                 unset( $dupes[$index] );
 161                         }
 162                 }
 163                 $this->mDupes = $dupes;
 164                 return $this->mDupes;
 165         }
 166
 167         /**
 168          * Override handling of action=purge
 169          * @return bool
 170          */
 171         public function doPurge() {
 172                 $this->loadFile();
 173
 174                 if ( $this->mFile->exists() ) {
 175                         wfDebug( 'ImagePage::doPurge purging ' . $this->mFile->getName() . "\n" );
 176                         DeferredUpdates::addUpdate(
 177                                 new HTMLCacheUpdate( $this->mTitle, 'imagelinks', 'file-purge' )
 178                         );
 179                 } else {
 180                         wfDebug( 'ImagePage::doPurge no image for '
 181                                 . $this->mFile->getName() . "; limiting purge to cache only\n" );
 182                 }
 183
 184                 // even if the file supposedly doesn't exist, force any cached information
 185                 // to be updated (in case the cached information is wrong)
 186
 187                 // Purge current version and its thumbnails
 188                 $this->mFile->purgeCache( [ 'forThumbRefresh' => true ] );
 189
 190                 // Purge the old versions and their thumbnails
 191                 foreach ( $this->mFile->getHistory() as $oldFile ) {
 192                         $oldFile->purgeCache( [ 'forThumbRefresh' => true ] );
 193                 }
 194
 195                 if ( $this->mRepo ) {
 196                         // Purge redirect cache
 197                         $this->mRepo->invalidateImageRedirect( $this->mTitle );
 198                 }
 199
 200                 return parent::doPurge();
 201         }
 202
 203         /**
 204          * Get the categories this file is a member of on the wiki where it was uploaded.
 205          * For local files, this is the same as getCategories().
 206          * For foreign API files (InstantCommons), this is not supported currently.
 207          * Results will include hidden categories.
 208          *
 209          * @return TitleArray|Title[]
 210          * @since 1.23
 211          */
 212         public function getForeignCategories() {
 213                 $this->loadFile();
 214                 $title = $this->mTitle;
 215                 $file = $this->mFile;
 216
 217                 if ( !$file instanceof LocalFile ) {
 218                         wfDebug( __CLASS__ . '::' . __METHOD__ . " is not supported for this file\n" );
 219                         return TitleArray::newFromResult( new FakeResultWrapper( [] ) );
 220                 }
 221
 222                 /** @var LocalRepo $repo */
 223                 $repo = $file->getRepo();
 224                 $dbr = $repo->getReplicaDB();
 225
 226                 $res = $dbr->select(
 227                         [ 'page', 'categorylinks' ],
 228                         [
 229                                 'page_title' => 'cl_to',
 230                                 'page_namespace' => NS_CATEGORY,
 231                         ],
 232                         [
 233                                 'page_namespace' => $title->getNamespace(),
 234                                 'page_title' => $title->getDBkey(),
 235                         ],
 236                         __METHOD__,
 237                         [],
 238                         [ 'categorylinks' => [ 'JOIN', 'page_id = cl_from' ] ]
 239                 );
 240
 241                 return TitleArray::newFromResult( $res );
 242         }
 243
 244         /**
 245          * @since 1.28
 246          * @return string
 247          */
 248         public function getWikiDisplayName() {
 249                 return $this->getFile()->getRepo()->getDisplayName();
 250         }
 251
 252         /**
 253          * @since 1.28
 254          * @return string
 255          */
 256         public function getSourceURL() {
 257                 return $this->getFile()->getDescriptionUrl();
 258         }
 259 }