PHP 多图上传,图片批量上传插件,webuploader.js,百度文件上传插件(案例教程)
WebUploader作用:
使用WebUploader还可以批量上传文件、支持缩略图等等众多参数选项可设置,以及多个事件方法可调用,你可以随心所欲的定制你要的上传组件。
使用:
1、导入Css样式文件:
1
2
|
< link rel = "stylesheet" type = "text/css" href = "css/webuploader.css" > < link rel = "stylesheet" type = "text/css" href = "css/webstyle.css" > |
2、定义html:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
|
< div class = "demo" > < h3 style = "border-bottom: 1px solid #dadada;" >多图上传</ h3 > < div id = "uploader" > < div class = "queueList" style = "min-height:150px;" > </ div > < div class = "statusBar" style = "display:block; border-top: 1px solid #dadada;" > < div class = "progress" > < span class = "text" >0%</ span > < span class = "percentage" ></ span > </ div >< div class = "info" ></ div > < div id = "dndArea" class = "btns" > < div id = "filePick" style = "float:left;" >选择图片</ div > < div class = "uploadBtn" >开始上传</ div > </ div > </ div > </ div > </ div > |
1、准备一个按钮#filePicker
2、准备一个用来存放添加的文件信息列表的容器.queueList
3、准备一个上传按钮.uploadBtn
2、javascript部分:
首先创建Web Uploader实例:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
|
// 实例化 uploader = WebUploader.create({ /*************** 重要参数 *************/ //是否自动上传(true是,false否) auto: false , //flash文件地址 swf: './Uploader.swf' , //上传访问的地址 server: './upload.php' , //每次请求附带的参数 formData: {act: 'ad_image' }, //定义选择文件的按钮 pick: {id: '#filePick' , label: '添加图片' }, /*************** 其他参数 ***************/ // 指定托动区 dnd: '#dndArea' , // 禁掉全局的拖拽功能。这样不会出现图片拖进页面的时候,把图片打开。 disableGlobalDnd: false , // 指定监听paste事件的容器,如果不指定,不启用此功能。此功能为通过粘贴来添加截屏的图片 paste: '#uploader' , // 指定可以上传那些类型的图片 accept: { title: 'Images' , extensions: 'jpg,jpeg,png' , mimeTypes: 'image/jpg,image/jpeg,image/png' }, thumb:{ 110, height: 110, // 图片质量,只有type为`image/jpeg`的时候才有效。 quality: 70, // 是否允许放大,如果想要生成小图的时候不失真,此选项应该设置为false. allowMagnify: false , // 是否允许裁剪。 crop: true , // 为空的话则保留原有图片格式。 // 否则强制转换成指定的类型。 type: 'image/jpeg' }, compress:{ 1600, height: 1600, // 图片质量,只有type为`image/jpeg`的时候才有效。 quality: 90, // 是否允许放大,如果想要生成小图的时候不失真,此选项应该设置为false. allowMagnify: false , // 是否允许裁剪。 crop: false , // 是否保留头部meta信息。 preserveHeaders: true , // 如果发现压缩后文件大小比原来还大,则使用原来图片 // 此属性可能会影响图片自动纠正功能 noCompressIfLarger: false , // 单位字节,如果图片大小小于此值,不会采用压缩。 compressSize: 0, // 强制转换成指定的类型。 type: 'image/jpeg' }, //允许在文件传输时提前把下一个文件准备好 【默认值:false】 prepareNextFile: true , //是否要分片处理大文件上传【默认值:false】 // chunked: false, //分多大一片【默认值:5242880】 // chunkSize: 512 * 1024, //如果某个分片由于网络问题出错,允许自动重传多少次!【默认值:2】 // chunkRetry:10, //上传并发数。允许同时最大上传进程数【默认值:3】 // threads:3, //文件上传方式,POST或者GET【默认值:'POST'】 // method:'POST', //最大上传数量,(验证文件总数量, 超出则不允许加入队列)。 fileNumLimit: 20, // 验证文件总大小是否超出限制, 超出则不允许加入队列 fileSizeLimit: 200 * 1024 * 1024, // 验证单个文件大小是否超出限制, 超出则不允许加入队列 fileSingleSizeLimit: 50 * 1024 * 1024 }); |
接着监听fileQueued事件,即当有文件添加进来的时候,通过uploader.makeThumb来创建图片预览图
至于事件中用到的方法就不写出来的,需要研究的可以下载源码查看学习!(uploader.makeThumb也是写在方法里面去了)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
|
// 当文件被加入队列以后触发。 uploader.onFileQueued = function (file) { fileCount++; fileSize += file.size; if (fileCount === 1) { $placeHolder.addClass( 'element-invisible' ); $statusBar.show(); } addFile(file); setState( 'ready' ); updateTotalProgress(); }; // 上传过程中.... uploader.onUploadProgress = function (file, percentage) { var $li = $( '#' + file.id), $percent = $li.find( '.progress span' ); $percent.css( 'width' , percentage * 100 + '%' ); percentages[ file.id ][ 1 ] = percentage; updateTotalProgress(); }; // 当文件被移除队列后触发。 uploader.onFileDequeued = function (file) { fileCount--; fileSize -= file.size; if (!fileCount) { setState( 'pedding' ); } removeFile(file); updateTotalProgress(); }; |
最后是上传状态提示了,
当文件上传过程中, 上传成功,上传失败,上传完成都分别对应
uploadProgress, uploadSuccess, uploadError, uploadComplete事件。
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
|
// 文件上传成功 uploader.on( 'uploadSuccess' , function ( file,data ) { var $li = $( '#' + file.id), $percent = $li.find( '.success' ); $dsf = $( '<input type="hidden" name="images[]" value="' +data.file+ '">' ).appendTo($li), setState( 'confirm' ); }); // 文件上传过程中创建进度条实时显示。 uploader.on( 'uploadProgress' , function ( file, percentage ) { setState( 'uploading' ); }); // 文件上传失败,显示上传出错 uploader.on( 'uploadError' , function ( file ) { setState( 'finish' ); }); uploader.on( "uploadAccept" , function ( file, data){ if ( data.success== true ) { // 通过return false来告诉组件,此文件上传有错。 return true ; } else { return false ; } }); |
至于事件中用到的方法就不写出来的,需要研究的可以下载源码查看学习!
2、PHP部分:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
|
<?php date_default_timezone_set( "Asia/Shanghai" ); // 1、图片文件上传处理 (上传逻辑就自己写了。) // 2、返回值 // 假如这是上传成功后得到的文件名 $file = date ( "Ymd_" ).rand(1000,9999). '.jpg' ; $res = array ( 'success' => true, 'file' => $file ); die (json_encode( $res )); ?> |
常用选项设置与事件调用
Web Uploader项目的官网地址:http://fex.baidu.com/webuploader/
参数 | 描述 | 默认值 |
dnd | [可选] 指定Drag And Drop拖拽的容器,如果不指定,则不启动。 | undefined |
disableGlobalDnd | [可选] 指定监听paste事件的容器,如果不指定,不启用此功能。此功能为通过粘贴来添加截屏的图片。建议设置为document.body. | undefined |
pick | [可选], Object,指定选择文件的按钮容器,不指定则不创建按钮。 id {Seletor|dom} 指定选择文件的按钮容器,不指定则不创建按钮。注意 这里虽然写的是 id, 但是不是只支持 id, 还支持 class, 或者 dom 节点。 label {String} 请采用 innerHTML 代替 innerHTML {String} 指定按钮文字。不指定时优先从指定的容器中看是否自带文字。 multiple {Boolean} 是否开起同时选择多个文件能力。 |
undefined |
accept | [可选] 指定可接受的文件类型。 title {String} 文字描述 extensions {String} 允许的文件后缀,不带点,多个用逗号分割。 mimeTypes {String} 多个用逗号分割。 |
null |
thumb | {Object} [可选] 配置生成缩略图的选项。 | |
compress | {Object} [可选] 配置压缩的图片的选项。如果此选项为false, 则图片在上传前不进行压缩。 | |
auto | [可选] 设置为 true 后,不需要手动调用上传,有文件选择即开始上传。 | false |
runtimeOrder | [可选] 指定运行时启动顺序。默认会想尝试 html5 是否支持,如果支持则使用 html5, 否则则使用 flash. 可以将此值设置成 flash,来强制使用 flash 运行时。 | html5,flash |
chunked | [可选] 是否要分片处理大文件上传。 | false |
chunkSize | [可选] 如果要分片,分多大一片? 默认大小为5M. | 5242880 |
chunkRetry | [可选]如果某个分片由于网络问题出错,允许自动重传次数。 | 2 |
threads | [可选] 上传并发数。允许同时最大上传进程数。 | 3 |
formData | [可选]文件上传请求的参数表,每次发送都会发送此对象中的参数。 | {} |
fileVal | [可选] 设置文件上传域的name。 | file |
fileNumLimit | [可选] 验证文件总数量, 超出则不允许加入队列。 | undefined |
fileSizeLimit | [可选] 验证文件总大小是否超出限制, 超出则不允许加入队列。 | undefined |
fileSingleSizeLimit | [可选] 验证单个文件大小是否超出限制, 超出则不允许加入队列。 | undefined |
duplicate | [可选] 去重, 根据文件名字、文件大小和最后修改时间来生成hash Key. | undefined |
常用的事件说明:
事件 | 参数说明 | 描述 |
beforeFileQueued | file {File}File对象 | 当文件被加入队列之前触发,此事件的handler返回值为false,则此文件不会被添加进入队列。 |
fileQueued | file {File}File对象 | 当文件被加入队列以后触发。 |
filesQueued | file {File}数组,内容为原始File(lib/File)对象。 | 当一批文件添加进队列以后触发。 |
fileDequeued | file {File}File对象 | 当文件被移除队列后触发。 |
uploadStart | file {File}File对象 | 某个文件开始上传前触发,一个文件只会触发一次。 |
uploadBeforeSend | object {Object} data {Object}默认的上传参数,可以扩展此对象来控制上传参数。 headers {Object}可以扩展此对象来控制上传头部。 |
当某个文件的分块在发送前触发,主要用来询问是否要添加附带参数,大文件在开起分片上传的前提下此事件可能会触发多次。 |
uploadProgress | file {File}File对象 percentage {Number}上传进度 |
上传过程中触发,携带上传进度。 |
uploadError | file {File}File对象 reason {String}出错的code |
当文件上传出错时触发。 |
uploadSuccess | file {File}File对象 response {Object}服务端返回的数据 |
当文件上传成功时触发。 |
uploadComplete | file {File} [可选]File对象 | 不管成功或者失败,文件上传完成时触发。 |