carono / yii2-file-upload
File storage table
Installs: 2 463
Dependents: 0
Suggesters: 0
Security: 0
Stars: 2
Watchers: 2
Forks: 1
Open Issues: 0
Type:yii2-extension
Requires
- carono/yii2-migrate: @stable
- yiisoft/yii2: ^2.0
README
Установка
- Создать миграцию и наследовать её от
carono\yii2file\FileUploadMigration
class m170927_171858_fu extends \carono\yii2file\FileUploadMigration { public $tableName = '{{%file_upload}}'; }
- Или выполнить
yii migrate --migrationPath=@vendor/carono/yii2-file-upload/migrations
Как использовать
- В вашу модель таблицы
file_upload
добавить трейтcarono\yii2file\FileUploadTrait
- После этого можно сохранять файлы следующим образом:
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 при ошибках