MediaWiki REL1_39
ForeignDBRepo Class Reference

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

Inheritance diagram for ForeignDBRepo:
Collaboration diagram for ForeignDBRepo:

Public Member Functions

 __construct ( $info)
 
 getBlobStore ()
 Get a BlobStore for storing and retrieving large metadata, or null if that can't be done.
 
 getPrimaryDB ()
 Get a connection to the primary DB.
 
 getReplicaDB ()
 Get a connection to the replica DB.
 
- Public Member Functions inherited from LocalRepo
 __construct (array $info=null)
 
 checkRedirect ( $title)
 Checks if there is a redirect named as $title.
 
 cleanupBatch (array $files, $flags=0)
 Deletes a batch of files.
 
 cleanupDeletedBatch (array $storageKeys)
 Delete files in the deleted directory if they are not referenced in the filearchive table.
 
 delete ( $srcRel, $archiveRel)
 Move a file to the deletion archive.
 
 deleteBatch (array $sourceDestPairs)
 Move a group of files to the deletion archive.
 
 findBySha1 ( $hash)
 Get an array or iterator of file objects for files that have a given SHA-1 content hash.
 
 findBySha1s (array $hashes)
 Get an array of arrays or iterators of file objects for files that have the given SHA-1 content hashes.
 
 findFiles (array $items, $flags=0)
 Find many files at once.
 
 findFilesByPrefix ( $prefix, $limit)
 Return an array of files where the name starts with $prefix.
 
 getMasterDB ()
 Get a connection to the primary DB.
 
 getSharedCacheKey ( $kClassSuffix,... $components)
 Get a global, repository-qualified, WAN cache key.
 
 getSplitMetadataThreshold ()
 Get the threshold above which metadata items should be split into separate storage, or null if no splitting should be done.
 
 invalidateImageRedirect ( $title)
 Invalidates image redirect cache related to that image.
 
 isJsonMetadataEnabled ()
 Returns true if files should store metadata in JSON format.
 
 isMetadataReserializeEnabled ()
 
 isMetadataUpdateEnabled ()
 
 isSplitMetadataEnabled ()
 Returns true if files should split up large metadata, storing parts of it in the BlobStore.
 
 newFileFromRow ( $row)
 
 newFromArchiveName ( $title, $archiveName)
 
 publish ( $src, $dstRel, $archiveRel, $flags=0, array $options=[])
 Copy or move a file either from a storage path, virtual URL, or file system path, into this repository at the specified destination location.
 
 publishBatch (array $ntuples, $flags=0)
 Publish a batch of files.
 
 store ( $srcPath, $dstZone, $dstRel, $flags=0)
 Store a file to a given destination.
 
 storeBatch (array $triplets, $flags=0)
 Store a batch of files.
 
- Public Member Functions inherited from FileRepo
 backendSupportsUnicodePaths ()
 
 canTransformLocally ()
 Returns true if the repository can transform files locally.
 
 canTransformVia404 ()
 Returns true if the repository can transform files via a 404 handler.
 
 cleanDir ( $dir)
 Deletes a directory if empty.
 
 concatenate (array $srcPaths, $dstPath, $flags=0)
 Concatenate a list of temporary files into a target file location.
 
 enumFiles ( $callback)
 Call a callback function for every public regular file in the repository.
 
 fileExists ( $file)
 Checks existence of a file.
 
 fileExistsBatch (array $files)
 Checks existence of an array of files.
 
 findFile ( $title, $options=[])
 Find an instance of the named file created at the specified time Returns false if the file does not exist.
 
 findFileFromKey ( $sha1, $options=[])
 Find an instance of the file with this key, created at the specified time Returns false if the file does not exist.
 
 freeTemp ( $virtualUrl)
 Remove a temporary file or mark it for garbage collection.
 
 getBackend ()
 Get the file backend instance.
 
 getDeletedHashPath ( $key)
 Get a relative path for a deletion archive key, e.g.
 
 getDescriptionRenderUrl ( $name, $lang=null)
 Get the URL of the content-only fragment of the description page.
 
 getDescriptionStylesheetUrl ()
 Get the URL of the stylesheet to apply to description pages.
 
 getDescriptionUrl ( $name)
 Get the URL of an image description page.
 
 getDisplayName ()
 Get the human-readable name of the repo.
 
 getFileProps ( $virtualUrl)
 Get properties of a file with a given virtual URL/storage path.
 
 getFileSha1 ( $virtualUrl)
 Get the sha1 (base 36) of a file with a given virtual URL/storage path.
 
 getFileSize ( $virtualUrl)
 Get the size of a file with a given virtual URL/storage path.
 
 getFileTimestamp ( $virtualUrl)
 Get the timestamp of a file with a given virtual URL/storage path.
 
 getHashLevels ()
 Get the number of hash directory levels.
 
 getHashPath ( $name)
 Get a relative path including trailing slash, e.g.
 
 getInfo ()
 Return information about the repository.
 
 getLocalCacheKey ( $kClassSuffix,... $components)
 Get a site-local, repository-qualified, WAN cache key.
 
 getLocalCopy ( $virtualUrl)
 Get a local FS copy of a file with a given virtual URL/storage path.
 
 getLocalReference ( $virtualUrl)
 Get a local FS file with a given virtual URL/storage path.
 
 getName ()
 Get the name of this repository, as specified by $info['name]' to the constructor.
 
 getNameFromTitle ( $title)
 Get the name of a file from its title.
 
 getReadOnlyReason ()
 Get an explanatory message if this repo is read-only.
 
 getRootDirectory ()
 Get the public zone root storage directory of the repository.
 
 getTempHashPath ( $suffix)
 Get a relative path including trailing slash, e.g.
 
 getTempRepo ()
 Get a temporary private FileRepo associated with this repo.
 
 getThumbProxySecret ()
 Get the secret key for the proxied thumb service.
 
 getThumbProxyUrl ()
 Get the URL thumb.php requests are being proxied to.
 
 getThumbScriptUrl ()
 Get the URL of thumb.php.
 
 getUploadStash (UserIdentity $user=null)
 Get an UploadStash associated with this repo.
 
 getVirtualUrl ( $suffix=false)
 Get a URL referring to this repository, with the private mwrepo protocol.
 
 getZonePath ( $zone)
 Get the storage path corresponding to one of the zones.
 
 getZoneUrl ( $zone, $ext=null)
 Get the URL corresponding to one of the four basic zones.
 
 hasSha1Storage ()
 Returns whether or not storage is SHA-1 based.
 
 isLocal ()
 Returns true if this the local file repository.
 
 makeUrl ( $query='', $entry='index')
 Make an url to this repo.
 
 nameForThumb ( $name)
 Get the portion of the file that contains the origin file name.
 
 newFatal ( $message,... $parameters)
 Create a new fatal error.
 
 newFile ( $title, $time=false)
 Create a new File object from the local repository.
 
 newGood ( $value=null)
 Create a new good result.
 
 paranoidClean ( $param)
 Path disclosure protection function.
 
 passThrough ( $param)
 Path disclosure protection function.
 
 quickCleanDir ( $dir)
 Deletes a directory if empty.
 
 quickImport ( $src, $dst, $options=null)
 Import a file from the local file system into the repo.
 
 quickImportBatch (array $triples)
 Import a batch of files from the local file system into the repo.
 
 quickPurge ( $path)
 Purge a file from the repo.
 
 quickPurgeBatch (array $paths)
 Purge a batch of files from the repo.
 
 resolveVirtualUrl ( $url)
 Get the backend storage path corresponding to a virtual URL.
 
 storeTemp ( $originalName, $srcPath)
 Pick a random name in the temp zone and store a file to it.
 
 streamFileWithStatus ( $virtualUrl, $headers=[], $optHeaders=[])
 Attempt to stream a file with the given virtual URL/storage path.
 
 supportsSha1URLs ()
 Returns whether or not repo supports having originals SHA-1s in the thumb URLs.
 
 validateFilename ( $filename)
 Determine if a relative path is valid, i.e.
 

Protected Member Functions

 assertWritableRepo ()
 Throw an exception if this repo is read-only by design.
 
 getDBFactory ()
 
- Protected Member Functions inherited from LocalRepo
 deletedFileHasKey ( $key, $lock=null)
 Check if a deleted (filearchive) file has this sha1 key.
 
 hasAcessibleSharedCache ()
 Check whether the repo has a shared cache, accessible from the current site context.
 
 hiddenFileHasKey ( $key, $lock=null)
 Check if a hidden (revision delete) file has this sha1 key.
 
 skipWriteOperationIfSha1 ( $function, array $args)
 Skips the write operation if storage is sha1-based, executes it normally otherwise.
 
- Protected Member Functions inherited from FileRepo
 enumFilesInStorage ( $callback)
 Call a callback function for every public file in the repository.
 
 getZoneLocation ( $zone)
 The storage container and base path of a zone.
 
 initDirectory ( $dir)
 Creates a directory with the appropriate zone permissions.
 
 initZones ( $doZones=[])
 Ensure that a single zone or list of zones is defined for usage.
 
 resolveToStoragePathIfVirtual ( $path)
 If a path is a virtual URL, resolve it to a storage path.
 

Protected Attributes

IDatabase $dbConn
 
string $dbFlags
 
string $dbName
 
string $dbPassword
 
string $dbServer
 
string $dbType
 
string $dbUser
 
callable $fileFactory = [ ForeignDBFile::class, 'newFromTitle' ]
 
callable $fileFromRowFactory = [ ForeignDBFile::class, 'newFromRow' ]
 
string $tablePrefix
 
- Protected Attributes inherited from LocalRepo
BlobStore $blobStore
 
string $dbDomain
 DB domain of the repo wiki.
 
callable $fileFactory = [ LocalFile::class, 'newFromTitle' ]
 
callable $fileFactoryKey = [ LocalFile::class, 'newFromKey' ]
 
callable $fileFromRowFactory = [ LocalFile::class, 'newFromRow' ]
 
bool $hasAccessibleSharedCache
 Whether shared cache keys are exposed/accessible.
 
callable $oldFileFactory = [ OldLocalFile::class, 'newFromTitle' ]
 
callable $oldFileFactoryKey = [ OldLocalFile::class, 'newFromKey' ]
 
callable $oldFileFromRowFactory = [ OldLocalFile::class, 'newFromRow' ]
 
bool $reserializeMetadata = false
 
int null $splitMetadataThreshold = 1000
 
bool $updateCompatibleMetadata = false
 
bool $useJsonMetadata = true
 
bool $useSplitMetadata = false
 
- Protected Attributes inherited from FileRepo
int $abbrvThreshold
 File names over this size will use the short form of thumbnail names.
 
string $articleUrl
 Equivalent to $wgArticlePath, e.g.
 
FileBackend $backend
 
int $deletedHashLevels
 The number of directory levels for hash-based division of deleted files.
 
string $descBaseUrl
 URL of image description pages, e.g.
 
bool $disableLocalTransform = false
 Disable local image scaling.
 
null string $favicon = null
 The URL to a favicon (optional, may be a server-local path URL).
 
callable $fileFactory = [ UnregisteredLocalFile::class, 'newFromTitle' ]
 Override these in the base class.
 
callable false $fileFactoryKey = false
 Override these in the base class.
 
int $hashLevels
 The number of directory levels for hash-based division of files.
 
bool $hasSha1Storage = false
 
bool $initialCapital
 Equivalent to $wgCapitalLinks (or $wgCapitalLinkOverrides[NS_FILE], determines whether filenames implicitly start with a capital letter.
 
bool $isPrivate
 Whether all zones should be private (e.g.
 
callable false $oldFileFactory = false
 Override these in the base class.
 
callable false $oldFileFactoryKey = false
 Override these in the base class.
 
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.
 
string $scriptDirUrl
 URL of the MediaWiki installation, equivalent to $wgScriptPath, e.g.
 
bool $supportsSha1URLs = false
 
string $thumbProxySecret
 Secret key to pass as an X-Swift-Secret header to the proxied thumb service.
 
string $thumbProxyUrl
 URL of where to proxy thumb.php requests to.
 
string $thumbScriptUrl
 URL of thumb.php.
 
string false $thumbUrl
 The base thumbnail URL.
 
bool $transformVia404
 Whether to skip media file transformation on parse and rely on a 404 handler instead.
 
string false $url
 Public zone URL.
 
WANObjectCache $wanCache
 
array $zones = []
 Map of zones to config.
 

Additional Inherited Members

- Static Public Member Functions inherited from LocalRepo
static getHashFromKey ( $key)
 Gets the SHA1 hash from a storage key.
 
- Static Public Member Functions inherited from FileRepo
static isVirtualUrl ( $url)
 Determine if a string is an mwrepo:// URL.
 
- Public Attributes inherited from FileRepo
int $descriptionCacheExpiry
 
bool $fetchDescription
 Whether to fetch commons image description pages and display them on the local wiki.
 
string $name
 
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 34 of file ForeignDBRepo.php.

Constructor & Destructor Documentation

◆ __construct()

ForeignDBRepo::__construct ( $info)
Parameters
array | null$info

Definition at line 67 of file ForeignDBRepo.php.

References LocalRepo\$dbDomain.

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|never
Exceptions
MWException

Reimplemented from FileRepo.

Definition at line 116 of file ForeignDBRepo.php.

◆ getBlobStore()

ForeignDBRepo::getBlobStore ( )

Get a BlobStore for storing and retrieving large metadata, or null if that can't be done.

Returns
?BlobStore

Reimplemented from LocalRepo.

Definition at line 120 of file ForeignDBRepo.php.

◆ getDBFactory()

ForeignDBRepo::getDBFactory ( )
protected
Returns
Closure

Reimplemented from LocalRepo.

Definition at line 100 of file ForeignDBRepo.php.

References $dbFlags, $dbName, $dbPassword, $dbServer, $dbType, $dbUser, $tablePrefix, and $type.

Referenced by getPrimaryDB().

◆ getPrimaryDB()

ForeignDBRepo::getPrimaryDB ( )

Get a connection to the primary DB.

Returns
IDatabase
Since
1.37

Reimplemented from LocalRepo.

Definition at line 84 of file ForeignDBRepo.php.

References $dbConn, DB_PRIMARY, and getDBFactory().

Referenced by getReplicaDB().

◆ getReplicaDB()

ForeignDBRepo::getReplicaDB ( )

Get a connection to the replica DB.

Returns
IDatabase

Reimplemented from LocalRepo.

Definition at line 93 of file ForeignDBRepo.php.

References getPrimaryDB().

Member Data Documentation

◆ $dbConn

IDatabase ForeignDBRepo::$dbConn
protected

Definition at line 57 of file ForeignDBRepo.php.

Referenced by getPrimaryDB().

◆ $dbFlags

string ForeignDBRepo::$dbFlags
protected

Definition at line 51 of file ForeignDBRepo.php.

Referenced by getDBFactory().

◆ $dbName

string ForeignDBRepo::$dbName
protected

Definition at line 48 of file ForeignDBRepo.php.

Referenced by getDBFactory().

◆ $dbPassword

string ForeignDBRepo::$dbPassword
protected

Definition at line 45 of file ForeignDBRepo.php.

Referenced by getDBFactory().

◆ $dbServer

string ForeignDBRepo::$dbServer
protected

Definition at line 39 of file ForeignDBRepo.php.

Referenced by getDBFactory().

◆ $dbType

string ForeignDBRepo::$dbType
protected

Definition at line 36 of file ForeignDBRepo.php.

Referenced by getDBFactory().

◆ $dbUser

string ForeignDBRepo::$dbUser
protected

Definition at line 42 of file ForeignDBRepo.php.

Referenced by getDBFactory().

◆ $fileFactory

callable ForeignDBRepo::$fileFactory = [ ForeignDBFile::class, 'newFromTitle' ]
protected

Definition at line 60 of file ForeignDBRepo.php.

◆ $fileFromRowFactory

callable ForeignDBRepo::$fileFromRowFactory = [ ForeignDBFile::class, 'newFromRow' ]
protected

Definition at line 62 of file ForeignDBRepo.php.

◆ $tablePrefix

string ForeignDBRepo::$tablePrefix
protected

Definition at line 54 of file ForeignDBRepo.php.

Referenced by getDBFactory().


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