MediaWiki
master
|
Foreign file from a reachable database in the same wiki farm. More...
Public Member Functions | |
deleteFile ( $reason, UserIdentity $user, $suppress=false) | |
getDescriptionShortUrl () | |
Get short description URL for a file based on the page ID. More... | |
getDescriptionText (Language $lang=null) | |
getDescriptionUrl () | |
getRepo () | |
move ( $target) | |
publish ( $srcPath, $flags=0, array $options=[]) | |
restore ( $versions=[], $unsuppress=false) | |
![]() | |
__construct ( $title, $repo) | |
Do not call this except from inside a repo class. More... | |
__destruct () | |
Clean up any dangling locks. More... | |
acquireFileLock ( $timeout=0) | |
Acquire an exclusive lock on the file, indicating an intention to write to the file backend. More... | |
deleteOldFile ( $archiveName, $reason, UserIdentity $user, $suppress=false) | |
Delete an old version of the file. More... | |
exists () | |
canRender inherited More... | |
getBitDepth () | |
@stable to override More... | |
getDescription ( $audience=self::FOR_PUBLIC, Authority $performer=null) | |
getDescriptionTouched () | |
getHeight ( $page=1) | |
Return the height of the image @stable to override. More... | |
getHistory ( $limit=null, $start=null, $end=null, $inc=true) | |
purgeDescription inherited More... | |
getMediaType () | |
Returns the type of the media in the file. More... | |
getMetadata () | |
Get handler-specific metadata as a serialized string. More... | |
getMetadataArray () | |
Get unserialized handler-specific metadata. More... | |
getMetadataForDb (IDatabase $db) | |
Serialize the metadata array for insertion into img_metadata, oi_metadata or fa_metadata. More... | |
getMetadataItems (array $itemNames) | |
Get multiple elements of the unserialized handler-specific metadata. More... | |
getMimeType () | |
Returns the MIME type of the file. More... | |
getSha1 () | |
getSize () | |
Returns the size of the image file, in bytes @stable to override. More... | |
getTimestamp () | |
getUpgraded () | |
getUploader (int $audience=self::FOR_PUBLIC, Authority $performer=null) | |
getWidth ( $page=1) | |
Return the width of the image @stable to override. More... | |
invalidateCache () | |
Purge the file object/metadata cache. More... | |
isCacheable () | |
isMissing () | |
splitMime inherited More... | |
load ( $flags=0) | |
Load file metadata from cache or DB, unless already loaded. More... | |
loadFromFile ( $path=null) | |
Load metadata from the file itself. More... | |
loadFromRow ( $row, $prefix='img_') | |
Load file metadata from a DB result row. More... | |
lock () | |
Start an atomic DB section and lock the image for update or increments a reference counter if the lock is already held. More... | |
maybeUpgradeRow () | |
Upgrade a row if it needs it. More... | |
nextHistoryLine () | |
Returns the history of this file, line by line. More... | |
prerenderThumbnails () | |
Prerenders a configurable set of thumbnails. More... | |
purgeCache ( $options=[]) | |
Delete all previously generated thumbnails, refresh metadata in memcached and purge the CDN. More... | |
purgeOldThumbnails ( $archiveName) | |
Delete cached transformed files for an archived version only. More... | |
purgeThumbnails ( $options=[]) | |
Delete cached transformed files for the current version only. More... | |
recordUpload3 (string $oldver, string $comment, string $pageText, Authority $performer, $props=false, $timestamp=false, $tags=[], bool $createNullRevision=true, bool $revert=false) | |
Record a file upload in the upload log and the image table (version 3) More... | |
releaseFileLock () | |
Release a lock acquired with acquireFileLock(). More... | |
resetHistory () | |
Reset the history pointer to the first element of the history. More... | |
unlock () | |
Decrement the lock reference count and end the atomic section if it reaches zero. More... | |
upgradeRow () | |
Fix assorted version-related problems with the image row by reloading it from the file. More... | |
upload ( $src, $comment, $pageText, $flags=0, $props=false, $timestamp=false, Authority $uploader=null, $tags=[], $createNullRevision=true, $revert=false) | |
getHashPath inherited More... | |
![]() | |
__get ( $name) | |
allowInlineDisplay () | |
Alias for canRender() More... | |
canAnimateThumbIfAppropriate () | |
Will the thumbnail be animated if one would expect it to be. More... | |
canRender () | |
Checks if the output of transform() for this file is likely to be valid. More... | |
convertMetadataVersion ( $metadata, $version) | |
get versioned metadata More... | |
createThumb ( $width, $height=-1) | |
Create a thumbnail of the image having the specified width/height. More... | |
formatMetadata ( $context=false) | |
generateAndSaveThumb ( $tmpFile, $transformParams, $flags) | |
Generates a thumbnail according to the given parameters and saves it to storage. More... | |
generateThumbName ( $name, $params) | |
Generate a thumbnail file name from a name and specified parameters. More... | |
getArchivePath ( $suffix=false) | |
Get the path of the archived file. More... | |
getArchiveRel ( $suffix=false) | |
Get the path of an archived file relative to the public zone root. More... | |
getArchiveThumbPath ( $archiveName, $suffix=false) | |
Get the path of an archived file's thumbs, or a particular thumb if $suffix is specified. More... | |
getArchiveThumbUrl ( $archiveName, $suffix=false) | |
Get the URL of the archived file's thumbs, or a particular thumb if $suffix is specified. More... | |
getArchiveUrl ( $suffix=false) | |
Get the URL of the archive directory, or a particular file if $suffix is specified. More... | |
getArchiveVirtualUrl ( $suffix=false) | |
Get the public zone virtual URL for an archived version source file. More... | |
getAvailableLanguages () | |
Gives a (possibly empty) list of IETF languages to render the file in. More... | |
getCanonicalUrl () | |
getCommonMetaArray () | |
Like getMetadata but returns a handler independent array of common values. More... | |
getContentHeaders () | |
getDefaultRenderLanguage () | |
In files that support multiple language, what is the default language to use if none specified. More... | |
getDimensionsString () | |
getDisplayWidthHeight ( $maxWidth, $maxHeight, $page=1) | |
Get the width and height to display image at. More... | |
getExtension () | |
Get the file extension, e.g. More... | |
getFilePageThumbUrl ( $url) | |
Append a version parameter to the end of a file URL Only to be used on File pages. More... | |
getFullUrl () | |
Return a fully-qualified URL to the file. More... | |
getHandler () | |
Get a MediaHandler instance for this file. More... | |
getHandlerState (string $key) | |
Get a value, or null if it does not exist. More... | |
getHashPath () | |
Get the filename hash component of the directory including trailing slash, e.g. More... | |
getLastError () | |
Get last thumbnailing error. More... | |
getLength () | |
Get the duration of a media file in seconds. More... | |
getLocalRefPath () | |
Get an FS copy or original of this file and return the path. More... | |
getLongDesc () | |
getMatchedLanguage ( $userPreferredLanguage) | |
Get the IETF language code from the available languages for this file that matches the language requested by the user. More... | |
getMetadataItem (string $itemName) | |
Get a specific element of the unserialized handler-specific metadata. More... | |
getName () | |
Return the name of this file. More... | |
getOriginalTitle () | |
Return the title used to find this file. More... | |
getPath () | |
Return the storage path to the file. More... | |
getRedirected () | |
getRel () | |
Get the path of the file relative to the public zone root. More... | |
getRepoName () | |
Returns the name of the repository. More... | |
getShortDesc () | |
getStorageKey () | |
Get the deletion archive key, "<sha1>.<ext>". More... | |
getThumbDisposition ( $thumbName, $dispositionType='inline') | |
getThumbnailBucket ( $desiredWidth, $page=1) | |
Return the smallest bucket from $wgThumbnailBuckets which is at least $wgThumbnailMinimumBucketDistance larger than $desiredWidth. More... | |
getThumbnailSource ( $params) | |
Returns the most appropriate source image for the thumbnail, given a target thumbnail size. More... | |
getThumbPath ( $suffix=false) | |
Get the path of the thumbnail directory, or a particular file if $suffix is specified. More... | |
getThumbRel ( $suffix=false) | |
Get the path, relative to the thumbnail zone root, of the thumbnail directory or a particular file if $suffix is specified. More... | |
getThumbUrl ( $suffix=false) | |
Get the URL of the thumbnail directory, or a particular file if $suffix is specified. More... | |
getThumbVirtualUrl ( $suffix=false) | |
Get the virtual URL for a thumbnail file or directory. More... | |
getTitle () | |
Return the associated title object. More... | |
getTranscodedPath ( $suffix=false) | |
Get the path of the transcoded directory, or a particular file if $suffix is specified. More... | |
getTranscodedUrl ( $suffix=false) | |
Get the URL of the transcoded directory, or a particular file if $suffix is specified. More... | |
getUnscaledThumb ( $handlerParams=[]) | |
Get a ThumbnailImage which is the same size as the source. More... | |
getUrl () | |
Return the URL of the file. More... | |
getUrlRel () | |
Get urlencoded path of the file relative to the public zone root. More... | |
getViewURL () | |
getVirtualUrl ( $suffix=false) | |
Get the public zone virtual URL for a current version source file. More... | |
getVisibility () | |
Return the deletion bitfield STUB. More... | |
iconThumb () | |
Get a ThumbnailImage representing a file type icon. More... | |
isDeleted ( $field) | |
Is this file a "deleted" file in a private archive? STUB. More... | |
isExpensiveToThumbnail () | |
True if creating thumbnails from the file is large or otherwise resource-intensive. More... | |
isLocal () | |
Returns true if the file comes from the local file repository. More... | |
isMultipage () | |
Returns 'true' if this file is a type which supports multiple pages, e.g. More... | |
isOld () | |
Returns true if the image is an old version STUB. More... | |
isSafeFile () | |
Determines if this media file is in a format that is unlikely to contain viruses or malicious content. More... | |
isTransformedLocally () | |
Whether the thumbnails created on the same server as this code is running. More... | |
isVectorized () | |
Return true if the file is vectorized. More... | |
isVisible () | |
Returns true if file exists in the repository and can be included in a page. More... | |
mustRender () | |
Return true if the file is of a type that can't be directly rendered by typical browsers and needs to be re-rasterized. More... | |
pageCount () | |
Returns the number of pages of a multipage document, or false for documents which aren't multipage documents. More... | |
purgeDescription () | |
Purge the file description page, but don't go after pages using the file. More... | |
purgeEverything () | |
Purge metadata and all affected pages when the file is created, deleted, or majorly updated. More... | |
redirectedFrom ( $from) | |
setHandlerState (string $key, $value) | |
Set a value. More... | |
thumbName ( $params, $flags=0) | |
Return the file name of a thumbnail with the specified parameters. More... | |
transform ( $params, $flags=0) | |
Transform a media file. More... | |
userCan ( $field, Authority $performer) | |
Determine if the current user is allowed to view a particular field of this file, if it's marked as deleted. More... | |
wasDeleted () | |
Was this file ever deleted from the wiki? More... | |
Additional Inherited Members | |
![]() | |
static | getQueryInfo (array $options=[]) |
Return the tables, fields, and join conditions to be selected to create a new localfile object. More... | |
static | newFromKey ( $sha1, $repo, $timestamp=false) |
Create a LocalFile from a SHA-1 key Do not call this except from inside a repo class. More... | |
static | newFromRow ( $row, $repo) |
Create a LocalFile from a title Do not call this except from inside a repo class. More... | |
static | newFromTitle ( $title, $repo, $unused=null) |
Create a LocalFile from a title Do not call this except from inside a repo class. More... | |
![]() | |
static | checkExtensionCompatibility (File $old, $new) |
Checks if file extensions are compatible. More... | |
static | compare (File $a, File $b) |
Callback for usort() to do file sorts by name. More... | |
static | normalizeExtension ( $extension) |
Normalize a file extension to the common form, making it lowercase and checking some synonyms, and ensure it's clean. More... | |
static | normalizeTitle ( $title, $exception=false) |
Given a string or Title object return either a valid Title object with namespace NS_FILE or null. More... | |
static | scaleHeight ( $srcWidth, $srcHeight, $dstWidth) |
Calculate the height of a thumbnail using the source and destination width. More... | |
static | splitMime (?string $mime) |
Split an internet media type into its two components; if not a two-part name, set the minor type to 'unknown'. More... | |
![]() | |
FileRepo LocalRepo ForeignAPIRepo false | $repo |
Some member variables can be lazy-initialised using __get(). More... | |
const | DELETE_SOURCE = 1 |
const | DELETED_COMMENT = 2 |
const | DELETED_FILE = 1 |
const | DELETED_RESTRICTED = 8 |
const | DELETED_USER = 4 |
const | FOR_PUBLIC = 1 |
const | FOR_THIS_USER = 2 |
const | RAW = 3 |
const | RENDER_FORCE = 2 |
Force rendering even if thumbnail already exist and using RENDER_NOW I.e. More... | |
const | RENDER_NOW = 1 |
Force rendering in the current process. More... | |
const | THUMB_FULL_NAME = 1 |
![]() | |
const | READ_NONE = -1 |
Constants for object loading bitfield flags (higher => higher QoS) More... | |
![]() | |
getCacheFields ( $prefix='img_') | |
Returns the list of object properties that are included as-is in the cache. More... | |
getCacheKey () | |
Get the memcached key for the main data for this file, or false if there is no access to the shared cache. More... | |
getLazyCacheFields ( $prefix='img_') | |
Returns the list of object properties that are included as-is in the cache, only when they're not too big, and are lazily loaded by self::loadExtraFromDB(). More... | |
getThumbnails ( $archiveName=false) | |
getTransformScript inherited More... | |
loadExtraFromDB () | |
Load lazy file metadata from the DB. More... | |
loadFromDB ( $flags=0) | |
Load file metadata from the DB. More... | |
loadMetadataFromDbFieldValue (IDatabase $db, $metadataBlob) | |
Unserialize a metadata blob which came from the database and store it in $this. More... | |
loadMetadataFromString ( $metadataString) | |
Unserialize a metadata string which came from some non-DB source, or is the return value of IDatabase::decodeBlob(). More... | |
publishTo ( $src, $dstRel, $flags=0, array $options=[]) | |
Move or copy a file to a specified location. More... | |
purgeThumbList ( $dir, $files) | |
Delete a list of thumbnails visible at urls. More... | |
readOnlyFatalStatus () | |
reserializeMetadata () | |
Write the metadata back to the database with the current serialization format. More... | |
setProps ( $info) | |
Set properties in this object to be equal to those given in the associative array $info. More... | |
unprefixRow ( $row, $prefix='img_') | |
![]() | |
assertRepoDefined () | |
Assert that $this->repo is set to a valid FileRepo instance. More... | |
assertTitleDefined () | |
Assert that $this->title is set to a Title. More... | |
generateBucketsIfNeeded ( $params, $flags=0) | |
Generates chained bucketed thumbnails if needed. More... | |
getBucketThumbName ( $bucket) | |
Returns the name of the thumb for a given bucket. More... | |
getBucketThumbPath ( $bucket) | |
Returns the repo path of the thumb for a given bucket. More... | |
getCanRender () | |
Accessor for __get() More... | |
getIsSafeFile () | |
Accessor for __get() More... | |
getIsSafeFileUncached () | |
Uncached accessor. More... | |
getRedirectedTitle () | |
getThumbnails () | |
Get all thumbnail names previously generated for this file STUB Overridden by LocalFile. More... | |
isHashed () | |
isTrustedFile () | |
Returns true if the file is flagged as trusted. More... | |
makeTransformTmpFile ( $thumbPath) | |
Creates a temp FS file with the same extension and the thumbnail. More... | |
migrateThumbFile ( $thumbName) | |
Hook into transform() to allow migration of thumbnail files STUB. More... | |
readOnlyError () | |
transformErrorOutput ( $thumbPath, $thumbUrl, $params, $flags) | |
Return either a MediaTransformError or placeholder thumbnail (if $wgIgnoreImageErrors) More... | |
![]() | |
int | $bits |
Returned by getimagesize (loadFromXxx) More... | |
bool | $dataLoaded = false |
Whether or not core data has been loaded from the database (loadFromXxx) More... | |
int | $deleted |
Bitfield akin to rev_deleted. More... | |
bool | $extraDataLoaded = false |
Whether or not lazy-loaded data has been loaded from the database. More... | |
bool | $fileExists |
Does the file exist on disk? (loadFromXxx) More... | |
int | $height |
Image height. More... | |
string | $media_type |
MEDIATYPE_xxx (bitmap, drawing, audio...) More... | |
array | $metadataArray = [] |
Unserialized metadata. More... | |
string[] | $metadataBlobs = [] |
Map of metadata item name to blob address. More... | |
string null | $metadataSerializationFormat |
One of the MDS_* constants, giving the format of the metadata as stored in the DB, or null if the data was not loaded from the DB. More... | |
string | $mime |
MIME type, determined by MimeAnalyzer::guessMimeType. More... | |
string | $repoClass = LocalRepo::class |
string | $sha1 |
SHA-1 base 36 content hash. More... | |
int | $size |
Size in bytes (loadFromXxx) More... | |
string[] | $unloadedMetadataBlobs = [] |
Map of metadata item name to blob address for items that exist but have not yet been loaded into $this->metadataArray. More... | |
int | $width |
Image width. More... | |
![]() | |
bool | $canRender |
Whether the output of transform() for this file is likely to be valid. More... | |
string | $extension |
File extension. More... | |
FSFile false | $fsFile |
False if undefined. More... | |
MediaHandler | $handler |
string null | $hashPath |
Relative path including trailing slash. More... | |
bool | $isSafeFile |
Whether this media file is in a format that is unlikely to contain viruses or malicious content. More... | |
string | $lastError |
Text of last error. More... | |
string null | $name |
The name of a file from its title object. More... | |
int false | $pageCount |
Number of pages of a multipage document, or false for documents which aren't multipage documents. More... | |
string | $path |
The storage path corresponding to one of the zones. More... | |
string | $redirected |
Main part of the title, with underscores (Title::getDBkey) More... | |
Title | $redirectedTitle |
Title | $redirectTitle |
string | $repoClass = FileRepo::class |
Required Repository class type. More... | |
Title string false | $title |
array | $tmpBucketedThumbCache = [] |
Cache of tmp filepaths pointing to generated bucket thumbnails, keyed by width. More... | |
string false | $transformScript |
URL of transformscript (for example thumb.php) More... | |
string | $url |
The URL corresponding to one of the four basic zones. More... | |
Foreign file from a reachable database in the same wiki farm.
Definition at line 31 of file ForeignDBFile.php.
ForeignDBFile::deleteFile | ( | $reason, | |
UserIdentity | $user, | ||
$suppress = false |
|||
) |
string | $reason | |
UserIdentity | $user | |
bool | $suppress |
MWException |
Reimplemented from LocalFile.
Definition at line 68 of file ForeignDBFile.php.
References File\readOnlyError().
ForeignDBFile::getDescriptionShortUrl | ( | ) |
ForeignDBFile::getDescriptionText | ( | Language | $lang = null | ) |
Language | null | $lang | Optional language to fetch description in. |
Reimplemented from LocalFile.
Definition at line 93 of file ForeignDBFile.php.
References $lang, $res, $wgLang, File\getName(), NS_FILE, and wfDebug().
ForeignDBFile::getDescriptionUrl | ( | ) |
Reimplemented from LocalFile.
Definition at line 84 of file ForeignDBFile.php.
References File\getDescriptionUrl().
ForeignDBFile::getRepo | ( | ) |
Reimplemented from LocalFile.
Definition at line 36 of file ForeignDBFile.php.
References File\$repo.
ForeignDBFile::move | ( | $target | ) |
Title | $target |
MWException |
Reimplemented from LocalFile.
Definition at line 77 of file ForeignDBFile.php.
References File\readOnlyError().
ForeignDBFile::publish | ( | $srcPath, | |
$flags = 0 , |
|||
array | $options = [] |
||
) |
string | $srcPath | |
int | $flags | |
array | $options |
MWException |
Reimplemented from LocalFile.
Definition at line 47 of file ForeignDBFile.php.
References File\readOnlyError().
ForeignDBFile::restore | ( | $versions = [] , |
|
$unsuppress = false |
|||
) |
int[] | $versions | |
bool | $unsuppress |
MWException |
Reimplemented from LocalFile.
Definition at line 57 of file ForeignDBFile.php.
References File\readOnlyError().