Flysystem adapter for Selectel Cloud Storage

1.2.0 2017-09-27 13:16 UTC

This package is auto-updated.

Last update: 2024-04-08 21:27:05 UTC


Build Status StyleCI ScrutinizerCI Latest Version on Packagist Software License


This package requires PHP 5.6 or higher.


You can install the package via composer:

$ composer require argentcrusade/flysystem-selectel


From 1.0* to 1.1.0

New setting container_url was added. You can set your container's custom domain here (for example, and this option will be used when retrieving fully qualified URLs to files and directories.


use ArgentCrusade\Flysystem\Selectel\SelectelAdapter;
use ArgentCrusade\Selectel\CloudStorage\Api\ApiClient;
use ArgentCrusade\Selectel\CloudStorage\CloudStorage;
use League\Flysystem\Filesystem;

$api = new ApiClient('selectel-username', 'selectel-password');
$storage = new CloudStorage($api);
$container = $storage->getContainer('container-name');

$adapter = new SelectelAdapter($container);
$filesystem = new Filesystem($adapter);

Laravel Integration

You can use this adapter with Laravel's Storage System.

If you're running Laravel 5.5+ this package will auto-added to your providers list via auto-discovery feature (requires version 1.2+ of this package).

Laravel <= 5.4

Add ArgentCrusade\Flysystem\Selectel\SelectelServiceProvider::class to your providers list in config/app.php

 * Package Service Providers...

All Laravel versions

Add selectel disk to config/filesystems.php configuration file (disks section):

'selectel' => [
    'driver' => 'selectel',
    'username' => 'selectel-username',
    'password' => 'selectel-password',
    'container' => 'selectel-container',
    'container_url' => '',

container_url setting (new in version 1.1.0) allows you to override default Selectel's CDN domain (if you have custom domain attached). You may omit this setting if you're using default domain, file URLs will look like, where XXX - your unique subdomain (X-Storage-Url header value).

Now you can use Selectel disk as

use Illuminate\Support\Facades\Storage;

Storage::disk('selectel')->put('file.txt', 'Hello world');

Also you may want to set selectel as default disk to ommit disk('selectel') calls and use storage just as Storage::put('file.txt', 'Hello world').

For more info please refer to Laravel's Storage System documentation.

Unsupported methods

Due to the implementation of the Selectel API some methods are missing or may not function as expected.

Visibility management

Selectel provides visibility support only for Containers, but not for files. The change of visibility for the entire container instead of a single file/directory may be confusing for adapter users. Adapter will throw LogicException on getVisibility/setVisbility calls.

Directories management

Currently Selectel Adapter can display and delete only those directories that were created via createDir method. Dynamic directories (those that were created via write/writeStream methods) can not be deleted or listed as directory.

$fs = new Filesystem($adapter);

$fs->createDir('images'); // The 'images' directory can be deleted and will be listed as 'dir' in the results of `$fs->listContents()`.

$fs->write('documents/hello.txt'); // The 'documents' directory can not be deleted and won't be listed in the results of `$fs->listContents()`.

Note on Closing Streams

Selectel Adapter leaves the streams open after consuming them. Make sure that you've closed all streams that you opened.

Change log

Please see CHANGELOG for more information on what has changed recently.


$ vendor/bin/phpunit


Please see CONTRIBUTING for details.


If you discover any security related issues, please email instead of using the issue tracker.


The MIT License (MIT). Please see License File for more information.