Verseles\flyclone

PHP wrapper for rclone

supports local disk, dropbox, ftp, sftp, google drive, mega, s3, b2 (any compatible) and others can be easily added via pr.

progress support.

installation

composer require verseles/flyclone

usage

list local files

```php use Verseles\Flyclone\Rclone; use Verseles\Flyclone\Providers\LocalProvider; $left_side = new LocalProvider('mydisk'); // nickname $rclone = new Rclone($left_side); var_dump($rclone->ls('/home/')); // returns array ```

list files from mega server

```php use Verseles\Flyclone\Rclone; use Verseles\Flyclone\Providers\MegaProvider; $left_side = new MegaProvider('myserver',[ 'user'=>'johnivy@pear.com', 'pass'=> Rclone::obscure('applesux') ]); $rclone = new Rclone($left_side); var_dump($rclone->ls('/docs')); // returns array ```

copy from local disk to mega

```php use Verseles\Flyclone\Rclone; use Verseles\Flyclone\Providers\LocalProvider; use Verseles\Flyclone\Providers\MegaProvider; $left_side = new LocalProvider('mydisk'); // name $right_side = new MegaProvider('myremote',[ 'user'=>'your@email.com', 'pass'=> Rclone::obscure('4ppl35u*') ]); $rclone = new Rclone($left_side, $right_side); $rclone->copy('/home/appleinc/index.html', '/docs'); // always true, otherwise throws error ```

move from local disk to the same local disk

```php use Verseles\Flyclone\Rclone; use Verseles\Flyclone\Providers\LocalProvider; $samedisk = new LocalProvider('mydisk'); // name $rclone = new Rclone($samedisk); $rclone->copy('/home/appleinc/index.html', '/home/www/'); // always true, otherwise throws error ```

copy to dropbox with progress every sec

```php use Verseles\Flyclone\Rclone; use Verseles\Flyclone\Providers\LocalProvider; use Verseles\Flyclone\Providers\DropboxProvider; $left_side = new LocalProvider('mydisk'); // nickname $right_side = new DropboxProvider('myremote', [ 'client_id' => 'your_dropbox_client_id', 'client_secret' => 'your_dropbox_client_secret', 'token' => 'your_dropbox_token', ]); $rclone = new Rclone($left_side, $right_side); $rclone->copy('/home/appleinc/index.html', '/home/www/', [], static function ($type, $buffer) use ($rclone) { var_dump($rclone->getProgress()); }); ```

tips - read before use.

of course, you need known how rclone works.
rclone class and providers classes always support any flag listed at rclone documentation, often as 3rd argument. but
any flag, parameter or option passed like --parameter-here, in this lib is a array like ['parameter-here'='value', 'max-depth' => 3, 'any'=>'1']
if you inform only one provider ('left side'), in commands like copy/move we assume 'right side' as the same 'left side' provider. which means a copying/moving to the same disk.
we don't have a great doc for now so open a issue always you have a doubt. remember to be descriptful.
~~wip~~ to-do
[x] ~~add progress support~~
[x] ~~add timeout support~~
[x] ~~add more commands~~
[x] ~~add tests~~
- [x] ~~use docker and docker compose for tests~~
[ ] send meta details like file id in some storage system like google drive

testing

install docker and docker compose, then run:

cp .env.example .env
make

there are others tests (test_all, test_gdrive, etc), but you'll need fill .env file properly.

contribution

you know how to do that.

license

Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International