UnregisteredLocalFile.php

Go to the documentation of this file.

<?php
class UnregisteredLocalFile extends File {
    protected $title;
 
    protected $path;
 
    protected $mime;
 
    protected $dims;
 
    protected $metadata;
 
    public $handler;
 
    public static function newFromPath( $path, $mime ) {
        return new static( false, false, $path, $mime );
    }
 
    public static function newFromTitle( $title, $repo ) {
        return new static( $title, $repo, false, false );
    }
 
    public function __construct( $title = false, $repo = false, $path = false, $mime = false ) {
        if ( !( $title && $repo ) && !$path ) {
            throw new MWException( __METHOD__ .
                ': not enough parameters, must specify title and repo, or a full path' );
        }
        if ( $title instanceof Title ) {
            $this->title = File::normalizeTitle( $title, 'exception' );
            $this->name = $repo->getNameFromTitle( $title );
        } else {
            $this->name = basename( $path );
            $this->title = File::normalizeTitle( $this->name, 'exception' );
        }
        $this->repo = $repo;
        if ( $path ) {
            $this->path = $path;
        } else {
            $this->assertRepoDefined();
            $this->path = $repo->getRootDirectory() . '/' .
                $repo->getHashPath( $this->name ) . $this->name;
        }
        if ( $mime ) {
            $this->mime = $mime;
        }
        $this->dims = [];
    }
 
    private function cachePageDimensions( $page = 1 ) {
        $page = (int)$page;
        if ( $page < 1 ) {
            $page = 1;
        }
 
        if ( !isset( $this->dims[$page] ) ) {
            if ( !$this->getHandler() ) {
                return false;
            }
            $this->dims[$page] = $this->handler->getPageDimensions( $this, $page );
        }
 
        return $this->dims[$page];
    }
 
    public function getWidth( $page = 1 ) {
        $dim = $this->cachePageDimensions( $page );
 
        return $dim['width'] ?? 0;
    }
 
    public function getHeight( $page = 1 ) {
        $dim = $this->cachePageDimensions( $page );
 
        return $dim['height'] ?? 0;
    }
 
    public function getMimeType() {
        if ( !isset( $this->mime ) ) {
            $magic = MediaWiki\MediaWikiServices::getInstance()->getMimeAnalyzer();
            $this->mime = $magic->guessMimeType( $this->getLocalRefPath() );
        }
 
        return $this->mime;
    }
 
    protected function getImageSize( $filename ) {
        if ( !$this->getHandler() ) {
            return false;
        }
 
        return $this->handler->getImageSize( $this, $this->getLocalRefPath() );
    }
 
    public function getBitDepth() {
        $gis = $this->getImageSize( $this->getLocalRefPath() );
 
        if ( !$gis || !isset( $gis['bits'] ) ) {
            return 0;
        }
        return $gis['bits'];
    }
 
    public function getMetadata() {
        if ( !isset( $this->metadata ) ) {
            if ( !$this->getHandler() ) {
                $this->metadata = false;
            } else {
                $this->metadata = $this->handler->getMetadata( $this, $this->getLocalRefPath() );
            }
        }
 
        return $this->metadata;
    }
 
    public function getURL() {
        if ( $this->repo ) {
            return $this->repo->getZoneUrl( 'public' ) . '/' .
                $this->repo->getHashPath( $this->name ) . rawurlencode( $this->name );
        } else {
            return false;
        }
    }
 
    public function getSize() {
        $this->assertRepoDefined();
 
        return $this->repo->getFileSize( $this->path );
    }
 
    public function setLocalReference( FSFile $fsFile ) {
        $this->fsFile = $fsFile;
    }
}