Inherits LoggerAwareInterface.
Public Member Functions | |
| __construct (array $externalStores, array $defaultStores, string $localDomainId, ?LoggerInterface $logger=null) | |
| getDatabaseStore (array $params=[]) | |
| Shorthand for better type inference. | |
| getProtocols () | |
| getStore ( $proto, array $params=[]) | |
| Get an external store object of the given type, with the given parameters. | |
| getStoreForUrl ( $url, array $params=[]) | |
| Get the ExternalStoreMedium for a given URL. | |
| getStoreLocationFromUrl ( $url) | |
| Get the location within the appropriate store for a given a URL. | |
| getUrlsByProtocol (array $urls) | |
| getWriteBaseUrls () | |
| setLogger (LoggerInterface $logger) | |
Detailed Description
- See also
- ExternalStoreAccess
- Access: internal
- Use the ExternalStoreAccess service instead.
- Since
- 1.31
Definition at line 16 of file ExternalStoreFactory.php.
Constructor & Destructor Documentation
◆ __construct()
| MediaWiki\ExternalStore\ExternalStoreFactory::__construct | ( | array | $externalStores, |
| array | $defaultStores, | ||
| string | $localDomainId, | ||
| ?LoggerInterface | $logger = null ) |
- Parameters
-
string[] $externalStores See $wgExternalStores string[] $defaultStores See $wgDefaultExternalStore string $localDomainId Local database/wiki ID LoggerInterface | null $logger
Definition at line 34 of file ExternalStoreFactory.php.
Member Function Documentation
◆ getDatabaseStore()
| MediaWiki\ExternalStore\ExternalStoreFactory::getDatabaseStore | ( | array | $params = [] | ) |
Shorthand for better type inference.
- Since
- 1.46
Definition at line 122 of file ExternalStoreFactory.php.
◆ getProtocols()
| MediaWiki\ExternalStore\ExternalStoreFactory::getProtocols | ( | ) |
- Returns
- string[] List of active store types/protocols (lowercased), e.g. [ "db" ]
- Since
- 1.34
Definition at line 54 of file ExternalStoreFactory.php.
◆ getStore()
| MediaWiki\ExternalStore\ExternalStoreFactory::getStore | ( | $proto, | |
| array | $params = [] ) |
Get an external store object of the given type, with the given parameters.
The 'domain' field in $params will be set to the local DB domain if it is unset or false. A special 'isDomainImplicit' flag is set when this happens, which should only be used to handle legacy DB domain configuration concerns (e.g. T200471).
- Parameters
-
string $proto Type of external storage, should be a value in $wgExternalStores array $params Map of ExternalStoreMedium::__construct context parameters.
- Returns
- ExternalStoreMedium The store class or false on error
- Exceptions
-
ExternalStoreException When $proto is not recognized
Definition at line 78 of file ExternalStoreFactory.php.
References MediaWiki\MediaWikiServices\getInstance().
◆ getStoreForUrl()
| MediaWiki\ExternalStore\ExternalStoreFactory::getStoreForUrl | ( | $url, | |
| array | $params = [] ) |
Get the ExternalStoreMedium for a given URL.
$url is either of the form:
- a) "<proto>://<location>/<path>", for retrieval, or
- b) "<proto>://<location>", for storage
- Parameters
-
string $url array $params Map of ExternalStoreMedium::__construct context parameters
- Returns
- ExternalStoreMedium
- Exceptions
-
ExternalStoreException When the protocol is missing or not recognized
- Since
- 1.34
Definition at line 140 of file ExternalStoreFactory.php.
◆ getStoreLocationFromUrl()
| MediaWiki\ExternalStore\ExternalStoreFactory::getStoreLocationFromUrl | ( | $url | ) |
Get the location within the appropriate store for a given a URL.
- Parameters
-
string $url
- Returns
- string
- Exceptions
-
ExternalStoreException
- Since
- 1.34
Definition at line 157 of file ExternalStoreFactory.php.
References $url.
◆ getUrlsByProtocol()
| MediaWiki\ExternalStore\ExternalStoreFactory::getUrlsByProtocol | ( | array | $urls | ) |
- Parameters
-
string[] $urls
- Returns
- string[][] Map of (protocol => list of URLs)
- Exceptions
-
ExternalStoreException
- Since
- 1.34
Definition at line 172 of file ExternalStoreFactory.php.
References $url.
◆ getWriteBaseUrls()
| MediaWiki\ExternalStore\ExternalStoreFactory::getWriteBaseUrls | ( | ) |
- Returns
- string[] List of default base URLs for writes, e.g. [ "DB://cluster1" ]
- Since
- 1.34
Definition at line 62 of file ExternalStoreFactory.php.
◆ setLogger()
| MediaWiki\ExternalStore\ExternalStoreFactory::setLogger | ( | LoggerInterface | $logger | ) |
Definition at line 46 of file ExternalStoreFactory.php.
The documentation for this class was generated from the following file:
- includes/ExternalStore/ExternalStoreFactory.php
