argentcrusade / flysystem-selectel
Flysystem adapter for Selectel Cloud Storage
Installs: 117 911
Dependents: 3
Suggesters: 1
Security: 0
Stars: 12
Watchers: 3
Forks: 15
Open Issues: 2
Requires
- php: >=5.6
- argentcrusade/selectel-cloud-storage: ~1.1
- league/flysystem: ~1.0
Requires (Dev)
- mockery/mockery: ~0.9
- phpunit/phpunit: ~5.0
README
Requirements
This package requires PHP 5.6 or higher.
Installation
You can install the package via composer:
$ composer require argentcrusade/flysystem-selectel
Upgrade
From 1.0* to 1.1.0
New setting container_url
was added. You can set your container's custom domain here (for example, https://static.example.org
) and this option will be used when retrieving fully qualified URLs to files and directories.
Usage
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... */ ArgentCrusade\Flysystem\Selectel\SelectelServiceProvider::class,
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' => 'https://static.example.org', ]
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 http://XXX.selcdn.ru/container_name/path/to/file.txt
, 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.
Testing
$ vendor/bin/phpunit
Contributing
Please see CONTRIBUTING for details.
Security
If you discover any security related issues, please email zurbaev@gmail.com instead of using the issue tracker.
License
The MIT License (MIT). Please see License File for more information.