MediaWiki REL1_33
RepoGroup Class Reference

Prioritized list of file repositories. More...

Collaboration diagram for RepoGroup:

Public Member Functions

 __construct ( $localInfo, $foreignInfo)
 Construct a group of file repositories.
 
 checkRedirect (Title $title)
 Interface for FileRepo::checkRedirect()
 
 clearCache (Title $title=null)
 Clear RepoGroup process cache used for finding a file.
 
 findBySha1 ( $hash)
 Find all instances of files with this key.
 
 findBySha1s (array $hashes)
 Find all instances of files with this keys.
 
 findFile ( $title, $options=[])
 Search repositories for an image.
 
 findFileFromKey ( $hash, $options=[])
 Find an instance of the file with this key, created at the specified time Returns false if the file does not exist.
 
 findFiles (array $inputItems, $flags=0)
 Search repositories for many files at once.
 
 forEachForeignRepo ( $callback, $params=[])
 Call a function for each foreign repo, with the repo object as the first parameter.
 
 getFileProps ( $fileName)
 
 getLocalRepo ()
 Get the local repository, i.e.
 
 getRepo ( $index)
 Get the repo instance with a given key.
 
 getRepoByName ( $name)
 Get the repo instance by its name.
 
 hasForeignRepos ()
 Does the installation have any foreign repos set up?
 
 initialiseRepos ()
 Initialise the $repos array.
 
 splitVirtualUrl ( $url)
 Split a virtual URL into repo, zone and rel parts.
 

Static Public Member Functions

static destroySingleton ()
 Destroy the singleton instance, so that a new one will be created next time singleton() is called.
 
static setSingleton ( $instance)
 Set the singleton instance to a given object Used by extensions which hook into the Repo chain.
 
static singleton ()
 Get a RepoGroup instance.
 

Public Attributes

const MAX_CACHE_SIZE = 500
 Maximum number of cache items.
 

Protected Member Functions

 newRepo ( $info)
 Create a repo class based on an info structure.
 

Protected Attributes

ProcessCacheLRU $cache
 
array $foreignInfo
 
FileRepo[] $foreignRepos
 
array $localInfo
 
LocalRepo $localRepo
 
bool $reposInitialised = false
 

Static Protected Attributes

static RepoGroup $instance
 

Detailed Description

Prioritized list of file repositories.

Definition at line 31 of file RepoGroup.php.

Constructor & Destructor Documentation

◆ __construct()

RepoGroup::__construct (   $localInfo,
  $foreignInfo 
)

Construct a group of file repositories.

Parameters
array$localInfoAssociative array for local repo's info
array$foreignInfoArray of repository info arrays. Each info array is an associative array with the 'class' member giving the class name. The entire array is passed to the repository constructor as the first parameter.

Definition at line 101 of file RepoGroup.php.

References $foreignInfo, $localInfo, and cache.

Member Function Documentation

◆ checkRedirect()

RepoGroup::checkRedirect ( Title  $title)

Interface for FileRepo::checkRedirect()

Parameters
Title$title
Returns
bool|Title

Definition at line 231 of file RepoGroup.php.

References $title, as, and initialiseRepos().

◆ clearCache()

RepoGroup::clearCache ( Title  $title = null)

Clear RepoGroup process cache used for finding a file.

Parameters
Title | null$titleTitle of the file or null to clear all files

Definition at line 471 of file RepoGroup.php.

References $title, and cache.

◆ destroySingleton()

static RepoGroup::destroySingleton ( )
static

◆ findBySha1()

RepoGroup::findBySha1 (   $hash)

Find all instances of files with this key.

Parameters
string$hashBase 36 SHA-1 hash
Returns
File[]

Definition at line 283 of file RepoGroup.php.

References as, and initialiseRepos().

◆ findBySha1s()

RepoGroup::findBySha1s ( array  $hashes)

Find all instances of files with this keys.

Parameters
array$hashesBase 36 SHA-1 hashes
Returns
array Array of array of File objects

Definition at line 303 of file RepoGroup.php.

References $hashes, as, and initialiseRepos().

◆ findFile()

RepoGroup::findFile (   $title,
  $options = [] 
)

Search repositories for an image.

You can also use wfFindFile() to do this.

Parameters
Title | string$titleTitle object or string
array$optionsAssociative array of options: time: requested time for an archived image, or false for the current version. An image object will be returned which was created at the specified time. 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. latest: If true, load from the latest available data into File objects
Returns
File|bool False if title is not found

Definition at line 123 of file RepoGroup.php.

References $image, $options, $title, as, cache, false, initialiseRepos(), and File\normalizeTitle().

◆ findFileFromKey()

RepoGroup::findFileFromKey (   $hash,
  $options = [] 
)

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

Parameters
string$hashBase 36 SHA-1 hash
array$optionsOption array, same as findFile()
Returns
File|bool File object or false if it is not found

Definition at line 259 of file RepoGroup.php.

References $file, $options, as, and initialiseRepos().

◆ findFiles()

RepoGroup::findFiles ( array  $inputItems,
  $flags = 0 
)

Search repositories for many files at once.

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

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

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

Parameters
int$flagsSupports:
  • 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

Definition at line 196 of file RepoGroup.php.

References $image, $name, as, initialiseRepos(), and File\normalizeTitle().

◆ forEachForeignRepo()

RepoGroup::forEachForeignRepo (   $callback,
  $params = [] 
)

Call a function for each foreign repo, with the repo object as the first parameter.

Parameters
callable$callbackThe function to call
array$paramsOptional additional parameters to pass to the function
Returns
bool

Definition at line 374 of file RepoGroup.php.

References $params, as, and initialiseRepos().

◆ getFileProps()

RepoGroup::getFileProps (   $fileName)
Parameters
string$fileName
Returns
array

Definition at line 451 of file RepoGroup.php.

References getRepo(), FileRepo\isVirtualUrl(), list, and splitVirtualUrl().

◆ getLocalRepo()

RepoGroup::getLocalRepo ( )

Get the local repository, i.e.

the one corresponding to the local image table. Files are typically uploaded to the local repository.

Returns
LocalRepo

Definition at line 359 of file RepoGroup.php.

References getRepo().

◆ getRepo()

RepoGroup::getRepo (   $index)

Get the repo instance with a given key.

Parameters
string | int$index
Returns
bool|FileRepo

Definition at line 325 of file RepoGroup.php.

References $localRepo, and initialiseRepos().

Referenced by getFileProps(), and getLocalRepo().

◆ getRepoByName()

RepoGroup::getRepoByName (   $name)

Get the repo instance by its name.

Parameters
string$name
Returns
FileRepo|bool

Definition at line 340 of file RepoGroup.php.

References $name, as, and initialiseRepos().

◆ hasForeignRepos()

RepoGroup::hasForeignRepos ( )

Does the installation have any foreign repos set up?

Returns
bool

Definition at line 391 of file RepoGroup.php.

References $foreignRepos, and initialiseRepos().

◆ initialiseRepos()

RepoGroup::initialiseRepos ( )

Initialise the $repos array.

Definition at line 401 of file RepoGroup.php.

References as, and newRepo().

Referenced by checkRedirect(), findBySha1(), findBySha1s(), findFile(), findFileFromKey(), findFiles(), forEachForeignRepo(), getRepo(), getRepoByName(), and hasForeignRepos().

◆ newRepo()

RepoGroup::newRepo (   $info)
protected

Create a repo class based on an info structure.

Parameters
array$info
Returns
FileRepo

Definition at line 419 of file RepoGroup.php.

References $cache.

Referenced by initialiseRepos().

◆ setSingleton()

static RepoGroup::setSingleton (   $instance)
static

Set the singleton instance to a given object Used by extensions which hook into the Repo chain.

It's not enough to just create a superclass ... you have to get people to call into it even though all they know is RepoGroup::singleton()

Parameters
RepoGroup$instance

Definition at line 88 of file RepoGroup.php.

References $instance.

Referenced by ParserTestRunner\staticSetup().

◆ singleton()

static RepoGroup::singleton ( )
static

Get a RepoGroup instance.

At present only one instance of RepoGroup is needed in a MediaWiki invocation, this may change in the future.

Returns
RepoGroup

Definition at line 61 of file RepoGroup.php.

References $instance, $wgForeignFileRepos, and $wgLocalFileRepo.

Referenced by RevDelArchivedFileItem\__construct(), UploadFromStash\__construct(), ApiQueryAllImages\__construct(), UploadFromChunks\__construct(), ParserTestRunner\addArticle(), UploadBase\checkAgainstExistingDupes(), RevertAction\checkCanExecute(), ApiDelete\deleteFile(), ApiUploadTestCase\deleteFileByContent(), ParserTestRunner\deleteFiles(), RevDelFileList\doPreCommitUpdates(), UploadBase\doStashFile(), MovePageForm\doSubmit(), SpecialUploadStash\execute(), ApiMove\execute(), ApiQueryImageInfo\execute(), ApiQueryStashImageInfo\execute(), FileDeleteForm\execute(), LocalFileRestoreBatch\execute(), CheckImages\execute(), CleanupUploadStash\execute(), DeleteArchivedFiles\execute(), FindMissingFiles\execute(), FindOrphanedFiles\execute(), RefreshFileHeaders\execute(), RefreshImageMetadata\execute(), Parser\fetchFileNoRegister(), CleanupImages\filePath(), ImageListPager\formatValue(), ContentSecurityPolicy\getAdditionalSelfUrls(), UploadForm\getDescriptionSection(), FileDuplicateSearchPage\getDupes(), WikiFilePage\getDuplicates(), ApiQueryFileRepoInfo\getInitialisedRepoGroup(), UploadBase\getRealPath(), MigrateFileRepoLayout\getRepo(), ImageBuilder\getRepo(), UploadBase\getTitle(), ImportableUploadRevisionImporter\import(), RevDelFileItem\initFile(), WantedFilesPage\likelyToHaveFalsePositives(), Linker\makeBrokenImageLinkObj(), MovePage\moveFile(), WikiPage\onArticleDelete(), PurgeChangedFiles\purgeFromLogType(), ApiQueryDuplicateFiles\run(), EraseArchivedFile\scrubVersion(), DatabaseUpdater\setFileAccess(), ParserTestRunner\setupUploadBackend(), SpecialUndelete\showFile(), ParserTestRunner\teardownUploadBackend(), RepoGroupTest\testForEachForeignRepo(), RepoGroupTest\testForEachForeignRepoNone(), RepoGroupTest\testHasForeignRepoNegative(), RepoGroupTest\testHasForeignRepoPositive(), UploadStashTest\testT31408(), SpecialUploadStash\tryClearStashedUploads(), SpecialRevisionDelete\tryShowFile(), WikiPage\updateRedirectOn(), ApiFileRevert\validateParameters(), wfExtractThumbRequestInfo(), wfFindFile(), wfLocalFile(), wfStreamThumb(), and wfThumbHandle404().

◆ splitVirtualUrl()

RepoGroup::splitVirtualUrl (   $url)

Split a virtual URL into repo, zone and rel parts.

Parameters
string$url
Exceptions
MWException
Returns
string[] Containing repo, zone and rel

Definition at line 434 of file RepoGroup.php.

Referenced by getFileProps().

Member Data Documentation

◆ $cache

ProcessCacheLRU RepoGroup::$cache
protected

Definition at line 48 of file RepoGroup.php.

Referenced by newRepo().

◆ $foreignInfo

array RepoGroup::$foreignInfo
protected

Definition at line 45 of file RepoGroup.php.

Referenced by __construct().

◆ $foreignRepos

FileRepo [] RepoGroup::$foreignRepos
protected

Definition at line 36 of file RepoGroup.php.

Referenced by hasForeignRepos().

◆ $instance

RepoGroup RepoGroup::$instance
staticprotected

Definition at line 51 of file RepoGroup.php.

Referenced by setSingleton(), and singleton().

◆ $localInfo

array RepoGroup::$localInfo
protected

Definition at line 42 of file RepoGroup.php.

Referenced by __construct().

◆ $localRepo

LocalRepo RepoGroup::$localRepo
protected

Definition at line 33 of file RepoGroup.php.

Referenced by getRepo().

◆ $reposInitialised

bool RepoGroup::$reposInitialised = false
protected

Definition at line 39 of file RepoGroup.php.

◆ MAX_CACHE_SIZE

const RepoGroup::MAX_CACHE_SIZE = 500

Maximum number of cache items.

Definition at line 54 of file RepoGroup.php.


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