mihaildev/yii2-file-upload

Yii2 file upload

Yii 2 File Upload

Установка

Удобнее всего установить это расширение через composer., _(*1)

Либо запустить, _(*2)

php composer.phar require --prefer-dist mihaildev/yii2-file-upload "*"

или добавить, _(*3)

"mihaildev/yii2-file-upload": "*"

в разделе require вашего composer.json файла., _(*4)

Настройка Behavior для модели

    public function behaviors()
    {
        return [
            'file-upload' => [
                'class' => FileUploadBehavior::className(),
                /*
                'replacePairs' => [
                    '<modelId>' => 'id',// данный набор установлен по умолчанию
                ],
                */
                'attributes' => [
                    'file' =>[
                        //'handler' => FileUploadBehavior::HANDLER_FILE, // установлен по умолчанию
                        'path' => '@webroot/files/<modelId>/<fileName>.<fileExtension>',
                        'url' => '@web/files/<modelId>/<fileName>.<fileExtension>',
                    ],
                    'ava' => [
                        'handler' => FileUploadBehavior::HANDLER_IMAGE,
                        'path' => '@webroot/files/avatar/<modelId>/origin.<fileExtension>',
                        'url' => '@web/files/avatar/<modelId>/origin.<fileExtension>',
                        'imagine' => function($filename){
                                return Image::aligning($filename, 800, 800);
                            },
                        'saveOptions'=> ['quality' => 90],
                        'thumbs' => [
                            'icon' => [
                                'path' => '@webroot/files/avatar/<modelId>/icon.<fileExtension>',
                                'url' => '@web/files/avatar/<modelId>/icon.<fileExtension>',
                                'imagine' => function($filename){ return Image::thumbnail($filename, 50, 50);},
                                'saveOptions'=> ['quality' => 70],
                            ],
                            'preview' => [
                                'path' => '@webroot/files/avatar/<modelId>/preview.<fileExtension>',
                                'url' => '@web/files/avatar/<modelId>/preview.<fileExtension>',
                                'imagine' => function($filename){ return Image::thumbnail($filename, 200, 200);},
                                'saveOptions'=> ['quality' => 90],
                            ]
                        ]
                    ]
                ]
            ],
        ];
    }

Замечание!!! аттрибуты должны храниться в базе!, _(*5)

Обработка изображений производится с помощью библиотеки https://github.com/yiisoft/yii2-imagine, _(*6)

Функци Image::aligning не входит в стандартную библиотеку тут я использую свою библиотеку https://github.com/MihailDev/yii2-imagine, _(*7)

для получения пути в модели воспользуйтесь функцией $this->getUploadedFilePath($attributeName); для получения ссылки в модели воспользуйтесь функцией $this->getUploadedFileUrl($attributeName);, _(*8)

Для изображений $this->getUploadedFilePath($attributeName); - получить путь на основное изображение $this->getUploadedFilePath($attributeName, $thumbId); - получить путь на дополнительное изображение, _(*9)

$this->getUploadedFileUrl($attributeName); - получить ссылку на основное изображение $this->getUploadedFileUrl($attributeName, $thumbId); - получить ссылку на дополнительное изображение, _(*10)

пример на основе показанных выше настроек, _(*11)

$this->getUploadedFilePath('file'); $this->getUploadedFileUrl('file');, _(*12)

$this->getUploadedFilePath('ava'); $this->getUploadedFileUrl('ava');, _(*13)

$this->getUploadedFilePath('ava', 'icon'); $this->getUploadedFileUrl('ava', 'icon');, _(*14)

$this->getUploadedFilePath('ava', 'preview'); $this->getUploadedFileUrl('ava', 'preview');, _(*15)

Настройка и использование виджета

для файлов, _(*16)

= $form->field($model, 'file')->widget(\mihaildev\fileupload\FileUploadWidget::className(),[
                    'fileUrl' => $model->getUploadedFileUrl('file'),
                    'fileName' => 'Скачать'
                    ]

                ) ?>

для изображений, _(*17)

= $form->field($model, 'ava')->widget(\mihaildev\fileupload\ImageUploadWidget::className(),[
                    'imageOptions' => ['width' => '200'],
                    'imageUrl' => $model->getUploadedFileUrl('ava', 'preview')
                    ]

                ) ?>