kl83/yii2-file-storage

Yii2 file storage

Thursday, July 19, 2018
by kl83
Repository
1 Watchers
0 Stars
83 Installations

PHP
0 Dependents
0 Suggesters
0 Forks
0 Open issues
11 Versions
34 % Grown

The README.md

Yii2 file storage kit

, _(*1)

Module and widgets to upload files. The module uploads files to a random directory, saving their names. Urls, owners, uploading date and unique ID of files are stored in database. Also, several files may be concatenate at fileset which has own ID, owner and creation date. Files uploaded by authenticated users are stored in separate directories. Module has permissions check to manage files., _(*2)

Installation

The preferred way to install this extension is through composer., _(*3)

Either run, _(*4)

php composer.phar require kl83/yii2-file-storage ~1.2.0

or add, _(*5)

"kl83/yii2-file-storage": "~1.2.0"

to the require section of your composer.json file., _(*6)

And apply migrations., _(*7)

./yii migrate --migrationPath=@vendor/kl83/yii2-file-storage/migrations

Module configuration

config/web.php, _(*8)

...
"modules" => [
    ...
    "filestorage" => "kl83\filestorage\Module",
    ...
]
...

Option	Default	Description
(string) uploadDir	@webroot/uploads	Directory to save files.
(string) uploadDirUrl	@web/uploads	Base url to access uploaded files.
(integer) maxImageWidth	1920	If uploaded file is image and his width more then specified value, then image will be decresed.
(integer) maxImageHeight	1080	If uploaded file is image and his height more then specified value, then image will be decresed.
(array) managerRoles	[ 'admin', 'administrator' ]	Names of roles or permissions to manage files.

Module actions

defaut/delete (int $id) : null
$id - id of file to delete

Delete file., _(*9)

defaut/move (int $id, int $afterId) : null
$id - id of file to move
$afterId - set file position to be after that file, if value is empty, then file
    will be the first

Move file to some position inside fileset., _(*10)

defaut/upload (string|array $attributes = null, int $filesetId = null) : json
$attributes - key's of $_FILES array to be save, if not set, then all files to
    be saved
$filesetId - a fileset to which files will be attached,
    if it's -1 then new fileset will be created
return [
    'files' => [
        id and url of file,
    ],
    'fileset' => fileset id,
]

Uploads files., _(*11)

PicWidget usage

Widget to select and upload some one image., _(*12)

$form->field($model, 'picId')->widget('kl83\filestorage\widgets\PicWidget');

picId must be integer or null, _(*13)

Example model methods to get uploaded file

public function getPic()
{
    return $this->hasOne('kl83\filestorage\models\File', [ 'id' => 'picId' ]);
}
public function getPicUrl()
{
    return $this->getPic()->url;
}

PicSetWidget usage

Widget to select and upload some images., _(*14)

$form->field($model, 'picSetId')->widget('kl83\filestorage\widgets\PicSetWidget', [
    'maxImages' => 3, // default is unlimited
]);

picSetId must be integer attribute, _(*15)

Example model methods to get uploaded files

public function getPicSet()
{
    return $this->hasOne('kl83\filestorage\models\FileSet', [ 'id' => 'picSetId' ]);
}
public function getPics()
{
    // returns array of kl83\filestorage\models\File
    return $this->getPicSet()->getFiles();
}
public function getCover()
{
    $pics = $this->getPics();
    if ( is_array($pics) ) {
        return current($pics);
    }
}
public fucntion getCoverUrl()
{
    return $this->getCover()->url;
}

License

MIT License, _(*16)

The Versions

19/07 2018

dev-master

9999999-dev

Yii2 file storage

Sources Download

MIT BSD-3-Clause

The Requires

The Development Requires

by Aleksandr Solovyov

file yii2 storage

14/09 2017

v1.1.3

1.1.3.0

Yii2 file storage

Sources Download

MIT

The Requires

The Development Requires

by Aleksandr Solovyov

14/09 2017

v1.1.2

1.1.2.0

Yii2 file storage

Sources Download

MIT

The Requires

The Development Requires

by Aleksandr Solovyov

14/09 2017

v1.1.1

1.1.1.0

Yii2 file storage

Sources Download

MIT

The Requires

The Development Requires

by Aleksandr Solovyov

14/09 2017

v1.1.0

1.1.0.0

Yii2 file storage

Sources Download

MIT

The Requires

The Development Requires

by Aleksandr Solovyov

13/09 2017

v1.0.4

1.0.4.0

Yii2 file storage

Sources Download

MIT

The Requires

The Development Requires

by Aleksandr Solovyov

17/08 2017

v1.0.3

1.0.3.0

Yii2 file storage

Sources Download

MIT

The Requires

The Development Requires

flow/jsonpath @dev

by Aleksandr Solovyov

19/07 2017

v1.0.2

1.0.2.0

Yii2 file storage

Sources Download

MIT

The Requires

The Development Requires

flow/jsonpath @dev

by Aleksandr Solovyov

19/07 2017

v1.0.1

1.0.1.0

Yii2 file storage

Sources Download

MIT

The Requires

The Development Requires

flow/jsonpath @dev

by Aleksandr Solovyov

18/07 2017

v1.0.0

1.0.0.0

Yii2 file storage

Sources Download

MIT

The Requires

The Development Requires

flow/jsonpath @dev

by Aleksandr Solovyov

29/05 2017

0.0.1

0.0.1.0

Yii2 file storage

Sources Download

BSD-3-Clause

The Requires

php >=5.4.0
yiisoft/yii2 ^2.0.0

The Development Requires

flow/jsonpath @dev

by Aleksandr Solovyov

file yii2 storage

library yii2-file-storage