ForeignDBFile.php

Go to the documentation of this file.

<?php
use MediaWiki\MediaWikiServices;
use Wikimedia\Rdbms\DBUnexpectedError;
 
// @phan-file-suppress PhanTypeMissingReturn false positives
class ForeignDBFile extends LocalFile {
    static function newFromTitle( $title, $repo, $unused = null ) {
        return new self( $title, $repo );
    }
 
    static function newFromRow( $row, $repo ) {
        $title = Title::makeTitle( NS_FILE, $row->img_name );
        $file = new self( $title, $repo );
        $file->loadFromRow( $row );
 
        return $file;
    }
 
    function publish( $srcPath, $flags = 0, array $options = [] ) {
        $this->readOnlyError();
    }
 
    function recordUpload( $oldver, $desc, $license = '', $copyStatus = '', $source = '',
        $watch = false, $timestamp = false, User $user = null ) {
        $this->readOnlyError();
    }
 
    function restore( $versions = [], $unsuppress = false ) {
        $this->readOnlyError();
    }
 
    function delete( $reason, $suppress = false, $user = null ) {
        $this->readOnlyError();
    }
 
    function move( $target ) {
        $this->readOnlyError();
    }
 
    function getDescriptionUrl() {
        // Restore remote behavior
        return File::getDescriptionUrl();
    }
 
    function getDescriptionText( Language $lang = null ) {
        global $wgLang;
 
        if ( !$this->repo->fetchDescription ) {
            return false;
        }
 
        $lang = $lang ?? $wgLang;
        $renderUrl = $this->repo->getDescriptionRenderUrl( $this->getName(), $lang->getCode() );
        if ( !$renderUrl ) {
            return false;
        }
 
        $touched = $this->repo->getReplicaDB()->selectField(
            'page',
            'page_touched',
            [
                'page_namespace' => NS_FILE,
                'page_title' => $this->title->getDBkey()
            ]
        );
        if ( $touched === false ) {
            return false; // no description page
        }
 
        $cache = MediaWikiServices::getInstance()->getMainWANObjectCache();
        $fname = __METHOD__;
 
        return $cache->getWithSetCallback(
            $this->repo->getLocalCacheKey(
                'ForeignFileDescription',
                $lang->getCode(),
                md5( $this->getName() ),
                $touched
            ),
            $this->repo->descriptionCacheExpiry ?: $cache::TTL_UNCACHEABLE,
            function ( $oldValue, &$ttl, array &$setOpts ) use ( $renderUrl, $fname ) {
                wfDebug( "Fetching shared description from $renderUrl\n" );
                $res = Http::get( $renderUrl, [], $fname );
                if ( !$res ) {
                    $ttl = WANObjectCache::TTL_UNCACHEABLE;
                }
 
                return $res;
            }
        );
    }
 
    public function getDescriptionShortUrl() {
        $dbr = $this->repo->getReplicaDB();
        $pageId = $dbr->selectField(
            'page',
            'page_id',
            [
                'page_namespace' => NS_FILE,
                'page_title' => $this->title->getDBkey()
            ]
        );
 
        if ( $pageId !== false ) {
            $url = $this->repo->makeUrl( [ 'curid' => $pageId ] );
            if ( $url !== false ) {
                return $url;
            }
        }
        return null;
    }
 
}