diff options
Diffstat (limited to 'www/wiki/includes/filerepo/file/ForeignDBFile.php')
| -rw-r--r-- | www/wiki/includes/filerepo/file/ForeignDBFile.php | 203 |
1 files changed, 203 insertions, 0 deletions
diff --git a/www/wiki/includes/filerepo/file/ForeignDBFile.php b/www/wiki/includes/filerepo/file/ForeignDBFile.php new file mode 100644 index 00000000..388e9503 --- /dev/null +++ b/www/wiki/includes/filerepo/file/ForeignDBFile.php @@ -0,0 +1,203 @@ +<?php +/** + * Foreign file with an accessible MediaWiki database. + * + * This program is free software; you can redistribute it and/or modify + * it under the terms of the GNU General Public License as published by + * the Free Software Foundation; either version 2 of the License, or + * (at your option) any later version. + * + * This program is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU General Public License for more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. + * http://www.gnu.org/copyleft/gpl.html + * + * @file + * @ingroup FileAbstraction + */ + +use Wikimedia\Rdbms\DBUnexpectedError; + +/** + * Foreign file with an accessible MediaWiki database + * + * @ingroup FileAbstraction + */ +class ForeignDBFile extends LocalFile { + /** + * @param Title $title + * @param FileRepo $repo + * @param null $unused + * @return ForeignDBFile + */ + static function newFromTitle( $title, $repo, $unused = null ) { + return new self( $title, $repo ); + } + + /** + * Create a ForeignDBFile from a title + * Do not call this except from inside a repo class. + * + * @param stdClass $row + * @param FileRepo $repo + * @return ForeignDBFile + */ + static function newFromRow( $row, $repo ) { + $title = Title::makeTitle( NS_FILE, $row->img_name ); + $file = new self( $title, $repo ); + $file->loadFromRow( $row ); + + return $file; + } + + /** + * @param string $srcPath + * @param int $flags + * @param array $options + * @return Status + * @throws MWException + */ + function publish( $srcPath, $flags = 0, array $options = [] ) { + $this->readOnlyError(); + } + + /** + * @param string $oldver + * @param string $desc + * @param string $license + * @param string $copyStatus + * @param string $source + * @param bool $watch + * @param bool|string $timestamp + * @param User|null $user User object or null to use $wgUser + * @return bool + * @throws MWException + */ + function recordUpload( $oldver, $desc, $license = '', $copyStatus = '', $source = '', + $watch = false, $timestamp = false, User $user = null ) { + $this->readOnlyError(); + } + + /** + * @param array $versions + * @param bool $unsuppress + * @return Status + * @throws MWException + */ + function restore( $versions = [], $unsuppress = false ) { + $this->readOnlyError(); + } + + /** + * @param string $reason + * @param bool $suppress + * @param User|null $user + * @return Status + * @throws MWException + */ + function delete( $reason, $suppress = false, $user = null ) { + $this->readOnlyError(); + } + + /** + * @param Title $target + * @return Status + * @throws MWException + */ + function move( $target ) { + $this->readOnlyError(); + } + + /** + * @return string + */ + function getDescriptionUrl() { + // Restore remote behavior + return File::getDescriptionUrl(); + } + + /** + * @param Language|null $lang Optional language to fetch description in. + * @return string|false + */ + function getDescriptionText( $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 = ObjectCache::getMainWANInstance(); + + return $cache->getWithSetCallback( + $this->repo->getLocalCacheKey( + 'RemoteFileDescription', + 'url', + $lang->getCode(), + $this->getName(), + $touched + ), + $this->repo->descriptionCacheExpiry ?: $cache::TTL_UNCACHEABLE, + function ( $oldValue, &$ttl, array &$setOpts ) use ( $renderUrl ) { + wfDebug( "Fetching shared description from $renderUrl\n" ); + $res = Http::get( $renderUrl, [], __METHOD__ ); + if ( !$res ) { + $ttl = WANObjectCache::TTL_UNCACHEABLE; + } + + return $res; + } + ); + } + + /** + * Get short description URL for a file based on the page ID. + * + * @return string + * @throws DBUnexpectedError + * @since 1.27 + */ + 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; + } + +} |