jQuery File Upload 文件上传插件使用一 (最小安装 基本版)

时间：2021-03-03 08:04:08

jQuery File Upload 是一款非常强大的文件上传处理插件，支持多文件上传，拖拽上传，进度条，文件验证及图片音视频预览，跨域上传等等。

可以说你能想到的功能它都有。你没想到的功能它也有。。

不过由于功能太强大，使用起来还是需要点基本功，否则调试开发会遇到困难。

本文结合官方教程只介绍最基本的上传功能。

以我目前最新的9.7.1版本

下载下来解压到服务器能访问到的地方。

文件如下：

jQuery File Upload 文件上传插件使用一 (最小安装 基本版)

1. 新建一个文件夹MyDemo或者你随意。

把外面的server和js目录拷贝到里面，注意server目录里面包含gae-go、gae-python、php这些后端语言，只保留php就行。

2. 新建一html，内容如下，主要JS和CSS的路径。还有有时候国内无法访问ajax.googleapis.com/ajax/libs/jquery/1.9.1/jquery.min.js，可以引用本地的jQuery。

<!DOCTYPE HTML>

<html>

<head>

<meta charset="utf-8">

<title>jQuery File Upload Example</title>

<style>

.bar {

    height: 18px;

    background: green;

}

</style>

</head>

<body>

<input id="fileupload" type="file" name="files[]" data-url="server/php/" multiple>

<script src="js/jquery-1.11.1.min.js"></script>

<script src="js/vendor/jquery.ui.widget.js"></script>

<script src="js/jquery.iframe-transport.js"></script>

<script src="js/jquery.fileupload.js"></script>

<script>

$(function () {

    $('#fileupload').fileupload({

        dataType: 'json',

        // 上传完成后的执行逻辑

        done: function (e, data) {

            $.each(data.result.files, function (index, file) {

                $('<p/>').text(file.name).appendTo(document.body);

            });

        },

        // 上传过程中的回调函数

        progressall: function (e, data) {

            var progress = parseInt(data.loaded / data.total * 100, 10);

            $(".bar").text(progress + '%');

            $('#progress .bar').css(

                'width',

                progress + '%'

            );

        }

    });

});

</script>

<!-- 进度条 -->

<div id="progress">

    <div class="bar" style="width: 0%;"></div>

</div>

</body>

</html>

传统上都是用<form>表单提交上传，现在是纯Ajax。需要注意的input的data-url属性，这就是需要php服务端处理的路径。

浏览器打开，以我的为例 http://localhost/my/JS/Plugins/jQuery-File-Upload-master/MyDemo/

由于是在本地测试，为了看到进度进度效果，建议找个大点的(~1G)文件上传。可以直接拖个文件到浏览器窗口中。

jQuery File Upload 文件上传插件使用一 (最小安装 基本版)

效果如下，上传过程中绿色进度条会不停的增加。

F12打开调试面板，耐心等待上传完成，会看到上传完成后，有ajax返回。

地址类似：http://localhost/my/JS/Plugins/jQuery-File-Upload-master/MyDemo/server/php/

返回的数据是JSON格式，内容类似：

{"files":[{"name":"1409665745-8365","size":1472358262,"type":"multipart\/form-data; boundary=----WebKitFormBoundaryxLzvFFmSOiWiY1Ka","error":"The uploaded file exceeds the post_max_size directive in php.ini"}]}

很明显上传文件太大了，超出php.ini限制。先不改了。

如果我们直接丢个图片进去，返回的json类似：

{

    "files": [

        {

            "name": "10095978136d36c635.jpg",

            "size": 12479,

            "type": "image/jpeg",

            "url": "http://localhost/my/JS/Plugins/jQuery-File-Upload-master/MyDemo/server/php/files/10095978136d36c635.jpg",

            "thumbnailUrl": "http://localhost/my/JS/Plugins/jQuery-File-Upload-master/MyDemo/server/php/files/thumbnail/10095978136d36c635.jpg",

            "deleteUrl": "http://localhost/my/JS/Plugins/jQuery-File-Upload-master/MyDemo/server/php/?file=10095978136d36c635.jpg",

            "deleteType": "DELETE"

        }

    ]

}

来到MyDemo\server\php\files 会发现上传的图片，而且thumbnail目录还保存了裁剪过的图片，这都是官方提供的UploadHandler.php的功劳。

至此，一个拖拽上传文件的Demo完成了。但是功能仍然很弱，比如没有文件类型及大小限制，没有前台的错误提示。

官方提供的API有maxFileSize和acceptFileTypes。这在基本版里是不生效的，在UI版里才可以。具体的完善功能见第二篇

详见 maxFileSize and acceptFileTypes not working #760。

相关文章