ExternalStoreMwstore.php

Go to the documentation of this file.

<?php
class ExternalStoreMwstore extends ExternalStoreMedium {
    public function fetchFromURL( $url ) {
        $be = FileBackendGroup::singleton()->backendFromPath( $url );
        if ( $be instanceof FileBackend ) {
            // We don't need "latest" since objects are immutable and
            // backends should at least have "read-after-create" consistency.
            return $be->getFileContents( array( 'src' => $url ) );
        }

        return false;
    }

    public function batchFetchFromURLs( array $urls ) {
        $pathsByBackend = array();
        foreach ( $urls as $url ) {
            $be = FileBackendGroup::singleton()->backendFromPath( $url );
            if ( $be instanceof FileBackend ) {
                $pathsByBackend[$be->getName()][] = $url;
            }
        }
        $blobs = array();
        foreach ( $pathsByBackend as $backendName => $paths ) {
            $be = FileBackendGroup::singleton()->get( $backendName );
            $blobs = $blobs + $be->getFileContentsMulti( array( 'srcs' => $paths ) );
        }

        return $blobs;
    }

    public function store( $backend, $data ) {
        $be = FileBackendGroup::singleton()->get( $backend );
        if ( $be instanceof FileBackend ) {
            // Get three random base 36 characters to act as shard directories
            $rand = wfBaseConvert( mt_rand( 0, 46655 ), 10, 36, 3 );
            // Make sure ID is roughly lexicographically increasing for performance
            $id = str_pad( UIDGenerator::newTimestampedUID128( 32 ), 26, '0', STR_PAD_LEFT );
            // Segregate items by wiki ID for the sake of bookkeeping
            $wiki = isset( $this->params['wiki'] ) ? $this->params['wiki'] : wfWikiID();

            $url = $be->getContainerStoragePath( 'data' ) . '/' . rawurlencode( $wiki );
            $url .= ( $be instanceof FSFileBackend )
                ? "/{$rand[0]}/{$rand[1]}/{$rand[2]}/{$id}" // keep directories small
                : "/{$rand[0]}/{$rand[1]}/{$id}"; // container sharding is only 2-levels

            $be->prepare( array( 'dir' => dirname( $url ), 'noAccess' => 1, 'noListing' => 1 ) );
            if ( $be->create( array( 'dst' => $url, 'content' => $data ) )->isOK() ) {
                return $url;
            }
        }

        return false;
    }
}