Download the PHP package kl83/yii2-file-storage without Composer

Yii2 file storage kit

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.

Installation

The preferred way to install this extension is through composer.

Either run

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

or add

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

to the require section of your composer.json file.

And apply migrations.

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

Module configuration

config/web.php

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

Module actions

Delete file.

Move file to some position inside fileset.

Uploads files.

PicWidget usage

Widget to select and upload some one image.

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

picId must be integer or null

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.

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

picSetId must be integer attribute

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