A foreign repository with an accessible MediaWiki database. More...

Inheritance diagram for ForeignDBRepo:

Collaboration diagram for ForeignDBRepo:

[legend]

Public Member Functions
	__construct ( $info)

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

	getMasterDB ()

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

	getSlaveDB ()

	hasSharedCache ()

Public Member Functions inherited from LocalRepo
	checkRedirect (Title $title)
	Checks if there is a redirect named as $title. More...

	cleanupDeletedBatch (array $storageKeys)
	Delete files in the deleted directory if they are not referenced in the filearchive table. 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...

	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...

	invalidateImageRedirect (Title $title)
	Invalidates image redirect cache related to that image. More...

	newFileFromRow ( $row)

	newFromArchiveName ( $title, $archiveName)

Public Member Functions inherited from FileRepo
	__construct (array $info=null)

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

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

	cleanupBatch (array $files, $flags=0)
	Deletes a batch of files. 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...

	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...

	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...

	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...

	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...

	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...

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

Protected Member Functions inherited from LocalRepo
	deletedFileHasKey ( $key, $lock=null)
	Check if a deleted (filearchive) file has this sha1 key. More...

	getArticleID ( $title)
	Function link Title::getArticleID(). More...

	hiddenFileHasKey ( $key, $lock=null)
	Check if a hidden (revision delete) file has this sha1 key. More...

Protected Member Functions inherited from FileRepo
	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...

Protected Attributes
	$dbConn

string	$dbFlags

string	$dbName

string	$dbPassword

string	$dbServer

string	$dbType

string	$dbUser

	$fileFactory = array( 'ForeignDBFile', 'newFromTitle' )

	$fileFromRowFactory = array( 'ForeignDBFile', 'newFromRow' )

bool	$hasSharedCache

string	$tablePrefix

Protected Attributes inherited from LocalRepo
array	$fileFactory = array( 'LocalFile', 'newFromTitle' )

array	$fileFactoryKey = array( 'LocalFile', 'newFromKey' )

array	$fileFromRowFactory = array( 'LocalFile', 'newFromRow' )

array	$oldFileFactory = array( 'OldLocalFile', 'newFromTitle' )

array	$oldFileFactoryKey = array( 'OldLocalFile', 'newFromKey' )

array	$oldFileFromRowFactory = array( 'OldLocalFile', 'newFromRow' )

Protected Attributes inherited from FileRepo
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...

Additional Inherited Members
Static Public Member Functions inherited from LocalRepo
static	getHashFromKey ( $key)
	Gets the SHA1 hash from a storage key. More...

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

Public Attributes inherited from FileRepo
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

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

Detailed Description

A foreign repository with an accessible MediaWiki database.

Definition at line 29 of file ForeignDBRepo.php.

Constructor & Destructor Documentation

◆ __construct()

ForeignDBRepo::__construct ( $info )

Parameters

array | null $info

Definition at line 54 of file ForeignDBRepo.php.

References hasSharedCache().

Member Function Documentation

◆ assertWritableRepo()

ForeignDBRepo::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 from FileRepo.

Definition at line 118 of file ForeignDBRepo.php.

◆ getInfo()

ForeignDBRepo::getInfo ( )

Return information about the repository.

Returns: array

Since: 1.22

Reimplemented from LocalRepo.

Definition at line 128 of file ForeignDBRepo.php.

References FileRepo\getInfo().

◆ getMasterDB()

ForeignDBRepo::getMasterDB ( )

Returns: DatabaseBase

Reimplemented from LocalRepo.

Definition at line 69 of file ForeignDBRepo.php.

References $dbConn, array(), and DatabaseBase\factory().

Referenced by getSlaveDB().

◆ getSharedCacheKey()

ForeignDBRepo::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().

Returns: bool|mixed

Reimplemented from LocalRepo.

Definition at line 107 of file ForeignDBRepo.php.

References $args, and hasSharedCache().

◆ getSlaveDB()

ForeignDBRepo::getSlaveDB ( )

Returns: DatabaseBase

Reimplemented from LocalRepo.

Definition at line 90 of file ForeignDBRepo.php.

References getMasterDB().

◆ hasSharedCache()

ForeignDBRepo::hasSharedCache ( )

Returns: bool

Definition at line 97 of file ForeignDBRepo.php.

References $hasSharedCache.

Referenced by __construct(), and getSharedCacheKey().

Member Data Documentation

◆ $dbConn

ForeignDBRepo::$dbConn

protected

Definition at line 47 of file ForeignDBRepo.php.

Referenced by getMasterDB().

◆ $dbFlags

string ForeignDBRepo::$dbFlags

protected

Definition at line 40 of file ForeignDBRepo.php.

◆ $dbName

string ForeignDBRepo::$dbName

protected

Definition at line 38 of file ForeignDBRepo.php.

◆ $dbPassword

string ForeignDBRepo::$dbPassword

protected

Definition at line 36 of file ForeignDBRepo.php.

◆ $dbServer

string ForeignDBRepo::$dbServer

protected

Definition at line 32 of file ForeignDBRepo.php.

◆ $dbType

string ForeignDBRepo::$dbType

protected

Definition at line 30 of file ForeignDBRepo.php.

◆ $dbUser

string ForeignDBRepo::$dbUser

protected

Definition at line 34 of file ForeignDBRepo.php.

◆ $fileFactory

ForeignDBRepo::$fileFactory = array( 'ForeignDBFile', 'newFromTitle' )

protected

Definition at line 48 of file ForeignDBRepo.php.

◆ $fileFromRowFactory

ForeignDBRepo::$fileFromRowFactory = array( 'ForeignDBFile', 'newFromRow' )

protected

Definition at line 49 of file ForeignDBRepo.php.

◆ $hasSharedCache

bool ForeignDBRepo::$hasSharedCache

protected

Definition at line 44 of file ForeignDBRepo.php.

Referenced by hasSharedCache().

◆ $tablePrefix

string ForeignDBRepo::$tablePrefix

protected

Definition at line 42 of file ForeignDBRepo.php.

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

includes/filerepo/ForeignDBRepo.php

Public Member Functions

Protected Member Functions

Protected Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ assertWritableRepo()

◆ getInfo()

◆ getMasterDB()

◆ getSharedCacheKey()

◆ getSlaveDB()

◆ hasSharedCache()

Member Data Documentation

◆ $dbConn

◆ $dbFlags

◆ $dbName

◆ $dbPassword

◆ $dbServer

◆ $dbType

◆ $dbUser

◆ $fileFactory

◆ $fileFromRowFactory

◆ $hasSharedCache

◆ $tablePrefix