scratcher28/flysystem-mailru-cloud

Flysystem Adapter for the mail.ru cloud

v0.0.8 2021-12-06 12:26 UTC

Requires

• php: ^7.0|^8.0
• ext-mbstring: *
• league/flysystem: ^1.1
• scratcher28/cloud-mail-ru: dev-master

MIT

• freecod

• mail.ru
• Flysystem
• mail.ru cloud
• flysystem-mailru
• mailrucloud

README

This package contains a Flysystem adapter for Mail.ru Cloud. Under the hood, the Friday14/mailru-cloud-php is used.

Installation

You can install the package via composer:

composer require freecod/flysystem-mailru-cloud

Usage

This package used unofficial API client for cloud.mail.ru - Friday14/mailru-cloud-php

To initialize the client, enter your login (without @domain), domain (mail.ru, list.ru, etc) and password to work with the cloud.

use Friday14\Mailru\Cloud;
use Freecod\FlysystemMailRuCloud\MailRuCloudAdapter;

$client = new Cloud('login', 'password', 'mail.ru');

$adapter = new MailRuCloudAdapter($client);

$filesystem = new Filesystem($adapter);

Usage in Laravel

To used this package as driver for Laravel Storage drive, you must make Service Provider for extend storage drivers

<?php

namespace App\Providers;

use Freecod\FlysystemMailRuCloud\MailRuCloudAdapter;
use Friday14\Mailru\Cloud;
use League\Flysystem\Filesystem;
use Illuminate\Support\ServiceProvider;

class MailRuCloudServiceProvider extends ServiceProvider
{
    public function boot()
    {
        \Storage::extend('mailru', function ($app, $config) {
            $client = new Cloud(
                $config['login'],
                $config['password'],
                $config['domain']
            );
            
            return new Filesystem(new MailRuCloudAdapter($client));
        });
    }
}

Now add this Service Provider to config/app.php in section "providers":

App\Providers\MailRuCloudServiceProvider::class,

Final step - add to config/filesystems.php in section "disks"

    'mailru' => [
        'driver' => 'mailru',
        'login' => env('MAIL_RU_CLOUD_LOGIN'),
        'domain' => env('MAIL_RU_CLOUD_DOMAIN'),
        'password' => env('MAIL_RU_CLOUD_PASSWORD'),
    ],

Usage

    $data = \Storage::disk('mailru')->files();

License

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