WikiFilePage.php

Go to the documentation of this file.

<?php
class WikiFilePage extends WikiPage {
    protected $mFile = false;               // !< File object
    protected $mRepo = null;                // !<
    protected $mFileLoaded = false;         // !<
    protected $mDupes = null;               // !<
 
    public function __construct( $title ) {
        parent::__construct( $title );
        $this->mDupes = null;
        $this->mRepo = null;
    }
 
    public function getActionOverrides() {
        $overrides = parent::getActionOverrides();
        $overrides['revert'] = 'RevertFileAction';
        return $overrides;
    }
 
    public function setFile( $file ) {
        $this->mFile = $file;
        $this->mFileLoaded = true;
    }
 
    protected function loadFile() {
        if ( $this->mFileLoaded ) {
            return true;
        }
        $this->mFileLoaded = true;
 
        $this->mFile = wfFindFile( $this->mTitle );
        if ( !$this->mFile ) {
            $this->mFile = wfLocalFile( $this->mTitle ); // always a File
        }
        $this->mRepo = $this->mFile->getRepo();
        return true;
    }
 
    public function getRedirectTarget() {
        $this->loadFile();
        if ( $this->mFile->isLocal() ) {
            return parent::getRedirectTarget();
        }
        // Foreign image page
        $from = $this->mFile->getRedirected();
        $to = $this->mFile->getName();
        if ( $from == $to ) {
            return null;
        }
        $this->mRedirectTarget = Title::makeTitle( NS_FILE, $to );
        return $this->mRedirectTarget;
    }
 
    public function followRedirect() {
        $this->loadFile();
        if ( $this->mFile->isLocal() ) {
            return parent::followRedirect();
        }
        $from = $this->mFile->getRedirected();
        $to = $this->mFile->getName();
        if ( $from == $to ) {
            return false;
        }
        return Title::makeTitle( NS_FILE, $to );
    }
 
    public function isRedirect() {
        $this->loadFile();
        if ( $this->mFile->isLocal() ) {
            return parent::isRedirect();
        }
 
        return (bool)$this->mFile->getRedirected();
    }
 
    public function isLocal() {
        $this->loadFile();
        return $this->mFile->isLocal();
    }
 
    public function getFile() {
        $this->loadFile();
        return $this->mFile;
    }
 
    public function getDuplicates() {
        $this->loadFile();
        if ( !is_null( $this->mDupes ) ) {
            return $this->mDupes;
        }
        $hash = $this->mFile->getSha1();
        if ( !( $hash ) ) {
            $this->mDupes = array();
            return $this->mDupes;
        }
        $dupes = RepoGroup::singleton()->findBySha1( $hash );
        // Remove duplicates with self and non matching file sizes
        $self = $this->mFile->getRepoName() . ':' . $this->mFile->getName();
        $size = $this->mFile->getSize();
 
        foreach ( $dupes as $index => $file ) {
            $key = $file->getRepoName() . ':' . $file->getName();
            if ( $key == $self ) {
                unset( $dupes[$index] );
            }
            if ( $file->getSize() != $size ) {
                unset( $dupes[$index] );
            }
        }
        $this->mDupes = $dupes;
        return $this->mDupes;
    }
 
    public function doPurge() {
        $this->loadFile();
        if ( $this->mFile->exists() ) {
            wfDebug( 'ImagePage::doPurge purging ' . $this->mFile->getName() . "\n" );
            $update = new HTMLCacheUpdate( $this->mTitle, 'imagelinks' );
            $update->doUpdate();
            $this->mFile->upgradeRow();
            $this->mFile->purgeCache( array( 'forThumbRefresh' => true ) );
        } else {
            wfDebug( 'ImagePage::doPurge no image for ' . $this->mFile->getName() . "; limiting purge to cache only\n" );
            // even if the file supposedly doesn't exist, force any cached information
            // to be updated (in case the cached information is wrong)
            $this->mFile->purgeCache( array( 'forThumbRefresh' => true ) );
        }
        if ( $this->mRepo ) {
            // Purge redirect cache
            $this->mRepo->invalidateImageRedirect( $this->mTitle );
        }
        return parent::doPurge();
    }
 
    public function getForeignCategories() {
        $this->loadFile();
        $title = $this->mTitle;
        $file = $this->mFile;
 
        if ( ! $file instanceof LocalFile ) {
            wfDebug( __CLASS__ . '::' . __METHOD__ . " is not supported for this file\n" );
            return TitleArray::newFromResult( new FakeResultWrapper( array() ) );
        }
 
        $repo = $file->getRepo();
        $dbr = $repo->getSlaveDB();
 
        $res = $dbr->select(
            array( 'page', 'categorylinks' ),
            array(
                'page_title' => 'cl_to',
                'page_namespace' => NS_CATEGORY,
            ),
            array(
                'page_namespace' => $title->getNamespace(),
                'page_title' => $title->getDBkey(),
            ),
            __METHOD__,
            array(),
            array( 'categorylinks' => array( 'INNER JOIN', 'page_id = cl_from' ) )
        );
 
        return TitleArray::newFromResult( $res );
    }
}