Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/yiicod/yii2-fileupload
https://github.com/yiicod/yii2-fileupload
blueimp-jquery php uploader yii2 yii2-extension
Last synced: 27 days ago
JSON representation
- Host: GitHub
- URL: https://github.com/yiicod/yii2-fileupload
- Owner: yiicod
- License: other
- Created: 2017-12-16T21:01:19.000Z (about 7 years ago)
- Default Branch: master
- Last Pushed: 2018-11-03T21:36:22.000Z (about 6 years ago)
- Last Synced: 2024-11-13T14:55:02.951Z (about 2 months ago)
- Topics: blueimp-jquery, php, uploader, yii2, yii2-extension
- Language: PHP
- Size: 31.3 KB
- Stars: 7
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE.md
Awesome Lists containing this project
README
Yii File uploader based on blueimp jquery-file-upload
=====================================================
[](https://packagist.org/packages/yiicod/yii2-fileupload) [](https://packagist.org/packages/yiicod/yii2-fileupload) [](https://scrutinizer-ci.com/g/yiicod/yii2-fileupload/?branch=master)[](https://codeclimate.com/github/yiicod/yii2-fileupload)
File uploader base on blueimp jquery-file-upload. You can write easy themes for
uploader. This extension provide you all workflow for upload files on your server.
#### Install:
The preferred way to install this extension is through [composer](http://getcomposer.org/download/).
Either run
```
php composer.phar require --prefer-dist yiicod/yii2-fileupload "*"
```
or add
```json
"yiicod/yii2-fileupload": "*"
```
to the require section of your composer.json.
#### Config
Set to controller
```php
public function actions()
{
return array(
'fileUpload' => [
'class' => 'yiicod\fileupload\actions\FileUploadAction',
],
);
}
```
Add behavior for model
```php
public function behaviors()
{
return [
'FileUploadBehavior' => [
'class' => 'yiicod\fileupload\models\behaviors\FileUploadBehavior',
'sourceRepositoryClass' => [
'class' => SourceRepository::class,
'uploadDir' => Yii::getAlias('@webroot/uploads'), // Base dir for file
'uploadUrl' => '/uploads', // Base url to folder
],
'fields' => array('logo'),
],
];
}
```
#### Usage
```php
FileUploadWidget::widget([
'id' => 'fileuploader',
'model' => Model::class,
'attribute' => 'modelAttribute',
'allowedExtensions' => array('jpeg', 'jpg', 'gif', 'png'),
'maxFileSize' => 2 * 1024 * 1024, // limit in server-side and in client-side 2mb
'uploadDir' => Yii::getPathOfAlias('@webroot/uploads/temp'), // temp base dir
'uploadUrl' => Yii::$app->getBaseUrl(true) . '/uploads/temp/', // temp base url
'uploader' => UserAvatar::class,
'userData' => [], // Any data for UploaderInterface
'maxUploads' => -1, // defaults to -1 (unlimited)
'theme' => [
'class' => BaseTheme::class, //Implements yiicod\fileupload\base\ThemeInterface
'multiple' => false, // allow to add multiple file uploads
'buttonText' => 'Upload file',
'dropFilesText' => 'Upload or Drop here',
'clientOptions' => array(
//For chunk uploded
'maxChunkSize' => 10000000
),
],
'options' => [],
'defaultUrl' => 'site/fileUpload',
]);
```
Then add uploader, which extends yiicod\fileupload\base\UploaderInterface and provides functionality to handle uploaded file
#### Upload immediately
```php
class UserAvatar implement UploaderInterface {
/**
* Event for coco uploader
* @param string $fullFileName Full file path
* @param Array $userdata Userdata from widget
* @param Array $results Uploaded result file
* @return Array or null
*/
public function uploading($fullFileName, $userdata, $results)
{
$model = new UserModel();
//Save to temp
$model->onAfterFileUploaded($fullFileName, 'logo');
//After save requered set
if ($model->save()) {
return [
'url' => $model->getFileSrc('logo'),
'...' => '...'
];
)else{
//Delete temp uploaded file
$model->resetFile('logo');
return [
'error' => 'Insert error message'
'...' => '...'
];
};
}
}
}
```
#### Upload on submit
```php
class UserAvatar implement UploaderInterface{
/**
* Event for coco uploader
* @param string $fullFileName Full file path
* @param Array $userdata Userdata from widget
* @param Array $results Uploaded result file
* @return Array or null
*/
public function uploading($fullFileName, $userdata, $results)
{
$model = new UserModel();
//Save to temp
$model->onAfterFileUploaded($fullFileName, 'logo');
}
}
```