* @defgroup ExternalStorage ExternalStorage
*/
+use MediaWiki\MediaWikiServices;
+
/**
* Interface for data storage in external repositories.
*
* @param array $params Associative array of ExternalStoreMedium parameters
* @return ExternalStoreMedium|bool The store class or false on error
*/
- public static function getStoreObject( $proto, array $params = array() ) {
- global $wgExternalStores;
-
- if ( !$wgExternalStores || !in_array( $proto, $wgExternalStores ) ) {
- return false; // protocol not enabled
- }
-
- $class = 'ExternalStore' . ucfirst( $proto );
-
- // Any custom modules should be added to $wgAutoLoadClasses for on-demand loading
- return class_exists( $class ) ? new $class( $params ) : false;
+ public static function getStoreObject( $proto, array $params = [] ) {
+ return MediaWikiServices::getInstance()
+ ->getExternalStoreFactory()
+ ->getStoreObject( $proto, $params );
}
/**
* @return string|bool The text stored or false on error
* @throws MWException
*/
- public static function fetchFromURL( $url, array $params = array() ) {
+ public static function fetchFromURL( $url, array $params = [] ) {
$parts = explode( '://', $url, 2 );
if ( count( $parts ) != 2 ) {
return false; // invalid URL
* or false on failure.
*/
public static function batchFetchFromURLs( array $urls ) {
- $batches = array();
+ $batches = [];
foreach ( $urls as $url ) {
$scheme = parse_url( $url, PHP_URL_SCHEME );
if ( $scheme ) {
$batches[$scheme][] = $url;
}
}
- $retval = array();
+ $retval = [];
foreach ( $batches as $proto => $batchedUrls ) {
$store = self::getStoreObject( $proto );
if ( $store === false ) {
* @return string|bool The URL of the stored data item, or false on error
* @throws MWException
*/
- public static function insert( $url, $data, array $params = array() ) {
+ public static function insert( $url, $data, array $params = [] ) {
$parts = explode( '://', $url, 2 );
if ( count( $parts ) != 2 ) {
return false; // invalid URL
* @return string|bool The URL of the stored data item, or false on error
* @throws MWException
*/
- public static function insertToDefault( $data, array $params = array() ) {
+ public static function insertToDefault( $data, array $params = [] ) {
global $wgDefaultExternalStore;
return self::insertWithFallback( (array)$wgDefaultExternalStore, $data, $params );
* @return string|bool The URL of the stored data item, or false on error
* @throws MWException
*/
- public static function insertWithFallback( array $tryStores, $data, array $params = array() ) {
+ public static function insertWithFallback( array $tryStores, $data, array $params = [] ) {
$error = false;
while ( count( $tryStores ) > 0 ) {
$index = mt_rand( 0, count( $tryStores ) - 1 );
* @throws MWException
*/
public static function insertToForeignDefault( $data, $wiki ) {
- return self::insertToDefault( $data, array( 'wiki' => $wiki ) );
+ return self::insertToDefault( $data, [ 'wiki' => $wiki ] );
}
}