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:{
width: 110,
height: 110,
// 图片质量，只有type为`image/jpeg`的时候才有效。
quality: 70,
// 是否允许放大，如果想要生成小图的时候不失真，此选项应该设置为false.
allowMagnify:
false
,
// 是否允许裁剪。
crop:
true
,
// 为空的话则保留原有图片格式。
// 否则强制转换成指定的类型。
type:
'image/jpeg'
},
compress:{
width: 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对象 | 不管成功或者失败，文件上传完成时触发。 |