README.md

Yii 2 JustCoded Files extension

Yii 2 extension for upload files

Installation

The preferred way to install this extension is through composer.

Either run

composer require --prefer-dist justcoded/yii2-filestorage "*"

or add

"justcoded/yii2-filestorage": "*"

to the require section of your composer.json file.

Apply migrations by following command:

php yii migrate --migrationPath="@vendor/justcoded/yii2-filestorage/migrations"

Add application component to configuration file:

'storage' => [
    'class' => \justcoded\yii2\filestorage\storage\Filestorage::class,
    'adapter' => \justcoded\yii2\filestorage\storage\adapters\LocalAdapter::class,
    'adapterConfig' => [Yii::getAlias('files')]
],

Usage

Once the extension is installed, simply use it in your ActiveRecord model by:

// One to Many
public function getFiles()
{
    return $this->morphMany(FlyFile::class, 'fileable', ['attribute' => 'files'], 'fly_file_relation', 'file_id');
}

// One to One
public function getAvatar()
{
    return $this->morphOne(FlyFile::class, 'fileable', ['attribute' => 'avatar'], 'fly_file_relation', 'file_id');
}

In controller:

public function actions()
{
    return [
        'avatar' => [
            'class' => UploadAction::class,
            'storage' => 'storage',
            'model' => User::class,
            'relation' => 'avatar',
            'attribute' => 'avatar',
        ],
        'media' => [
            'class' => UploadAction::class,
            'storage' => 'storage',
            'model' => User::class,
            'relation' => 'files',
            'attribute' => 'file',
            'multiple' => true,
        ],
        'delete' => [
            'class' => DeleteAction::class,
        ],
        'resize' => [
            'class' => ImageResizeAction::class,
        ]
    ];
}