3 * Foreign file accessible through api.php requests.
5 * This program is free software; you can redistribute it and/or modify
6 * it under the terms of the GNU General Public License as published by
7 * the Free Software Foundation; either version 2 of the License, or
8 * (at your option) any later version.
10 * This program is distributed in the hope that it will be useful,
11 * but WITHOUT ANY WARRANTY; without even the implied warranty of
12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13 * GNU General Public License for more details.
15 * You should have received a copy of the GNU General Public License along
16 * with this program; if not, write to the Free Software Foundation, Inc.,
17 * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
18 * http://www.gnu.org/copyleft/gpl.html
21 * @ingroup FileAbstraction
24 use MediaWiki\MediaWikiServices
;
27 * Foreign file accessible through api.php requests.
28 * Very hacky and inefficient, do not use :D
30 * @ingroup FileAbstraction
32 class ForeignAPIFile
extends File
{
38 protected $repoClass = ForeignAPIRepo
::class;
41 * @param Title|string|bool $title
42 * @param ForeignApiRepo $repo
46 function __construct( $title, $repo, $info, $exists = false ) {
47 parent
::__construct( $title, $repo );
50 $this->mExists
= $exists;
52 $this->assertRepoDefined();
57 * @param ForeignApiRepo $repo
58 * @return ForeignAPIFile|null
60 static function newFromTitle( Title
$title, $repo ) {
61 $data = $repo->fetchImageQuery( [
62 'titles' => 'File:' . $title->getDBkey(),
63 'iiprop' => self
::getProps(),
64 'prop' => 'imageinfo',
65 'iimetadataversion' => MediaHandler
::getMetadataVersion(),
66 // extmetadata is language-dependant, accessing the current language here
67 // would be problematic, so we just get them all
68 'iiextmetadatamultilang' => 1,
71 $info = $repo->getImageInfo( $data );
74 $lastRedirect = isset( $data['query']['redirects'] )
75 ?
count( $data['query']['redirects'] ) - 1
77 if ( $lastRedirect >= 0 ) {
78 // @phan-suppress-next-line PhanTypeArraySuspiciousNullable
79 $newtitle = Title
::newFromText( $data['query']['redirects'][$lastRedirect]['to'] );
80 $img = new self( $newtitle, $repo, $info, true );
81 $img->redirectedFrom( $title->getDBkey() );
83 $img = new self( $title, $repo, $info, true );
93 * Get the property string for iiprop and aiprop
96 static function getProps() {
97 return 'timestamp|user|comment|url|size|sha1|metadata|mime|mediatype|extmetadata';
100 // Dummy functions...
105 public function exists() {
106 return $this->mExists
;
112 public function getPath() {
117 * @param array $params
119 * @return bool|MediaTransformOutput
121 function transform( $params, $flags = 0 ) {
122 if ( !$this->canRender() ) {
124 return parent
::transform( $params, $flags );
127 // Note, the this->canRender() check above implies
128 // that we have a handler, and it can do makeParamString.
129 $otherParams = $this->handler
->makeParamString( $params );
130 $width = $params['width'] ??
-1;
131 $height = $params['height'] ??
-1;
133 $thumbUrl = $this->repo
->getThumbUrlFromCache(
139 if ( $thumbUrl === false ) {
142 return $this->repo
->getThumbError(
151 return $this->handler
->getTransform( $this, 'bogus', $thumbUrl, $params );
154 // Info we can get from API...
160 public function getWidth( $page = 1 ) {
161 return isset( $this->mInfo
['width'] ) ?
intval( $this->mInfo
['width'] ) : 0;
168 public function getHeight( $page = 1 ) {
169 return isset( $this->mInfo
['height'] ) ?
intval( $this->mInfo
['height'] ) : 0;
173 * @return bool|null|string
175 public function getMetadata() {
176 if ( isset( $this->mInfo
['metadata'] ) ) {
177 return serialize( self
::parseMetadata( $this->mInfo
['metadata'] ) );
184 * @return array|null Extended metadata (see imageinfo API for format) or
187 public function getExtendedMetadata() {
188 return $this->mInfo
['extmetadata'] ??
null;
192 * @param mixed $metadata
195 public static function parseMetadata( $metadata ) {
196 if ( !is_array( $metadata ) ) {
200 foreach ( $metadata as $meta ) {
201 $ret[$meta['name']] = self
::parseMetadata( $meta['value'] );
208 * @return bool|int|null
210 public function getSize() {
211 return isset( $this->mInfo
['size'] ) ?
intval( $this->mInfo
['size'] ) : null;
215 * @return null|string
217 public function getUrl() {
218 return isset( $this->mInfo
['url'] ) ?
strval( $this->mInfo
['url'] ) : null;
222 * Get short description URL for a file based on the foreign API response,
223 * or if unavailable, the short URL is constructed from the foreign page ID.
225 * @return null|string
228 public function getDescriptionShortUrl() {
229 if ( isset( $this->mInfo
['descriptionshorturl'] ) ) {
230 return $this->mInfo
['descriptionshorturl'];
231 } elseif ( isset( $this->mInfo
['pageid'] ) ) {
232 $url = $this->repo
->makeUrl( [ 'curid' => $this->mInfo
['pageid'] ] );
233 if ( $url !== false ) {
241 * @param string $type
242 * @return int|null|string
244 public function getUser( $type = 'text' ) {
245 if ( $type == 'text' ) {
246 return isset( $this->mInfo
['user'] ) ?
strval( $this->mInfo
['user'] ) : null;
248 return 0; // What makes sense here, for a remote user?
253 * @param int $audience
254 * @param User|null $user
255 * @return null|string
257 public function getDescription( $audience = self
::FOR_PUBLIC
, User
$user = null ) {
258 return isset( $this->mInfo
['comment'] ) ?
strval( $this->mInfo
['comment'] ) : null;
262 * @return null|string
265 return isset( $this->mInfo
['sha1'] )
266 ? Wikimedia\base_convert
( strval( $this->mInfo
['sha1'] ), 16, 36, 31 )
271 * @return bool|string
273 function getTimestamp() {
274 return wfTimestamp( TS_MW
,
275 isset( $this->mInfo
['timestamp'] )
276 ?
strval( $this->mInfo
['timestamp'] )
284 function getMimeType() {
285 if ( !isset( $this->mInfo
['mime'] ) ) {
286 $magic = MediaWiki\MediaWikiServices
::getInstance()->getMimeAnalyzer();
287 $this->mInfo
['mime'] = $magic->guessTypesForExtension( $this->getExtension() );
290 return $this->mInfo
['mime'];
296 function getMediaType() {
297 if ( isset( $this->mInfo
['mediatype'] ) ) {
298 return $this->mInfo
['mediatype'];
300 $magic = MediaWiki\MediaWikiServices
::getInstance()->getMimeAnalyzer();
302 return $magic->getMediaType( null, $this->getMimeType() );
306 * @return bool|string
308 function getDescriptionUrl() {
309 return $this->mInfo
['descriptionurl'] ??
false;
313 * Only useful if we're locally caching thumbs anyway...
314 * @param string $suffix
315 * @return null|string
317 function getThumbPath( $suffix = '' ) {
318 if ( !$this->repo
->canCacheThumbs() ) {
322 $path = $this->repo
->getZonePath( 'thumb' ) . '/' . $this->getHashPath();
324 $path .= $suffix . '/';
332 function getThumbnails() {
333 $dir = $this->getThumbPath( $this->getName() );
334 $iter = $this->repo
->getBackend()->getFileList( [ 'dir' => $dir ] );
338 foreach ( $iter as $file ) {
346 function purgeCache( $options = [] ) {
347 $this->purgeThumbnails( $options );
348 $this->purgeDescriptionPage();
351 function purgeDescriptionPage() {
352 $services = MediaWikiServices
::getInstance();
353 $url = $this->repo
->getDescriptionRenderUrl(
354 $this->getName(), $services->getContentLanguage()->getCode() );
355 $key = $this->repo
->getLocalCacheKey( 'RemoteFileDescription', 'url', md5( $url ) );
357 $services->getMainWANObjectCache()->delete( $key );
361 * @param array $options
363 function purgeThumbnails( $options = [] ) {
364 $key = $this->repo
->getLocalCacheKey( 'ForeignAPIRepo', 'ThumbUrl', $this->getName() );
365 MediaWikiServices
::getInstance()->getMainWANObjectCache()->delete( $key );
367 $files = $this->getThumbnails();
368 // Give media handler a chance to filter the purge list
369 $handler = $this->getHandler();
371 $handler->filterThumbnailPurgeList( $files, $options );
374 $dir = $this->getThumbPath( $this->getName() );
376 foreach ( $files as $file ) {
377 $purgeList[] = "{$dir}{$file}";
380 # Delete the thumbnails
381 $this->repo
->quickPurgeBatch( $purgeList );
382 # Clear out the thumbnail directory if empty
383 $this->repo
->quickCleanDir( $dir );
387 * The thumbnail is created on the foreign server and fetched over internet
391 public function isTransformedLocally() {