railroad/remotestorage

Remote storage service

remotestorage

Wrapper for slightly easier use of league/flysystem with AWS S3 by our Laravel application., _(*1)

• remotestorage
  • Installation, Configuration, Use
  • Installation
  • Configuration
  • Use
  • RemoteStorageService
  • put
    • Usage Example
    • Parameters
    • Responses
  • read
    • Usage Example
    • Parameters
    • Responses
  • exists
    • Usage Example
    • Parameters
    • Responses
  • delete
    • Usage Example
    • Parameters
    • Responses
  • create_dir
  • rename
  • copy
  • get_mimetype
  • get_timestamp
  • get_size
  • delete_dir

Installation, Configuration, Use

Installation

Run $ composer vendor:publish to copy the package's configuration file "/config/remotestorage.php" to your application's "/config" directory., _(*2)

(assuming you're using Composer, Laravel, and AWS S3), _(*3)

Configuration

Define the following environmental variables with appropriate values:, _(*4)

• AWS_ACCESS_KEY_ID
• AWS_SECRET_ACCESS_KEY
• AWS_DEFAULT_REGION
• AWS_BUCKET

Add the service provider (\Railroad\RemoteStorage\Providers\RemoteStorageServiceProvider) to the 'providers array in you application's /config/app.php:, _(*5)

'providers' => [
    # ...
    \Railroad\RemoteStorage\Providers\RemoteStorageServiceProvider::class,
]

Run $ php artisan vendor:publish to copy the config file and create a remotestorage.php file in your application's /config directory. This will take the values you supplied in the .env file and pass them needed., _(*6)

Use

Inject the Railroad\RemoteStorage\Services\RemoteStorageService class where needed, _(*7)

/** @var Railroad\RemoteStorage\Services\RemoteStorageService $remoteStorageService */
protected $remoteStorageService;

public function __constructor(Railroad\RemoteStorage\Services\RemoteStorageService $remoteStorageService){
    $this->remoteStorageService = $remoteStorageService;
}

Include namespace at top of file:, _(*8)

use Railroad\RemoteStorage\Services;

... to save yourself having to specify the namespace everywhere:, _(*9)

/** @var RemoteStorageService $remoteStorageService */
protected $remoteStorageService;

public function __constructor(RemoteStorageService $remoteStorageService){
    $this->remoteStorageService = $remoteStorageService;
}

, _(*10)

RemoteStorageService

All methods below are public., _(*11)

put

Usage Example(s)

$upload = $this->remoteStorageService->put($filenameRelative, $filenameAbsolute);

/** Upload product thumbnail on remote storage using remotestorage package.
 * Throw an error JSON response if the upload failed or return the uploaded thumbnail url.
 *
 * @param Request $request
 * @return JsonResponse
 */
public function uploadThumbnail(Request $request)
{
    $target = $request->get('target');
    $upload = $this->remoteStorageService->put($target, $request->file('file'));

    throw_if(
        (!$upload),
        new JsonResponse('Upload product thumbnail failed', 400)
    );

    return new JsonResponse(
        $this->remoteStorageService->url($target), 201
    );
}

Parameters

Responses

read

Usage Example(s)

$file = $this->remoteStorageService->read($filenameRelative);

Parameters

Responses

exists

Usage Example(s)

$exists = $this->remoteStorageService->exists('foo/bar.jpg');

/** 
 * @param Request $request
 * @return JsonResponse
 */
public function uploadThumbnailIfDoesNotAlreadyExist(Request $request)
{
    $target = 'foo/' . $request->get('target');    
    if(!$this->remoteStorageService->exists('foo/')){
        $upload = $this->remoteStorageService->put($target, $request->file('file'));
        throw_if((!$upload), new JsonResponse('Upload product thumbnail failed', 400));
    }
    return new JsonResponse(['exists' => true]);
}

Parameters

Responses

delete

Usage Example(s)

$this->remoteStorageService->delete('foo/bar.jpg');

public function deleteThumbnail(Request $request)
{
    $target = $request->get('target');    
    $delete = $this->remoteStorageService->delete('foo/' . $target);
    throw_if((!$delete), new JsonResponse('product thumbnail deletion failed', 400));
    return new JsonResponse(['deleted' => true]);
}

Parameters

Responses

create_dir

[TODO], _(*12)

rename

[TODO], _(*13)

copy

[TODO], _(*14)

get_mimetype

[TODO], _(*15)

get_timestamp

[TODO], _(*16)

get_size

[TODO], _(*17)

delete_dir

[TODO], _(*18)