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 {
 
    public function getRepo() {
        return $this->repo;
    }
 
    public function publish( $srcPath, $flags = 0, array $options = [] ) {
        $this->readOnlyError();
    }
 
    public function recordUpload( $oldver, $desc, $license = '', $copyStatus = '', $source = '',
        $watch = false, $timestamp = false, User $user = null ) {
        wfDeprecated( __METHOD__, '1.35' );
        $this->readOnlyError();
    }
 
    public function restore( $versions = [], $unsuppress = false ) {
        $this->readOnlyError();
    }
 
    public function delete( $reason, $suppress = false, $user = null ) {
        wfDeprecated( __METHOD__, '1.35' );
        $this->readOnlyError();
    }
 
    public function deleteFile( $reason, User $user, $suppress = false ) {
        $this->readOnlyError();
    }
 
    public function move( $target ) {
        $this->readOnlyError();
    }
 
    public function getDescriptionUrl() {
        // Restore remote behavior
        return File::getDescriptionUrl();
    }
 
    public 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()
            ],
            __METHOD__
        );
        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" );
                $res = MediaWikiServices::getInstance()->getHttpRequestFactory()->
                    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()
            ],
            __METHOD__
        );
 
        if ( $pageId !== false ) {
            $url = $this->repo->makeUrl( [ 'curid' => $pageId ] );
            if ( $url !== false ) {
                return $url;
            }
        }
        return null;
    }
 
}