carono/yii2-file-upload

File storage table

1.2.3 2022-10-13 20:08 UTC

Requires

• carono/yii2-migrate: @stable
• yiisoft/yii2: ^2.0

MIT

• Aleksandr Kasyanov

• extension
• yii2

README

Установка

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();

По цепочке можно добавлять дополнительные свойства

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

Не забудьте добавить поведение yii\behaviors\TimestampBehavior для хранения времени добавления

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

Схема