图片上传几乎是应用必备,前面也针对 kartik 的 fileinput 做了一篇详细的说明,不过很多人反馈各种问题,下面针对 webuploader 的使用单独写了一个组件。该组件可以更好的处理 yii2 在图片上传过程中带来的一系列问题,目前支持多图多字段多modal的混合上传。
介绍之前我们先演示下效果。
安装
推荐使用composer进行安装
1
|
$ php composer.phar require bailangzhan/yii2-webuploader dev-master |
使用
params.php或者params-local.php内增加webuploader和domain配置项
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
|
// 图片服务器的域名设置,拼接保存在数据库中的相对地址,可通过web进行展示 'domain' => 'http://blog.m/' , 'webuploader' => [ // 后端处理图片的地址,value 是相对的地址 'uploadurl' => 'blog/upload' , // 多文件分隔符 'delimiter' => ',' , // 基本配置 'baseconfig' => [ 'defaultimage' => 'http://img1.imgtn.bdimg.com/it/u=2056478505,162569476&fm=26&gp=0.jpg' , 'disableglobaldnd' => true, 'accept' => [ 'title' => 'images' , 'extensions' => 'gif,jpg,jpeg,bmp,png' , 'mimetypes' => 'image/*' , ], 'pick' => [ 'multiple' => false, ], ], ], |
webuploader['baseconfig'] 参考 webuploader官方的参数说明
视图文件
单图
1
2
3
4
|
<?php echo $form ->field( $model , 'file' )->widget( 'manks\fileinput' , [ ]); ?> |
多图
1
2
3
4
5
6
7
8
9
10
11
12
|
<?php echo $form ->field( $model , 'file2' )->widget( 'manks\fileinput' , [ 'clientoptions' => [ 'pick' => [ 'multiple' => true, ], // 'server' => url::to('upload/u2'), // 'accept' => [ // 'extensions' => 'png', // ], ], ]); ?> |
控制器 controller的地址可以在params.php或者params-local.php中配置 yii::$app->params['webuploader']['uploadurl'], 也可以在 clientoptions中配置 server 项。控制器需要返回的数据格式如下
1
2
3
4
|
// 错误时 { "code" : 1, "msg" : "error" } // 正确时, 其中 attachment 指的是保存在数据库中的路径,url 是该图片在web可访问的地址 { "code" : 0, "url" : "http://domain/图片地址" , "attachment" : "图片地址" } |
clientoptions同样参考 webuploader官方的参数说明
注意
如果是修改的多图片操作,务必保证 $model->file = 'src1,src2,src3,...'; 或者 $model->file = ['src1', 'src2'. 'src3', ...];
以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持服务器之家。
原文链接:http://www.manks.top/document/yii2-webuploader.html