最近，要做文件上传功能，在同事推荐下，选择了webUploader插件。WebUploader是由Baidu WebFE(FEX)团队开发的一个简单的以HTML5为主，FLASH为辅的现代文件上传组件，详情请看官网(直接百度webUploader，应该是第一个)。挺好用的，于是小结一下。

1. 准备工作

1.1 先搭建服务，选用wamp/xamp或其他服务

1.2 下载webUploader 下载地址: https://github.com/fex-team/webuploader

2. 选用demo

点击选择图片(其他文件也可以)就可以上传啦！

遇到的几个问题

1. 上传稍微大一点(10M+)的文件可能会有点问题，文件名被改，文件也会出错。文件被重命名成file_*

2. 限制上传文件大小等配置

3. 上传文件至服务器地址修改 (自定义)

4. 在上传文件前事件

4.1 上传前文件格式检测

5. 根据自己需求要在上传前做验证

6. 获取已添加的所有文件对象

7.上传时，携带自定义参数

8.上传大图片被压缩，而其他文件没有问题

9. uploader.removeFile( file, true )无效， 执行getFiles()删除的文件还在file数组里

上传稍微大一点(10M+)的文件可能会有点问题，文件名被改，文件也会出错。文件被重命名成file_*，例如:file_58f4a2fc7dde0, 这问题也困扰我很久，在github webUploader的issue里，也发现有人有同样的问题，https://github.com/fex-team/webuploader/issues/263 但是我这里是没有解决。

后来查找官方API才找到答案，原来是大文件没有切片导致啊！！！！

解决办法: 在upload.js 中，uploader实例化的时候设置切片chunked: true,

在这位置，可以更改一些配置，如看”点击上传图片”不顺眼，想改成“上传文件”，就在pick那改。

还有的想把上传文件的大小限制改动下，也可以根据自己需求在这里的fileSizeLimit那里改。

fileNumLimit {int} [可选] [默认值：undefined] 验证文件总数量, 超出则不允许加入队列。

fileSizeLimit {int} [可选] [默认值：undefined] 验证文件总大小是否超出限制, 超出则不允许加入队列。

fileSingleSizeLimit {int} [可选] [默认值：undefined] 验证单个文件大小是否超出限制, 超出则不允许加入队列。

改成切片后，再上传文件，

成功！ 完美。

那这里又存在一个疑问，那文件上传的位置在哪里更改呢？

在server/fileupload.php 中改targetDir和uploadDir

在server/fileupload.php 中改targetDir和uploadDir

a. 在上传文件前事件

//我自己的需求是，只能添加xml格式和zip格式文件

//webuploader.js

input.on( 'change', function( e ) {

var fn = arguments.callee,

clone;

//code

/**下面检测文件格式的方法不推荐！不推荐！！！ (webuploader实例化中有配置)

在file 对象中有个ext属性是文件格式的，可以用。

*/

上传前文件格式检测

在webuploader实例化那里可以配置，详情看官网文档

我这里还有需要根据权限的不同去指定上传文件格式，我用个数组/字符串变量保存 (具体是字符串还是数组，请参看源码中怎么加，你就怎么加)

实际上在这里加，只是在你点击添加文件时，那个弹框就给你过滤了其他文件，留下你指定的文件类型。

如图。若用户吧把那个自定义文件下拉框换成全部文件，就可以添加其他文件了(刚刚自测了一把)。

显然，这与我们需求不符，uploader实例化配置accept只是个简单的过滤而已，

所以还是得在文件添加到控件中，就自己检测。(个人觉得，就按我上面的那样，一旦用户添加进来了，就里面检测，添加不通过直接打回去)

b. 根据自己需求要在上传前做验证

//在662行左右，点击时做验证

$upload.on('click', function() {

if ( $(this).hasClass( 'disabled' ) ) {

return false;

}

c. 获取已添加的所有文件对象

//有时需要把所有文件做个判断啥的，就需要用到

var fileItem = uploader.getFiles();

//要文件添加进去了，才有用。在刚刚添加文件时，是无效的。

//uploader是一个实例

d. 上传时，携带自定义参数

//见uploader实例化

uploader.options.formData.houseName = houseName;

uploader.options.formData.houseType = houseType;

uploader.options.formData.address = district;

//添加到实例化后就可以了，

//地址瞎写的，

e. 上传大图片被压缩，而其他文件没有问题

之前自己检测过，上传大文件(非图片)到服务器上，与上传前文件对比大小，是没有问题的。 但是今天同事说，他传的图片(8M)被压缩(400kb左右)了，刚刚开始还不信，毕竟之前自己检测过，上传后的文件和原文件的大小一致。 后来查官方文档才知道真被压缩了。 文档是这么说的

解决办法: 在uploader实例化的时候，加个参数 compress: false;

9. uploader.removeFile( file, true )无效， 执行getFiles()删除的文件还在file数组里

测试给我提个单，说删除有问题。

额·····

后来自己定位到，在点击删除时，执行到uploader.removeFile(file), 居然只是从视图中删除了？ 没从file数组删除？？？？

什么鬼？

后来查官方API，说只要把removeFile()方法后面加个true就可以了。然并卵。。。。

再去github issue查，这种问题还真有好几个，

只要在webuploader.js 中加几行代码就好。

1. 在webuploader.js 中搜到 function Queue() 方法

2. 在里面添加 删除方法

_delFile : function(file){

for(var i = this._queue.length-1 ; i >= 0 ;i-- ){

if(this._queue[i] == file){

this._queue.splice(i,1);

break;

}

}

},

然后再在removeFile: function( file ) { 调用下就好了

最后附上一张gif，不骗你们啦~~