README

文件上传器。基于 jQuery 文件上传插件 的 Yii2 扩展。

安装

安装此扩展的首选方式是通过 composer。

运行以下命令

php composer.phar require --prefer-dist joni-jones/yii2-fuploader "*"

或者在您的 composer.json 文件的 require 部分添加以下内容

"joni-jones/yii2-fuploader": "*"

使用方法

扩展安装后，您只需在代码中简单使用它

<?= \jones\fuploader\FileUpload::widget();?>

1. 指定 action 属性以设置上传 URL

   FileUpload::widget([
       'action' => Url::to(['some_action'])
   ]);

2. 指定任何 jQuery 文件上传选项

   FileUpload::widget([
       'options' => [
           'plugin' => [
               'formData' => 'some data',
           ],
       ],
       'content' => 'Select image',
   ]);

3. 要设置插件事件或回调，请使用小部件的 clientEvents 选项

   FileUpload::widget([
           'clientEvents' => [
               'done' => 'function(e, data){console.log(data);}',
               'fail' => 'function(e, data){console.log(data);}'
           ]
   ]);

4. 您还可以使用扩展动作在上传后存储一些文件详细信息。例如，在数据库中更新用户头像属性。

   public function actions()
   {
           return[
               'some_action' => [
                   'class' => 'jones\fuploader\actions\UploadAction',
                   'path' => 'some path for uploading',
                   'url' => 'some url for uploaded file', //this url will be accessable in action response
                   'callback' => [$this, 'someCallback'] //any callable function
               ]
           ];
   }

5. 如果指定了回调，它将在上传后触发

   public function someCallback($request, $files)
   {
       // some code
   }

UploadAction() 返回 JSON 格式的响应。这是响应的结构

```json
{"message": "some success message", "files": [{"name": "", "ext": ""}], "url": "url to files directory"}
```

```json
{"reason": "message with reason why file does not uploaded"}
```

此外，响应的状态码也将返回在头部信息中。

许可证

MIT