Base class for file repositories. More...

Inheritance diagram for FileRepo:

[legend]

Collaboration diagram for FileRepo:

[legend]

Public Member Functions
	__construct (array $info=null)

	canTransformVia404 ()
	Returns true if the repository can transform files via a 404 handler. More...

	checkRedirect (Title $title)
	Checks if there is a redirect named as $title. More...

	cleanDir ( $dir)
	Deletes a directory if empty. More...

	cleanupBatch (array $files, $flags=0)
	Deletes a batch of files. More...

	cleanupDeletedBatch (array $storageKeys)
	Delete files in the deleted directory if they are not referenced in the filearchive table. More...

	concatenate (array $srcPaths, $dstPath, $flags=0)
	Concatenate a list of temporary files into a target file location. More...

	delete ( $srcRel, $archiveRel)
	Move a file to the deletion archive. More...

	deleteBatch (array $sourceDestPairs)
	Move a group of files to the deletion archive. More...

	enumFiles ( $callback)
	Call a callback function for every public regular file in the repository. More...

	fileExists ( $file)
	Checks existence of a a file. More...

	fileExistsBatch (array $files)
	Checks existence of an array of files. More...

	findBySha1 ( $hash)
	Get an array or iterator of file objects for files that have a given SHA-1 content hash. More...

	findBySha1s (array $hashes)
	Get an array of arrays or iterators of file objects for files that have the given SHA-1 content hashes. More...

	findFile ( $title, $options=array())
	Find an instance of the named file created at the specified time Returns false if the file does not exist. More...

	findFileFromKey ( $sha1, $options=array())
	Find an instance of the file with this key, created at the specified time Returns false if the file does not exist. More...

	findFiles (array $items, $flags=0)
	Find many files at once. More...

	findFilesByPrefix ( $prefix, $limit)
	Return an array of files where the name starts with $prefix. More...

	freeTemp ( $virtualUrl)
	Remove a temporary file or mark it for garbage collection. More...

	getBackend ()
	Get the file backend instance. More...

	getDeletedHashPath ( $key)
	Get a relative path for a deletion archive key, e.g. More...

	getDescriptionRenderUrl ( $name, $lang=null)
	Get the URL of the content-only fragment of the description page. More...

	getDescriptionStylesheetUrl ()
	Get the URL of the stylesheet to apply to description pages. More...

	getDescriptionUrl ( $name)
	Get the URL of an image description page. More...

	getDisplayName ()
	Get the human-readable name of the repo. More...

	getErrorCleanupFunction ()
	Get a callback function to use for cleaning error message parameters. More...

	getFileProps ( $virtualUrl)
	Get properties of a file with a given virtual URL/storage path. More...

	getFileSha1 ( $virtualUrl)
	Get the sha1 (base 36) of a file with a given virtual URL/storage path. More...

	getFileSize ( $virtualUrl)
	Get the size of a file with a given virtual URL/storage path. More...

	getFileTimestamp ( $virtualUrl)
	Get the timestamp of a file with a given virtual URL/storage path. More...

	getHashLevels ()
	Get the number of hash directory levels. More...

	getHashPath ( $name)
	Get a relative path including trailing slash, e.g. More...

	getInfo ()
	Return information about the repository. More...

	getLocalCacheKey ()
	Get a key for this repo in the local cache domain. More...

	getLocalCopy ( $virtualUrl)
	Get a local FS copy of a file with a given virtual URL/storage path. More...

	getLocalReference ( $virtualUrl)
	Get a local FS file with a given virtual URL/storage path. More...

	getName ()
	Get the name of this repository, as specified by $info['name]' to the constructor. More...

	getNameFromTitle (Title $title)
	Get the name of a file from its title object. More...

	getReadOnlyReason ()
	Get an explanatory message if this repo is read-only. More...

	getRootDirectory ()
	Get the public zone root storage directory of the repository. More...

	getRootUrl ()
	Get the public root URL of the repository. More...

	getSharedCacheKey ()
	Get a key on the primary cache for this repository. More...

	getTempHashPath ( $suffix)
	Get a relative path including trailing slash, e.g. More...

	getTempRepo ()
	Get an temporary FileRepo associated with this repo. More...

	getThumbScriptUrl ()
	Get the URL of thumb.php. More...

	getUploadStash (User $user=null)
	Get an UploadStash associated with this repo. More...

	getVirtualUrl ( $suffix=false)
	Get a URL referring to this repository, with the private mwrepo protocol. More...

	getZoneHandlerUrl ( $zone)
	Get the thumb zone URL configured to be handled by scripts like thumb_handler.php. More...

	getZonePath ( $zone)
	Get the storage path corresponding to one of the zones. More...

	getZoneUrl ( $zone, $ext=null)
	Get the URL corresponding to one of the four basic zones. More...

	invalidateImageRedirect (Title $title)
	Invalidates image redirect cache related to that image Doesn't do anything for repositories that don't support image redirects. More...

	isLocal ()
	Returns true if this the local file repository. More...

	makeUrl ( $query='', $entry='index')
	Make an url to this repo. More...

	nameForThumb ( $name)
	Get the portion of the file that contains the origin file name. More...

	newFatal ( $message)
	Create a new fatal error. More...

	newFile ( $title, $time=false)
	Create a new File object from the local repository. More...

	newGood ( $value=null)
	Create a new good result. More...

	paranoidClean ( $param)
	Path disclosure protection function. More...

	passThrough ( $param)
	Path disclosure protection function. More...

	publish ( $srcPath, $dstRel, $archiveRel, $flags=0, array $options=array())
	Copy or move a file either from a storage path, virtual URL, or file system path, into this repository at the specified destination location. More...

	publishBatch (array $ntuples, $flags=0)
	Publish a batch of files. More...

	quickCleanDir ( $dir)
	Deletes a directory if empty. More...

	quickImport ( $src, $dst, $options=null)
	Import a file from the local file system into the repo. More...

	quickImportBatch (array $triples)
	Import a batch of files from the local file system into the repo. More...

	quickPurge ( $path)
	Purge a file from the repo. More...

	quickPurgeBatch (array $paths)
	Purge a batch of files from the repo. More...

	resolveVirtualUrl ( $url)
	Get the backend storage path corresponding to a virtual URL. More...

	store ( $srcPath, $dstZone, $dstRel, $flags=0)
	Store a file to a given destination. More...

	storeBatch (array $triplets, $flags=0)
	Store a batch of files. More...

	storeTemp ( $originalName, $srcPath)
	Pick a random name in the temp zone and store a file to it. More...

	streamFile ( $virtualUrl, $headers=array())
	Attempt to stream a file with the given virtual URL/storage path. More...

	validateFilename ( $filename)
	Determine if a relative path is valid, i.e. More...

Static Public Member Functions
static	isVirtualUrl ( $url)
	Determine if a string is an mwrepo:// URL. More...

Public Attributes
int	$descriptionCacheExpiry

bool	$fetchDescription
	Whether to fetch commons image description pages and display them on the local wiki *. More...

const	DELETE_SOURCE = 1

const	NAME_AND_TIME_ONLY = 1

const	OVERWRITE = 2

const	OVERWRITE_SAME = 4

const	SKIP_LOCKING = 8

Protected Member Functions
	assertWritableRepo ()
	Throw an exception if this repo is read-only by design. More...

	enumFilesInStorage ( $callback)
	Call a callback function for every public file in the repository. More...

	getZoneLocation ( $zone)
	The the storage container and base path of a zone. More...

	initDirectory ( $dir)
	Creates a directory with the appropriate zone permissions. More...

	initZones ( $doZones=array())
	Check if a single zone or list of zones is defined for usage. More...

	resolveToStoragePath ( $path)
	If a path is a virtual URL, resolve it to a storage path. More...

Static Protected Member Functions
static	getHashPathForLevel ( $name, $levels)

Protected Attributes
int	$abbrvThreshold
	File names over this size will use the short form of thumbnail names. More...

	$articleUrl

FileBackend	$backend

int	$deletedHashLevels
	The number of directory levels for hash-based division of deleted files *. More...

	$descBaseUrl

string	$favicon
	The URL of the repo's favicon, if any *. More...

	$fileFactory = array( 'UnregisteredLocalFile', 'newFromTitle' )
	Factory functions for creating new files Override these in the base class. More...

	$fileFactoryKey = false

int	$hashLevels
	The number of directory levels for hash-based division of files *. More...

bool	$initialCapital
	Equivalent to $wgCapitalLinks (or $wgCapitalLinkOverrides[NS_FILE], determines whether filenames implicitly start with a capital letter. More...

	$oldFileFactory = false

	$oldFileFactoryKey = false

string	$pathDisclosureProtection = 'simple'
	May be 'paranoid' to remove all parameters from error messages, 'none' to leave the paths in unchanged, or 'simple' to replace paths with placeholders. More...

	$scriptDirUrl

string	$scriptExtension
	Script extension of the MediaWiki installation, equivalent to $wgScriptExtension, e.g. More...

string	$thumbScriptUrl
	URL of thumb.php *. More...

	$thumbUrl

bool	$transformVia404
	Whether to skip media file transformation on parse and rely on a 404 handler instead. More...

bool	$url
	Public zone URL. More...

Array	$zones = array()
	Map of zones to config *. More...

Detailed Description

Base class for file repositories.

Definition at line 37 of file FileRepo.php.

Constructor & Destructor Documentation

◆ __construct()

FileRepo::__construct ( array $info = null )

Parameters

array | null $info

Exceptions

MWException

Reimplemented in FSRepo.

Definition at line 116 of file FileRepo.php.

References $hashLevels, array(), as, MWNamespace\isCapitalized(), name, NS_FILE, and FileBackendGroup\singleton().

Member Function Documentation

◆ assertWritableRepo()

FileRepo::assertWritableRepo ( )

protected

Throw an exception if this repo is read-only by design.

This does not and should not check getReadOnlyReason().

Returns: void

Exceptions

MWException

Reimplemented in ForeignAPIRepo, ForeignDBRepo, ForeignDBViaLBRepo, and NullRepo.

Definition at line 1837 of file FileRepo.php.

Referenced by cleanDir(), cleanupBatch(), cleanupDeletedBatch(), concatenate(), delete(), deleteBatch(), freeTemp(), publish(), publishBatch(), store(), storeBatch(), and storeTemp().

◆ canTransformVia404()

FileRepo::canTransformVia404 ( )

Returns true if the repository can transform files via a 404 handler.

Returns: bool

Definition at line 612 of file FileRepo.php.

References $transformVia404.

◆ checkRedirect()

FileRepo::checkRedirect ( Title $title )

Checks if there is a redirect named as $title.

If there is, return the title object. If not, return false. STUB

Parameters

Title $title Title of image

Returns: bool

Reimplemented in LocalRepo.

Definition at line 1703 of file FileRepo.php.

Referenced by findFile().

◆ cleanDir()

FileRepo::cleanDir ( $dir )

Deletes a directory if empty.

Parameters

string $dir Virtual URL (or storage path) of directory to clean

Returns: Status

Definition at line 1324 of file FileRepo.php.

References $dir, array(), assertWritableRepo(), newGood(), and resolveToStoragePath().

◆ cleanupBatch()

FileRepo::cleanupBatch	(	array	$files,
			$flags = `0`
	)

Deletes a batch of files.

Each file can be a (zone, rel) pair, virtual url, storage path. It will try to delete each file, but ignores any errors that may occur.

Parameters

array	$files	List of files to delete
int	$flags	Bitwise combination of the following flags: self::SKIP_LOCKING Skip any file locking when doing the deletions

Returns: FileRepoStatus

Definition at line 920 of file FileRepo.php.

References $files, $flags, $path, array(), as, assertWritableRepo(), getZonePath(), list, newGood(), and resolveToStoragePath().

◆ cleanupDeletedBatch()

FileRepo::cleanupDeletedBatch ( array $storageKeys )

Delete files in the deleted directory if they are not referenced in the filearchive table.

STUB

Reimplemented in LocalRepo.

Definition at line 1453 of file FileRepo.php.

References assertWritableRepo().

◆ concatenate()

FileRepo::concatenate	(	array	$srcPaths,
			$dstPath,
			$flags = `0`
	)

Concatenate a list of temporary files into a target file location.

Parameters

array	$srcPaths	Ordered list of source virtual URLs/storage paths
string	$dstPath	Target file system path
int	$flags	Bitwise combination of the following flags: self::DELETE_SOURCE Delete the source files

Returns: FileRepoStatus

Definition at line 1107 of file FileRepo.php.

References $flags, $params, $source, array(), as, assertWritableRepo(), newGood(), quickPurgeBatch(), and resolveToStoragePath().

◆ delete()

FileRepo::delete	(	$srcRel,
		$archiveRel
	)

Move a file to the deletion archive.

If no valid deletion archive exists, this may either delete the file or throw an exception, depending on the preference of the repository

Parameters

mixed	$srcRel	Relative path for the file to be deleted
mixed	$archiveRel	Relative path for the archive location. Relative to a private archive directory.

Returns: FileRepoStatus object

Definition at line 1372 of file FileRepo.php.

References array(), assertWritableRepo(), and deleteBatch().

◆ deleteBatch()

FileRepo::deleteBatch ( array $sourceDestPairs )

Move a group of files to the deletion archive.

If no valid deletion archive is configured, this may either delete the file or throw an exception, depending on the preference of the repository.

The overwrite policy is determined by the repository – currently LocalRepo assumes a naming scheme in the deleted zone based on content hash, as opposed to the public zone which is assumed to be unique.

Parameters

array $sourceDestPairs Array of source/destination pairs. Each element is a two-element array containing the source file path relative to the public root in the first element, and the archive file path relative to the deleted zone root in the second element.

Exceptions

MWException

Returns: FileRepoStatus

Definition at line 1395 of file FileRepo.php.

References $backend, array(), as, assertWritableRepo(), FileBackend\doOperations(), getZonePath(), initDirectory(), initZones(), list, newFatal(), newGood(), and validateFilename().

Referenced by delete().

◆ enumFiles()

FileRepo::enumFiles ( $callback )

Call a callback function for every public regular file in the repository.

This only acts on the current version of files, not any old versions. May use either the database or the filesystem.

Parameters

array | string $callback

Returns: void

Reimplemented in ForeignAPIRepo.

Definition at line 1591 of file FileRepo.php.

References enumFilesInStorage().

◆ enumFilesInStorage()

FileRepo::enumFilesInStorage ( $callback )

protected

Call a callback function for every public file in the repository.

May use either the database or the filesystem.

Parameters

array | string $callback

Returns: void

Definition at line 1602 of file FileRepo.php.

References $hashLevels, $name, $path, array(), as, and getZonePath().

Referenced by enumFiles().

◆ fileExists()

FileRepo::fileExists ( $file )

Checks existence of a a file.

Parameters

string $file Virtual URL (or storage path) of file to check

Returns: bool

Definition at line 1340 of file FileRepo.php.

References $file, array(), and fileExistsBatch().

Referenced by UploadStashFile\__construct(), publishBatch(), and PurgeChangedFiles\purgeFromArchiveTable().

◆ fileExistsBatch()

FileRepo::fileExistsBatch ( array $files )

Checks existence of an array of files.

Parameters

array $files Virtual URLs (or storage paths) of files to check

Returns: array|bool Either array of files and existence flags, or false

Reimplemented in ForeignAPIRepo.

Definition at line 1352 of file FileRepo.php.

References $file, $files, array(), as, and resolveToStoragePath().

Referenced by fileExists().

◆ findBySha1()

FileRepo::findBySha1 ( $hash )

Get an array or iterator of file objects for files that have a given SHA-1 content hash.

STUB

Parameters

string $hash SHA-1 hash

Returns: array

Reimplemented in LocalRepo, and ForeignAPIRepo.

Definition at line 553 of file FileRepo.php.

References array().

Referenced by findBySha1s().

◆ findBySha1s()

FileRepo::findBySha1s ( array $hashes )

Get an array of arrays or iterators of file objects for files that have the given SHA-1 content hashes.

Parameters

array $hashes An array of hashes

Returns: array An Array of arrays or iterators of file objects and the hash as key

Reimplemented in LocalRepo.

Definition at line 564 of file FileRepo.php.

References $files, $hash, $hashes, array(), as, and findBySha1().

◆ findFile()

FileRepo::findFile	(	$title,
		$options = `array()`
	)

Find an instance of the named file created at the specified time Returns false if the file does not exist.

Repositories not supporting version control should return false if the time is specified.

Parameters

Title \| string	$title	Title object or string
array	$options	Associative array of options: time: requested time for a specific file version, or false for the current version. An image object will be returned which was created at the specified time (which may be archived or current). ignoreRedirect: If true, do not follow file redirects private: If true, return restricted (deleted) files if the current user is allowed to view them. Otherwise, such files will not be found. If a User object, use that user instead of the current.

Returns: File|bool False on failure

Definition at line 411 of file FileRepo.php.

References $options, $time, $title, checkRedirect(), File\DELETED_FILE, newFile(), File\normalizeTitle(), and NS_FILE.

Referenced by findFiles().

◆ findFileFromKey()

FileRepo::findFileFromKey	(	$sha1,
		$options = `array()`
	)

Find an instance of the file with this key, created at the specified time Returns false if the file does not exist.

Repositories not supporting version control should return false if the time is specified.

Parameters

string	$sha1	Base 36 SHA-1 hash
array	$options	Option array, same as findFile().

Returns: File|bool False on failure

Definition at line 515 of file FileRepo.php.

References $options, $time, and File\DELETED_FILE.

◆ findFiles()

FileRepo::findFiles	(	array	$items,
			$flags = `0`
	)

Find many files at once.

Parameters

array $items An array of titles, or an array of findFile() options with the "title" option giving the title. Example:

$findItem = array( 'title' => $title, 'private' => true ); $findBatch = array( $findItem ); $repo->findFiles( $findBatch );

No title should appear in $items twice, as the result use titles as keys

Parameters

int

$flags

Supports:

FileRepo::NAME_AND_TIME_ONLY : return a (search title => (title,timestamp)) map. The search title uses the input titles; the other is the final post-redirect title. All titles are returned as string DB keys and the inner array is associative.

Returns: array Map of (file name => File objects) for matches

Reimplemented in LocalRepo.

Definition at line 478 of file FileRepo.php.

References $file, $flags, $options, $title, array(), as, findFile(), and File\normalizeTitle().

◆ findFilesByPrefix()

FileRepo::findFilesByPrefix	(	$prefix,
		$limit
	)

Return an array of files where the name starts with $prefix.

STUB

Parameters

string	$prefix	The prefix to search for
int	$limit	The maximum amount of files to return

Returns: array

Reimplemented in LocalRepo.

Definition at line 584 of file FileRepo.php.

References array().

◆ freeTemp()

FileRepo::freeTemp ( $virtualUrl )

Remove a temporary file or mark it for garbage collection.

Parameters

string $virtualUrl The virtual URL returned by FileRepo::storeTemp()

Returns: bool True on success, false on failure

Definition at line 1085 of file FileRepo.php.

References assertWritableRepo(), getVirtualUrl(), quickPurge(), and wfDebug().

◆ getBackend()

FileRepo::getBackend ( )

Get the file backend instance.

Use this function wisely.

Returns: FileBackend

Definition at line 190 of file FileRepo.php.

References $backend.

Referenced by UploadStashCleanup\doOperations(), ForeignAPIRepo\getThumbUrlFromCache(), and PurgeChangedFiles\purgeFromArchiveTable().

◆ getDeletedHashPath()

FileRepo::getDeletedHashPath ( $key )

Get a relative path for a deletion archive key, e.g.

s/z/a/ for sza251lrxrc1jad41h5mgilp8nysje52.jpg

Parameters

string $key

Exceptions

MWException

Returns: string

Definition at line 1465 of file FileRepo.php.

References $deletedHashLevels, and $path.

Referenced by LocalRepo\cleanupDeletedBatch(), and PurgeChangedFiles\getDeletedPath().

◆ getDescriptionRenderUrl()

FileRepo::getDescriptionRenderUrl	(	$name,
		$lang = `null`
	)

Get the URL of the content-only fragment of the description page.

For MediaWiki this means action=render. This should only be called by the repository's file class, since it may return invalid results. User code should use File::getDescriptionText().

Parameters

string	$name	Name of image to fetch
string	$lang	Language to fetch it in, if any.

Returns: string

Definition at line 771 of file FileRepo.php.

References $name, $query, getDescriptionUrl(), makeUrl(), wfAppendQuery(), and wfUrlencode().

◆ getDescriptionStylesheetUrl()

FileRepo::getDescriptionStylesheetUrl ( )

Get the URL of the stylesheet to apply to description pages.

Returns: string|bool False on failure

Definition at line 796 of file FileRepo.php.

References Skin\getDynamicStylesheetQuery(), makeUrl(), and wfArrayToCgi().

◆ getDescriptionUrl()

FileRepo::getDescriptionUrl ( $name )

Get the URL of an image description page.

May return false if it is unknown or not applicable. In general this should only be called by the File class, since it may return invalid results for certain kinds of repositories. Use File::getDescriptionUrl() in user code.

In particular, it uses the article paths as specified to the repository constructor, whereas local repositories use the local Title functions.

Parameters

string $name

Returns: string

Definition at line 735 of file FileRepo.php.

References $name, makeUrl(), and wfUrlencode().

Referenced by getDescriptionRenderUrl().

◆ getDisplayName()

FileRepo::getDisplayName ( )

Get the human-readable name of the repo.

Returns: string

Definition at line 1722 of file FileRepo.php.

References isLocal(), name, and wfMessageFallback().

Referenced by getInfo(), ForeignAPIRepo\getThumbError(), and ImagePage\printSharedImageText().

◆ getErrorCleanupFunction()

FileRepo::getErrorCleanupFunction ( )

Get a callback function to use for cleaning error message parameters.

Returns: array

Definition at line 1640 of file FileRepo.php.

References array().

◆ getFileProps()

FileRepo::getFileProps ( $virtualUrl )

Get properties of a file with a given virtual URL/storage path.

Properties should ultimately be obtained via FSFile::getProps().

Parameters

string $virtualUrl

Returns: Array

Reimplemented in ForeignAPIRepo.

Definition at line 1527 of file FileRepo.php.

References $path, array(), and resolveToStoragePath().

◆ getFileSha1()

FileRepo::getFileSha1 ( $virtualUrl )

Get the sha1 (base 36) of a file with a given virtual URL/storage path.

Parameters

string $virtualUrl

Returns: string|bool

Definition at line 1563 of file FileRepo.php.

References $path, array(), and resolveToStoragePath().

Referenced by PurgeChangedFiles\getDeletedPath().

◆ getFileSize()

FileRepo::getFileSize ( $virtualUrl )

Get the size of a file with a given virtual URL/storage path.

Parameters

string $virtualUrl

Returns: integer|bool False on failure

Definition at line 1551 of file FileRepo.php.

References $path, array(), and resolveToStoragePath().

◆ getFileTimestamp()

FileRepo::getFileTimestamp ( $virtualUrl )

Get the timestamp of a file with a given virtual URL/storage path.

Parameters

string $virtualUrl

Returns: string|bool False on failure

Definition at line 1539 of file FileRepo.php.

References $path, array(), and resolveToStoragePath().

◆ getHashLevels()

FileRepo::getHashLevels ( )

Get the number of hash directory levels.

Returns: int

Definition at line 693 of file FileRepo.php.

References $hashLevels.

◆ getHashPath()

FileRepo::getHashPath ( $name )

Get a relative path including trailing slash, e.g.

f/fa/ If the repo is not hashed, returns an empty string

Parameters

string $name Name of file

Returns: string

Definition at line 652 of file FileRepo.php.

References $name, and getHashPathForLevel().

Referenced by UnregisteredLocalFile\__construct(), ForeignAPIRepo\getThumbUrlFromCache(), and storeTemp().

◆ getHashPathForLevel()

static FileRepo::getHashPathForLevel	(	$name,
		$levels
	)

staticprotected

Parameters

string	$name
int	$levels

Returns: string

Definition at line 674 of file FileRepo.php.

References $hash, $name, and $path.

Referenced by getHashPath(), and getTempHashPath().

◆ getInfo()

FileRepo::getInfo ( )

Return information about the repository.

Returns: array

Since: 1.22

Reimplemented in LocalRepo, ForeignAPIRepo, ForeignDBRepo, and ForeignDBViaLBRepo.

Definition at line 1846 of file FileRepo.php.

References $ret, array(), as, getDisplayName(), getName(), getZoneUrl(), and isLocal().

Referenced by ForeignDBViaLBRepo\getInfo(), and ForeignDBRepo\getInfo().

◆ getLocalCacheKey()

FileRepo::getLocalCacheKey ( )

Get a key for this repo in the local cache domain.

These cache keys are not shared with remote instances of the repo. The parameters are the parts of the key, as for wfMemcKey().

Returns: string

Definition at line 1776 of file FileRepo.php.

References $args, and getName().

Referenced by LocalRepo\checkRedirect(), ForeignAPIRepo\getThumbUrlFromCache(), and ForeignAPIRepo\httpGetCached().

◆ getLocalCopy()

FileRepo::getLocalCopy ( $virtualUrl )

Get a local FS copy of a file with a given virtual URL/storage path.

Temporary files may be purged when the file object falls out of scope.

Parameters

string $virtualUrl

Returns: TempFSFile|null Returns null on failure

Definition at line 1500 of file FileRepo.php.

References $path, array(), and resolveToStoragePath().

◆ getLocalReference()

FileRepo::getLocalReference ( $virtualUrl )

Get a local FS file with a given virtual URL/storage path.

The file is either an original or a copy. It should not be changed. Temporary files may be purged when the file object falls out of scope.

Parameters

string $virtualUrl

Returns: FSFile|null Returns null on failure.

Definition at line 1514 of file FileRepo.php.

References $path, array(), and resolveToStoragePath().

◆ getName()

FileRepo::getName ( )

Get the name of this repository, as specified by $info['name]' to the constructor.

Returns: string

Definition at line 702 of file FileRepo.php.

References $name.

Referenced by getInfo(), getLocalCacheKey(), and isLocal().

◆ getNameFromTitle()

FileRepo::getNameFromTitle ( Title $title )

Get the name of a file from its title object.

Parameters

Title $title

Returns: string

Definition at line 622 of file FileRepo.php.

References $name, $title, $wgContLang, global, MWNamespace\isCapitalized(), and NS_FILE.

Referenced by UnregisteredLocalFile\__construct(), and LocalRepo\findFiles().

◆ getReadOnlyReason()

FileRepo::getReadOnlyReason ( )

Get an explanatory message if this repo is read-only.

This checks if an administrator disabled writes to the backend.

Returns: string|bool Returns false if the repo is not read-only

Definition at line 200 of file FileRepo.php.

◆ getRootDirectory()

FileRepo::getRootDirectory ( )

Get the public zone root storage directory of the repository.

Returns: string

Definition at line 641 of file FileRepo.php.

References getZonePath().

Referenced by UnregisteredLocalFile\__construct().

◆ getRootUrl()

FileRepo::getRootUrl ( )

Get the public root URL of the repository.

Deprecated:: since 1.20

Returns: string

Definition at line 594 of file FileRepo.php.

References getZoneUrl().

◆ getSharedCacheKey()

FileRepo::getSharedCacheKey ( )

Get a key on the primary cache for this repository.

Returns false if the repository's cache is not accessible at this site. The parameters are the parts of the key, as for wfMemcKey().

STUB

Returns: bool

Reimplemented in LocalRepo, ForeignDBRepo, and ForeignDBViaLBRepo.

Definition at line 1765 of file FileRepo.php.

◆ getTempHashPath()

FileRepo::getTempHashPath ( $suffix )

Get a relative path including trailing slash, e.g.

f/fa/ If the repo is not hashed, returns an empty string

Parameters

string $suffix Basename of file from FileRepo::storeTemp()

Returns: string

Definition at line 663 of file FileRepo.php.

References $name, and getHashPathForLevel().

◆ getTempRepo()

FileRepo::getTempRepo ( )

Get an temporary FileRepo associated with this repo.

Files will be created in the temp zone of this repo and thumbnails in a /temp subdirectory in thumb zone of this repo. It will have the same backend as this repo.

Returns: TempFileRepo

Reimplemented in TempFileRepo.

Definition at line 1791 of file FileRepo.php.

References array(), and getZoneUrl().

◆ getThumbScriptUrl()

FileRepo::getThumbScriptUrl ( )

Get the URL of thumb.php.

Returns: string

Definition at line 603 of file FileRepo.php.

References $thumbScriptUrl.

◆ getUploadStash()

FileRepo::getUploadStash ( User $user = null )

Get an UploadStash associated with this repo.

Parameters

User $user

Returns: UploadStash

Definition at line 1826 of file FileRepo.php.

References $user.

◆ getVirtualUrl()

FileRepo::getVirtualUrl ( $suffix = false )

Get a URL referring to this repository, with the private mwrepo protocol.

The suffix, if supplied, is considered to be unencoded, and will be URL-encoded before being returned.

Parameters

string | bool $suffix

Returns: string

Definition at line 241 of file FileRepo.php.

References $name, and $path.

Referenced by freeTemp(), and storeTemp().

◆ getZoneHandlerUrl()

FileRepo::getZoneHandlerUrl ( $zone )

Get the thumb zone URL configured to be handled by scripts like thumb_handler.php.

This is probably only useful for internal requests, such as from a fast frontend server to a slower backend server.

Large sites may use a different host name for uploads than for wikis. In any case, the wiki configuration is needed in order to use thumb.php. To avoid extracting the wiki ID from the URL path, one can configure thumb_handler.php to recognize a special path on the same host name as the wiki that is used for viewing thumbnails.

Parameters

string $zone one of: public, deleted, temp, thumb

Returns: string|bool String or false

Definition at line 297 of file FileRepo.php.

References array().

◆ getZoneLocation()

FileRepo::getZoneLocation ( $zone )

protected

The the storage container and base path of a zone.

Parameters

string $zone

Returns: array (container, base path) or (null, null)

Definition at line 341 of file FileRepo.php.

References array().

Referenced by getZonePath().

◆ getZonePath()

FileRepo::getZonePath ( $zone )

Get the storage path corresponding to one of the zones.

Parameters

string $zone

Returns: string|null Returns null if the zone is not defined

Reimplemented in ForeignAPIRepo.

Definition at line 355 of file FileRepo.php.

References getZoneLocation(), and list.

Referenced by UploadStashFile\__construct(), cleanupBatch(), LocalRepo\cleanupDeletedBatch(), deleteBatch(), enumFilesInStorage(), getRootDirectory(), initZones(), publishBatch(), resolveVirtualUrl(), and storeBatch().

◆ getZoneUrl()

FileRepo::getZoneUrl	(	$zone,
		$ext = `null`
	)

Get the URL corresponding to one of the four basic zones.

Parameters

string	$zone	One of: public, deleted, temp, thumb
string \| null	$ext	Optional file extension

Returns: string|bool

Reimplemented in ForeignAPIRepo.

Definition at line 257 of file FileRepo.php.

References $ext, $thumbUrl, $url, and array().

Referenced by getInfo(), getRootUrl(), and getTempRepo().

◆ initDirectory()

FileRepo::initDirectory ( $dir )

protected

Creates a directory with the appropriate zone permissions.

Callers are responsible for doing read-only and "writable repo" checks.

Parameters

string $dir Virtual URL (or storage path) of directory to clean

Returns: Status

Definition at line 1304 of file FileRepo.php.

References $dir, $params, $path, array(), list, resolveToStoragePath(), and FileBackend\splitStoragePath().

Referenced by deleteBatch(), publishBatch(), quickImportBatch(), and storeBatch().

◆ initZones()

FileRepo::initZones ( $doZones = array() )

protected

Check if a single zone or list of zones is defined for usage.

Parameters

array $doZones Only do a particular zones

Exceptions

MWException

Returns: Status

Definition at line 211 of file FileRepo.php.

References array(), as, getZonePath(), and newGood().

Referenced by deleteBatch(), and publishBatch().

◆ invalidateImageRedirect()

FileRepo::invalidateImageRedirect ( Title $title )

Invalidates image redirect cache related to that image Doesn't do anything for repositories that don't support image redirects.

STUB

Parameters

Title $title Title of image

Reimplemented in LocalRepo.

Definition at line 1714 of file FileRepo.php.

◆ isLocal()

FileRepo::isLocal ( )

Returns true if this the local file repository.

Returns: bool

Definition at line 1753 of file FileRepo.php.

References getName().

Referenced by getDisplayName(), and getInfo().

◆ isVirtualUrl()

static FileRepo::isVirtualUrl ( $url )

static

Determine if a string is an mwrepo:// URL.

Parameters

string $url

Returns: bool

Definition at line 229 of file FileRepo.php.

References $url.

Referenced by UploadStashFile\__construct(), RepoGroup\getFileProps(), and resolveToStoragePath().

◆ makeUrl()

FileRepo::makeUrl	(	$query = `''`,
		$entry = `'index'`
	)

Make an url to this repo.

Parameters

string	$query	Query string to append
string	$entry	Entry point; defaults to index

Returns: string|bool False on failure

Definition at line 713 of file FileRepo.php.

References $ext, $query, and wfAppendQuery().

Referenced by getDescriptionRenderUrl(), getDescriptionStylesheetUrl(), getDescriptionUrl(), and ForeignAPIRepo\httpGetCached().

◆ nameForThumb()

FileRepo::nameForThumb ( $name )

Get the portion of the file that contains the origin file name.

If that name is too long, then the name "thumbnail.<ext>" will be given.

Parameters

$name string

Returns: string

Definition at line 1739 of file FileRepo.php.

References $ext, $name, and FileBackend\extensionFromPath().

◆ newFatal()

FileRepo::newFatal ( $message )

Create a new fatal error.

Parameters

$message

Returns: FileRepoStatus

Definition at line 1678 of file FileRepo.php.

References $params, and array().

Referenced by deleteBatch(), publishBatch(), and storeBatch().

◆ newFile()

FileRepo::newFile	(	$title,
		$time = `false`
	)

Create a new File object from the local repository.

Parameters

Title \| string	$title	Title object or string
bool \| string	$time	Time at which the image was uploaded. If this is specified, the returned object will be an instance of the repository's old file class instead of a current file. Repositories not supporting version control should return false if this parameter is set.

Returns: File|null A File, or null if passed an invalid Title

Reimplemented in ForeignAPIRepo.

Definition at line 379 of file FileRepo.php.

References $time, $title, and File\normalizeTitle().

Referenced by findFile(), and LocalRepo\findFiles().

◆ newGood()

FileRepo::newGood ( $value = null )

Create a new good result.

Parameters

null | string $value

Returns: FileRepoStatus

Definition at line 1691 of file FileRepo.php.

References $value, and FileRepoStatus\newGood().

Referenced by cleanDir(), cleanupBatch(), LocalRepo\cleanupDeletedBatch(), concatenate(), deleteBatch(), initZones(), publishBatch(), quickCleanDir(), quickImportBatch(), quickPurgeBatch(), and storeBatch().

◆ paranoidClean()

FileRepo::paranoidClean ( $param )

Path disclosure protection function.

Parameters

string $param

Returns: string

Definition at line 1658 of file FileRepo.php.

◆ passThrough()

FileRepo::passThrough ( $param )

Path disclosure protection function.

Parameters

string $param

Returns: string

Definition at line 1668 of file FileRepo.php.

◆ publish()

FileRepo::publish	(		$srcPath,
			$dstRel,
			$archiveRel,
			$flags = `0`,
		array	$options = `array()`
	)

Copy or move a file either from a storage path, virtual URL, or file system path, into this repository at the specified destination location.

Returns a FileRepoStatus object. On success, the value contains "new" or "archived", to indicate whether the file was new with that name.

Options to $options include:

headers : name/value map of HTTP headers to use in response to GET/HEAD requests

Parameters

string	$srcPath	The source file system path, storage path, or URL
string	$dstRel	The destination relative path
string	$archiveRel	The relative path where the existing file is to be archived, if there is one. Relative to the public zone root.
int	$flags	Bitfield, may be FileRepo::DELETE_SOURCE to indicate that the source file should be deleted if possible
array	$options	Optional additional parameters

Returns: FileRepoStatus

Definition at line 1156 of file FileRepo.php.

References $flags, $options, array(), assertWritableRepo(), and publishBatch().

◆ publishBatch()

FileRepo::publishBatch	(	array	$ntuples,
			$flags = `0`
	)

Publish a batch of files.

Parameters

array	$ntuples	(source, dest, archive) triplets or (source, dest, archive, options) 4-tuples as per publish().
int	$flags	Bitfield, may be FileRepo::DELETE_SOURCE to indicate that the source files should be deleted if possible

Exceptions

MWException

Returns: FileRepoStatus

Definition at line 1185 of file FileRepo.php.

References $backend, $file, $flags, $options, array(), as, assertWritableRepo(), FileBackend\doOperations(), fileExists(), getZonePath(), initDirectory(), initZones(), FileBackend\isStoragePath(), list, newFatal(), newGood(), resolveToStoragePath(), validateFilename(), wfRestoreWarnings(), and wfSuppressWarnings().

Referenced by publish().

◆ quickCleanDir()

FileRepo::quickCleanDir ( $dir )

Deletes a directory if empty.

This function can be used to write to otherwise read-only foreign repos.

Parameters

string $dir Virtual URL (or storage path) of directory to clean

Returns: Status

Definition at line 983 of file FileRepo.php.

References $dir, array(), newGood(), and resolveToStoragePath().

◆ quickImport()

FileRepo::quickImport	(	$src,
		$dst,
		$options = `null`
	)

final

Import a file from the local file system into the repo.

This does no locking nor journaling and overrides existing files. This function can be used to write to otherwise read-only foreign repos. This is intended for copying generated thumbnails into the repo.

Parameters

string	$src	Source file system path, storage path, or virtual URL
string	$dst	Virtual URL or storage path
Array \| string \| null	$options	An array consisting of a key named headers listing extra headers. If a string, taken as content-disposition header. (Support for array of options new in 1.23)

Returns: FileRepoStatus

Definition at line 960 of file FileRepo.php.

References $options, array(), and quickImportBatch().

Referenced by storeTemp().

◆ quickImportBatch()

FileRepo::quickImportBatch ( array $triples )

Import a batch of files from the local file system into the repo.

This does no locking nor journaling and overrides existing files. This function can be used to write to otherwise read-only foreign repos. This is intended for copying generated thumbnails into the repo.

All path parameters may be a file system path, storage path, or virtual URL. When "headers" are given they are used as HTTP headers if supported.

Parameters

array $triples List of (source path, destination path, disposition)

Returns: FileRepoStatus

Definition at line 1003 of file FileRepo.php.

References array(), as, initDirectory(), FileBackend\isStoragePath(), list, newGood(), and resolveToStoragePath().

Referenced by quickImport().

◆ quickPurge()

FileRepo::quickPurge ( $path )

final

Purge a file from the repo.

This does no locking nor journaling. This function can be used to write to otherwise read-only foreign repos. This is intended for purging thumbnails.

Parameters

string $path Virtual URL or storage path

Returns: FileRepoStatus

Definition at line 972 of file FileRepo.php.

References $path, array(), and quickPurgeBatch().

Referenced by freeTemp().

◆ quickPurgeBatch()

FileRepo::quickPurgeBatch ( array $paths )

Purge a batch of files from the repo.

This function can be used to write to otherwise read-only foreign repos. This does no locking nor journaling and is intended for purging thumbnails.

Parameters

array $paths List of virtual URLs or storage paths

Returns: FileRepoStatus

Definition at line 1040 of file FileRepo.php.

References $path, array(), as, newGood(), and resolveToStoragePath().

Referenced by concatenate(), and quickPurge().

◆ resolveToStoragePath()

FileRepo::resolveToStoragePath ( $path )

protected

If a path is a virtual URL, resolve it to a storage path.

Otherwise, just return the path as it is.

Parameters

string $path

Returns: string

Exceptions

MWException

Definition at line 1485 of file FileRepo.php.

References $path, isVirtualUrl(), and resolveVirtualUrl().

Referenced by cleanDir(), cleanupBatch(), concatenate(), fileExistsBatch(), getFileProps(), getFileSha1(), getFileSize(), getFileTimestamp(), getLocalCopy(), getLocalReference(), initDirectory(), publishBatch(), quickCleanDir(), quickImportBatch(), quickPurgeBatch(), storeBatch(), and streamFile().

◆ resolveVirtualUrl()

FileRepo::resolveVirtualUrl ( $url )

Get the backend storage path corresponding to a virtual URL.

Use this function wisely.

Parameters

string $url

Exceptions

MWException

Returns: string

Definition at line 315 of file FileRepo.php.

References $url, getZonePath(), list, and name.

Referenced by UploadStashFile\__construct(), and resolveToStoragePath().

◆ store()

FileRepo::store	(	$srcPath,
		$dstZone,
		$dstRel,
		$flags = `0`
	)

Store a file to a given destination.

Parameters

string	$srcPath	Source file system path, storage path, or virtual URL
string	$dstZone	Destination zone
string	$dstRel	Destination relative path
int	$flags	Bitwise combination of the following flags: self::DELETE_SOURCE Delete the source file after upload self::OVERWRITE Overwrite an existing destination file instead of failing self::OVERWRITE_SAME Overwrite the file if the destination exists and has the same contents as the source self::SKIP_LOCKING Skip any file locking when doing the store

Returns: FileRepoStatus

Definition at line 819 of file FileRepo.php.

References $flags, array(), assertWritableRepo(), and storeBatch().

◆ storeBatch()

FileRepo::storeBatch	(	array	$triplets,
			$flags = `0`
	)

Store a batch of files.

Parameters

array	$triplets	(src, dest zone, dest rel) triplets as per store()
int	$flags	Bitwise combination of the following flags: self::DELETE_SOURCE Delete the source file after upload self::OVERWRITE Overwrite an existing destination file instead of failing self::OVERWRITE_SAME Overwrite the file if the destination exists and has the same contents as the source self::SKIP_LOCKING Skip any file locking when doing the store

Exceptions

MWException

Returns: FileRepoStatus

Definition at line 843 of file FileRepo.php.

References $backend, $file, $flags, array(), as, assertWritableRepo(), DELETE_SOURCE, FileBackend\doOperations(), getZonePath(), initDirectory(), FileBackend\isStoragePath(), list, newFatal(), newGood(), resolveToStoragePath(), validateFilename(), wfDebug(), wfRestoreWarnings(), and wfSuppressWarnings().

Referenced by store().

◆ storeTemp()

FileRepo::storeTemp	(	$originalName,
		$srcPath
	)

Pick a random name in the temp zone and store a file to it.

Returns a FileRepoStatus object with the file Virtual URL in the value, file can later be disposed using FileRepo::freeTemp().

Parameters

string	$originalName	the base name of the file as specified by the user. The file extension will be maintained.
string	$srcPath	The current location of the file.

Returns: FileRepoStatus Object with the URL in the value.

Definition at line 1065 of file FileRepo.php.

References assertWritableRepo(), getHashPath(), MWTimestamp\getInstance(), getVirtualUrl(), and quickImport().

◆ streamFile()

FileRepo::streamFile	(	$virtualUrl,
		$headers = `array()`
	)

Attempt to stream a file with the given virtual URL/storage path.

Parameters

string	$virtualUrl
array	$headers	Additional HTTP headers to send on success

Returns: bool Success

Definition at line 1576 of file FileRepo.php.

References $params, $path, array(), and resolveToStoragePath().

◆ validateFilename()

FileRepo::validateFilename ( $filename )

Determine if a relative path is valid, i.e.

not blank or involving directory traveral

Parameters

$filename string

Returns: bool

Definition at line 1627 of file FileRepo.php.

References FileBackend\isPathTraversalFree().

Referenced by UploadStashFile\__construct(), deleteBatch(), ForeignAPIRepo\getThumbUrlFromCache(), publishBatch(), and storeBatch().

Member Data Documentation

◆ $abbrvThreshold

int FileRepo::$abbrvThreshold

protected

File names over this size will use the short form of thumbnail names.

Short thumbnail names only have the width, parameters, and the extension.

Definition at line 99 of file FileRepo.php.

◆ $articleUrl

FileRepo::$articleUrl

protected

Definition at line 73 of file FileRepo.php.

◆ $backend

FileBackend FileRepo::$backend

protected

Definition at line 50 of file FileRepo.php.

Referenced by FSRepo\__construct(), LocalRepo\cleanupDeletedBatch(), deleteBatch(), getBackend(), ForeignAPIRepo\getThumbUrlFromCache(), publishBatch(), and storeBatch().

◆ $deletedHashLevels

int FileRepo::$deletedHashLevels

protected

The number of directory levels for hash-based division of deleted files *.

Definition at line 94 of file FileRepo.php.

Referenced by getDeletedHashPath().

◆ $descBaseUrl

FileRepo::$descBaseUrl

protected

Definition at line 62 of file FileRepo.php.

◆ $descriptionCacheExpiry

int FileRepo::$descriptionCacheExpiry

Definition at line 48 of file FileRepo.php.

◆ $favicon

string FileRepo::$favicon

protected

The URL of the repo's favicon, if any *.

Definition at line 101 of file FileRepo.php.

◆ $fetchDescription

bool FileRepo::$fetchDescription

Whether to fetch commons image description pages and display them on the local wiki *.

Definition at line 46 of file FileRepo.php.

◆ $fileFactory

FileRepo::$fileFactory = array( 'UnregisteredLocalFile', 'newFromTitle' )

protected

Factory functions for creating new files Override these in the base class.

Definition at line 107 of file FileRepo.php.

◆ $fileFactoryKey

FileRepo::$fileFactoryKey = false

protected

Definition at line 109 of file FileRepo.php.

◆ $hashLevels

int FileRepo::$hashLevels

protected

The number of directory levels for hash-based division of files *.

Definition at line 92 of file FileRepo.php.

Referenced by __construct(), enumFilesInStorage(), and getHashLevels().

◆ $initialCapital

bool FileRepo::$initialCapital

protected

Equivalent to $wgCapitalLinks (or $wgCapitalLinkOverrides[NS_FILE], determines whether filenames implicitly start with a capital letter.

The current implementation may give incorrect description page links when the local $wgCapitalLinks and initialCapital are mismatched.

Definition at line 79 of file FileRepo.php.

◆ $oldFileFactory

FileRepo::$oldFileFactory = false

protected

Definition at line 108 of file FileRepo.php.

◆ $oldFileFactoryKey

FileRepo::$oldFileFactoryKey = false

protected

Definition at line 110 of file FileRepo.php.

◆ $pathDisclosureProtection

string FileRepo::$pathDisclosureProtection = 'simple'

protected

May be 'paranoid' to remove all parameters from error messages, 'none' to leave the paths in unchanged, or 'simple' to replace paths with placeholders.

Default for LocalRepo is 'simple'.

Definition at line 85 of file FileRepo.php.

◆ $scriptDirUrl

FileRepo::$scriptDirUrl

protected

Definition at line 67 of file FileRepo.php.

◆ $scriptExtension

string FileRepo::$scriptExtension

protected

Script extension of the MediaWiki installation, equivalent to $wgScriptExtension, e.g.

.php5 defaults to .php *

Definition at line 70 of file FileRepo.php.

◆ $thumbScriptUrl

string FileRepo::$thumbScriptUrl

protected

URL of thumb.php *.

Definition at line 54 of file FileRepo.php.

Referenced by getThumbScriptUrl().

◆ $thumbUrl

FileRepo::$thumbUrl

protected

Definition at line 90 of file FileRepo.php.

Referenced by getZoneUrl(), and ForeignAPIRepo\getZoneUrl().

◆ $transformVia404

bool FileRepo::$transformVia404

protected

Whether to skip media file transformation on parse and rely on a 404 handler instead.

Definition at line 57 of file FileRepo.php.

Referenced by canTransformVia404().

◆ $url

bool FileRepo::$url

protected

Public zone URL.

Definition at line 87 of file FileRepo.php.

Referenced by getZoneUrl(), ForeignAPIRepo\getZoneUrl(), ForeignAPIRepo\httpGet(), ForeignAPIRepo\httpGetCached(), isVirtualUrl(), and resolveVirtualUrl().

◆ $zones

Array FileRepo::$zones = array()

protected

Map of zones to config *.

Definition at line 52 of file FileRepo.php.

◆ DELETE_SOURCE

const FileRepo::DELETE_SOURCE = 1

Definition at line 38 of file FileRepo.php.

Referenced by UploadFromChunks\concatenateChunks(), LocalFile\publishTo(), storeBatch(), and OldLocalFile\uploadOld().

◆ NAME_AND_TIME_ONLY

const FileRepo::NAME_AND_TIME_ONLY = 1

Definition at line 43 of file FileRepo.php.

Referenced by LocalRepo\findFiles().

◆ OVERWRITE

const FileRepo::OVERWRITE = 2

Definition at line 39 of file FileRepo.php.

Referenced by StoreBatchTest\storecohort().

◆ OVERWRITE_SAME

const FileRepo::OVERWRITE_SAME = 4

Definition at line 40 of file FileRepo.php.

Referenced by RevDel_FileList\doPreCommitUpdates(), LocalFileRestoreBatch\execute(), LocalFileMoveBatch\execute(), and StoreBatchTest\storecohort().

◆ SKIP_LOCKING

const FileRepo::SKIP_LOCKING = 8

Definition at line 41 of file FileRepo.php.

The documentation for this class was generated from the following file:

includes/filerepo/FileRepo.php

Public Member Functions

Static Public Member Functions

Public Attributes

Protected Member Functions

Static Protected Member Functions

Protected Attributes

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ assertWritableRepo()

◆ canTransformVia404()

◆ checkRedirect()

◆ cleanDir()

◆ cleanupBatch()

◆ cleanupDeletedBatch()

◆ concatenate()

◆ delete()

◆ deleteBatch()

◆ enumFiles()

◆ enumFilesInStorage()

◆ fileExists()

◆ fileExistsBatch()

◆ findBySha1()

◆ findBySha1s()

◆ findFile()

◆ findFileFromKey()

◆ findFiles()

◆ findFilesByPrefix()

◆ freeTemp()

◆ getBackend()

◆ getDeletedHashPath()

◆ getDescriptionRenderUrl()

◆ getDescriptionStylesheetUrl()

◆ getDescriptionUrl()

◆ getDisplayName()

◆ getErrorCleanupFunction()

◆ getFileProps()

◆ getFileSha1()

◆ getFileSize()

◆ getFileTimestamp()

◆ getHashLevels()

◆ getHashPath()

◆ getHashPathForLevel()

◆ getInfo()

◆ getLocalCacheKey()

◆ getLocalCopy()

◆ getLocalReference()

◆ getName()

◆ getNameFromTitle()

◆ getReadOnlyReason()

◆ getRootDirectory()

◆ getRootUrl()

◆ getSharedCacheKey()

◆ getTempHashPath()

◆ getTempRepo()

◆ getThumbScriptUrl()

◆ getUploadStash()

◆ getVirtualUrl()

◆ getZoneHandlerUrl()

◆ getZoneLocation()

◆ getZonePath()

◆ getZoneUrl()

◆ initDirectory()

◆ initZones()

◆ invalidateImageRedirect()

◆ isLocal()

◆ isVirtualUrl()

◆ makeUrl()

◆ nameForThumb()

◆ newFatal()

◆ newFile()

◆ newGood()

◆ paranoidClean()

◆ passThrough()

◆ publish()

◆ publishBatch()

◆ quickCleanDir()

◆ quickImport()

◆ quickImportBatch()