ExternalStoreMemory.php

Go to the documentation of this file.

<?php
namespace MediaWiki\ExternalStore;
 
use UnexpectedValueException;
 
class ExternalStoreMemory extends ExternalStoreMedium {
    private static $data = [];
    private static $nextId = 0;
 
    public function fetchFromURL( $url ) {
        [ $location, $id ] = self::getURLComponents( $url );
        if ( $id === null ) {
            throw new UnexpectedValueException( "Missing ID in URL component." );
        }
 
        return self::$data[$location][$this->dbDomain][$id] ?? false;
    }
 
    public function batchFetchFromURLs( array $urls ) {
        $blobs = [];
        foreach ( $urls as $url ) {
            $blob = $this->fetchFromURL( $url );
            if ( $blob !== false ) {
                $blobs[$url] = $blob;
            }
        }
 
        return $blobs;
    }
 
    public function store( $location, $data ) {
        $index = ++self::$nextId;
        self::$data[$location][$this->dbDomain][$index] = $data;
 
        return "memory://$location/$index";
    }
 
    public function clear() {
        foreach ( self::$data as &$dataForLocation ) {
            unset( $dataForLocation[$this->dbDomain] );
        }
        unset( $dataForLocation );
        self::$data = array_filter( self::$data, 'count' );
        self::$nextId = 0;
    }
 
    private function getURLComponents( $url ) {
        // @phan-suppress-next-line PhanSuspiciousBinaryAddLists It's intentional
        [ $proto, $path ] = explode( '://', $url, 2 ) + [ null, null ];
        if ( $proto !== 'memory' ) {
            throw new UnexpectedValueException( "Got URL of protocol '$proto', not 'memory'." );
        } elseif ( $path === null ) {
            throw new UnexpectedValueException( "URL is missing path component." );
        }
 
        $parts = explode( '/', $path );
        if ( count( $parts ) > 2 ) {
            throw new UnexpectedValueException( "Too components in URL '$path'." );
        }
 
        return [ $parts[0], $parts[1] ?? null ];
    }
}
 
class_alias( ExternalStoreMemory::class, 'ExternalStoreMemory' );