ExternalStore.php

Go to the documentation of this file.

<?php
namespace MediaWiki\ExternalStore;
 
use MediaWiki\MediaWikiServices;
 
class ExternalStore {
    public static function getStoreObject( $proto, array $params = [] ) {
        try {
            return MediaWikiServices::getInstance()
                ->getExternalStoreFactory()
                ->getStore( $proto, $params );
        } catch ( ExternalStoreException ) {
            return false;
        }
    }
 
    public static function fetchFromURL( $url, array $params = [] ) {
        try {
            return MediaWikiServices::getInstance()
                ->getExternalStoreAccess()
                ->fetchFromURL( $url, $params );
        } catch ( ExternalStoreException ) {
            return false;
        }
    }
 
    public static function insert( $url, $data, array $params = [] ) {
        try {
            $esFactory = MediaWikiServices::getInstance()->getExternalStoreFactory();
            $location = $esFactory->getStoreLocationFromUrl( $url );
 
            return $esFactory->getStoreForUrl( $url, $params )->store( $location, $data );
        } catch ( ExternalStoreException ) {
            return false;
        }
    }
 
    public static function batchFetchFromURLs( array $urls ) {
        return MediaWikiServices::getInstance()->getExternalStoreAccess()->fetchFromURLs( $urls );
    }
 
    public static function insertToDefault( $data, array $params = [] ) {
        return MediaWikiServices::getInstance()->getExternalStoreAccess()->insert( $data, $params );
    }
 
    public static function insertWithFallback( array $tryStores, $data, array $params = [] ) {
        return MediaWikiServices::getInstance()
            ->getExternalStoreAccess()
            ->insert( $data, $params, $tryStores );
    }
 
    public static function insertToForeignDefault( $data, $wiki ) {
        return MediaWikiServices::getInstance()
            ->getExternalStoreAccess()
            ->insert( $data, [ 'domain' => $wiki ] );
    }
}
 
class_alias( ExternalStore::class, 'ExternalStore' );