carono/yii2-file-upload

File storage table

, _(*1)

Установка

1. Создать миграцию и наследовать её от carono\yii2file\FileUploadMigration

class m170927_171858_fu extends \carono\yii2file\FileUploadMigration
{
    public $tableName = '{{%file_upload}}';
}

1. Или выполнить yii migrate --migrationPath=@vendor/carono/yii2-file-upload/migrations

Как использовать

1. В вашу модель таблицы file_upload добавить трейт carono\yii2file\FileUploadTrait
2. После этого можно сохранять файлы следующим образом:
   FileUpload::startUpload('@runtime/test.txt')->process();
FileUpload::startUpload('http://example.com/file.txt')->process();
FileUpload::startUpload(yii\web\UploadedFile $file)->process();

По цепочке можно добавлять дополнительные свойства, _(*2)

FileUpload::startUpload('@runtime/img.png')
->slug('user_avatar') // поле slug
->data(['id'=>1]) // произвольные данные, записываются в data как json
->name('user_avatar.png') // сохраним файл в базе с новым именем
->folder('@app/new_destination') // сохраним файл в новой папке, по умолчанию @app/files
->delete(false) // не удалять файл источник по завершению, по умолчанию - удаляем
->process(); // сохраним модель

Свойства трейта

Методы трейта

Особенности

Необходимо учесть, что при переопределение функции getRealFileName(), будет влиять и на имя при сохранении новых файлов подробнее смотрите carono\yii2file\Uploader, _(*3)

Не забудьте добавить поведение yii\behaviors\TimestampBehavior для хранения времени добавления, _(*4)

Загрузку файла необходимо оборачивать try...catch, т.к. будут вызываться Exception при ошибках, _(*5)

Схема

, _(*6)