ExternalStoreMedium.php

Go to the documentation of this file.

<?php
namespace MediaWiki\ExternalStore;
 
use InvalidArgumentException;
use Psr\Log\LoggerAwareInterface;
use Psr\Log\LoggerInterface;
use Psr\Log\NullLogger;
 
abstract class ExternalStoreMedium implements LoggerAwareInterface {
    protected $params = [];
    protected $dbDomain;
    protected $isDbDomainExplicit;
 
    protected $logger;
 
    public function __construct( array $params ) {
        $this->params = $params;
        if ( isset( $params['domain'] ) ) {
            $this->dbDomain = $params['domain'];
            $this->isDbDomainExplicit = empty( $params['isDomainImplicit'] );
        } else {
            throw new InvalidArgumentException( 'Missing DB "domain" parameter.' );
        }
 
        $this->logger = $params['logger'] ?? new NullLogger();
    }
 
    public function setLogger( LoggerInterface $logger ): void {
        $this->logger = $logger;
    }
 
    abstract public function fetchFromURL( $url );
 
    public function batchFetchFromURLs( array $urls ) {
        $retval = [];
        foreach ( $urls as $url ) {
            $data = $this->fetchFromURL( $url );
            // Dont return when false to allow for simpler implementations
            if ( $data !== false ) {
                $retval[$url] = $data;
            }
        }
 
        return $retval;
    }
 
    abstract public function store( $location, $data );
 
    public function isReadOnly( $location ) {
        return false;
    }
}
 
class_alias( ExternalStoreMedium::class, 'ExternalStoreMedium' );