Prioritized list of file repositories. More...

Collaboration diagram for RepoGroup:

[legend]

Public Member Functions
	__construct ( $localInfo, $foreignInfo, $wanCache)
	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 ()

static	setSingleton ( $instance)

static	singleton ()

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
MapCacheLRU	$cache

array	$foreignInfo

FileRepo[]	$foreignRepos

array	$localInfo

LocalRepo	$localRepo

bool	$reposInitialised = false

WANObjectCache	$wanCache

Detailed Description

Prioritized list of file repositories.

Definition at line 31 of file RepoGroup.php.

Constructor & Destructor Documentation

◆ __construct()

RepoGroup::__construct	(	$localInfo,
		$foreignInfo,
		$wanCache )

Construct a group of file repositories.

Do not call this – use MediaWikiServices::getRepoGroup.

Parameters

array	$localInfo	Associative array for local repo's info
array	$foreignInfo	Array 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.
WANObjectCache	$wanCache

Definition at line 98 of file RepoGroup.php.

Member Function Documentation

◆ checkRedirect()

RepoGroup::checkRedirect ( Title $title )

Interface for FileRepo::checkRedirect()

Parameters

Title $title

Returns: bool|Title

Definition at line 229 of file RepoGroup.php.

References $title, and initialiseRepos().

◆ clearCache()

RepoGroup::clearCache ( Title $title = null )

Clear RepoGroup process cache used for finding a file.

Parameters

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

Definition at line 468 of file RepoGroup.php.

References $title.

◆ destroySingleton()

static RepoGroup::destroySingleton ( )

static

Deprecated: since 1.34, use MediaWikiTestCase::overrideMwServices() or similar. This will cause bugs if you don't reset all other services that depend on this one at the same time.

Definition at line 68 of file RepoGroup.php.

Referenced by PageImages\Tests\Hooks\LinksUpdateHookHandlerTest\tearDown().

◆ findBySha1()

RepoGroup::findBySha1 ( $hash )

Find all instances of files with this key.

Parameters

string $hash Base 36 SHA-1 hash

Returns: File[]

Definition at line 281 of file RepoGroup.php.

References initialiseRepos().

◆ findBySha1s()

RepoGroup::findBySha1s ( array $hashes )

Find all instances of files with this keys.

Parameters

array $hashes Base 36 SHA-1 hashes

Returns: array Array of array of File objects

Definition at line 301 of file RepoGroup.php.

References $hashes, and initialiseRepos().

◆ findFile()

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

Search repositories for an image.

Parameters

Title \| string	$title	Title object or string
array	$options	Associative 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 -param array{time?:mixed,ignoreRedirect?:bool,private?:bool,latest?:bool} $options

Returns: File|bool False if title is not found

Definition at line 121 of file RepoGroup.php.

References $title, and initialiseRepos().

◆ 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	$hash	Base 36 SHA-1 hash
array	$options	Option array, same as findFile()

Returns: File|bool File object or false if it is not found

Definition at line 257 of file RepoGroup.php.

References $file, and initialiseRepos().

◆ findFiles()

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

Search repositories for many files at once.

Parameters

array $inputItems An 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

$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

Definition at line 194 of file RepoGroup.php.

References initialiseRepos().

◆ forEachForeignRepo()

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

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

Parameters

callable	$callback	The function to call
array	$params	Optional additional parameters to pass to the function

Returns: bool

Definition at line 372 of file RepoGroup.php.

References initialiseRepos().

◆ getFileProps()

RepoGroup::getFileProps ( $fileName )

Parameters

string $fileName

Returns: array

Definition at line 448 of file RepoGroup.php.

References getRepo(), FileRepo\isVirtualUrl(), 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 357 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 323 of file RepoGroup.php.

References 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 338 of file RepoGroup.php.

References initialiseRepos().

◆ hasForeignRepos()

RepoGroup::hasForeignRepos ( )

Does the installation have any foreign repos set up?

Returns: bool

Definition at line 389 of file RepoGroup.php.

References initialiseRepos().

◆ initialiseRepos()

RepoGroup::initialiseRepos ( )

Initialise the $repos array.

Definition at line 399 of file RepoGroup.php.

References 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 417 of file RepoGroup.php.

Referenced by initialiseRepos().

◆ setSingleton()

static RepoGroup::setSingleton ( $instance )

static

Deprecated: since 1.34, use MediaWikiTestCase::setService, this can mess up state of other tests

Parameters

RepoGroup $instance

Definition at line 77 of file RepoGroup.php.

Referenced by PageImages\Tests\Hooks\LinksUpdateHookHandlerTest\testIsFreeImage().

◆ singleton()

static RepoGroup::singleton ( )

static

Deprecated: since 1.34, use MediaWikiServices::getRepoGroup

Returns: RepoGroup

Definition at line 60 of file RepoGroup.php.

◆ 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 431 of file RepoGroup.php.

Referenced by getFileProps().

Member Data Documentation

◆ $cache

MapCacheLRU RepoGroup::$cache

protected

Definition at line 51 of file RepoGroup.php.

◆ $foreignInfo

array RepoGroup::$foreignInfo

protected

Definition at line 48 of file RepoGroup.php.

◆ $foreignRepos

FileRepo [] RepoGroup::$foreignRepos

protected

Definition at line 36 of file RepoGroup.php.

◆ $localInfo

array RepoGroup::$localInfo

protected

Definition at line 45 of file RepoGroup.php.

◆ $localRepo

LocalRepo RepoGroup::$localRepo

protected

Definition at line 33 of file RepoGroup.php.

◆ $reposInitialised

bool RepoGroup::$reposInitialised = false

protected

Definition at line 42 of file RepoGroup.php.

◆ $wanCache

WANObjectCache RepoGroup::$wanCache

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:

includes/filerepo/RepoGroup.php

Public Member Functions

Static Public Member Functions

Public Attributes

Protected Member Functions

Protected Attributes

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ checkRedirect()

◆ clearCache()

◆ destroySingleton()

◆ findBySha1()

◆ findBySha1s()

◆ findFile()

◆ findFileFromKey()

◆ findFiles()

◆ forEachForeignRepo()

◆ getFileProps()

◆ getLocalRepo()

◆ getRepo()

◆ getRepoByName()

◆ hasForeignRepos()

◆ initialiseRepos()

◆ newRepo()

◆ setSingleton()

◆ singleton()

◆ splitVirtualUrl()

Member Data Documentation

◆ $cache

◆ $foreignInfo

◆ $foreignRepos

◆ $localInfo

◆ $localRepo

◆ $reposInitialised

◆ $wanCache

◆ MAX_CACHE_SIZE