MediaTransformOutput.php

Go to the documentation of this file.

<?php
 
use MediaWiki\MainConfigNames;
use MediaWiki\MediaWikiServices;
use MediaWiki\Status\Status;
use MediaWiki\Xml\Xml;
use Wikimedia\FileBackend\FileBackend;
use Wikimedia\FileBackend\HTTPFileStreamer;
 
abstract class MediaTransformOutput {
    public $responsiveUrls = [];
 
    protected $file;
 
    protected $width;
 
    protected $height;
 
    protected $url;
 
    protected $page;
 
    protected $path;
 
    protected $lang;
 
    protected $storagePath = false;
 
    public function getWidth() {
        return $this->width;
    }
 
    public function getHeight() {
        return $this->height;
    }
 
    public function getFile() {
        return $this->file;
    }
 
    public function getExtension() {
        return $this->path ? FileBackend::extensionFromPath( $this->path ) : false;
    }
 
    public function getUrl() {
        return $this->url;
    }
 
    public function getStoragePath() {
        return $this->storagePath;
    }
 
    public function setStoragePath( $storagePath ) {
        $this->storagePath = $storagePath;
        if ( $this->path === false ) {
            $this->path = $storagePath;
        }
    }
 
    abstract public function toHtml( $options = [] );
 
    public function isError() {
        return false;
    }
 
    public function hasFile() {
        // If TRANSFORM_LATER, $this->path will be false.
        // Note: a null path means "use the source file".
        return ( !$this->isError() && ( $this->path || $this->path === null ) );
    }
 
    public function fileIsSource() {
        return ( !$this->isError() && $this->path === null );
    }
 
    public function getLocalCopyPath() {
        if ( $this->isError() ) {
            return false;
        }
 
        if ( $this->path === null ) {
            return $this->file->getLocalRefPath(); // assume thumb was not scaled
        }
        if ( FileBackend::isStoragePath( $this->path ) ) {
            $be = $this->file->getRepo()->getBackend();
            // The temp file will be process cached by FileBackend
            $fsFile = $be->getLocalReference( [ 'src' => $this->path ] );
 
            return $fsFile ? $fsFile->getPath() : false;
        }
        return $this->path; // may return false
    }
 
    public function streamFileWithStatus( $headers = [] ) {
        if ( !$this->path ) {
            return Status::newFatal( 'backend-fail-stream', '<no path>' );
        }
 
        $repo = $this->file->getRepo();
 
        if ( $repo && FileBackend::isStoragePath( $this->path ) ) {
            return Status::wrap(
                $repo->getBackend()->streamFile(
                    [ 'src' => $this->path, 'headers' => $headers, ]
                )
            );
        } else {
            $streamer = new HTTPFileStreamer(
                $this->getLocalCopyPath(),
                $repo ? $repo->getBackend()->getStreamerOptions() : []
            );
 
            $success = $streamer->stream( $headers );
            return $success ? Status::newGood()
                : Status::newFatal( 'backend-fail-stream', $this->path );
        }
    }
 
    public function streamFile( $headers = [] ) {
        return $this->streamFileWithStatus( $headers )->isOK();
    }
 
    protected function linkWrap( $linkAttribs, $contents ) {
        if ( isset( $linkAttribs['href'] ) ) {
            return Xml::tags( 'a', $linkAttribs, $contents );
        }
        $parserEnableLegacyMediaDOM = MediaWikiServices::getInstance()
            ->getMainConfig()->get( MainConfigNames::ParserEnableLegacyMediaDOM );
        if ( $parserEnableLegacyMediaDOM ) {
            return $contents;
        }
        return Xml::tags( 'span', $linkAttribs ?: null, $contents );
    }
 
    public function getDescLinkAttribs( $title = null, $params = [] ) {
        if ( is_array( $params ) ) {
            $query = $params;
        } else {
            $query = [];
        }
        if ( $this->page && $this->page !== 1 ) {
            $query['page'] = $this->page;
        }
        if ( $this->lang ) {
            $query['lang'] = $this->lang;
        }
 
        if ( is_string( $params ) && $params !== '' ) {
            $query = $params . '&' . wfArrayToCgi( $query );
        }
 
        $attribs = [
            'href' => $this->file->getTitle()->getLocalURL( $query ),
        ];
 
        $parserEnableLegacyMediaDOM = MediaWikiServices::getInstance()
            ->getMainConfig()->get( MainConfigNames::ParserEnableLegacyMediaDOM );
        if ( $parserEnableLegacyMediaDOM ) {
            $attribs['class'] = 'image';
        } else {
            $attribs['class'] = 'mw-file-description';
        }
 
        if ( $title ) {
            $attribs['title'] = $title;
        }
 
        return $attribs;
    }
}