使用Ajax异步上传图片的方法(html,javascript,php)

前两天项目中需要用到异步上传图片和显示上传进度的功能，于是找了很多外国的文章，翻山越岭地去遇上各种坑，这里写篇文章记录一下。

HTML

<form id="fileupload-form">    
     <input id="fileupload" type="file" name="file" >   
</form>
HTML代码没什么好说，一个form表单，还有文件类型的input。我们来看js部分。

javascript

//绑定了`submit`事件。    
   $('#fileupload-form').on('submit',(function(e) {
       e.preventDefault();
       //序列化表单   
      var serializeData = $(this).serialize();
      
      // var formData = new FormData(this);
      $(this).ajaxSubmit({
           type:'POST',
           url: *yoururl*,
           dataType: 'json', 
           data: serializeData,            
           // data: formData,
           
           //attention!!!   
           contentType: false,      
           cache: false,             
           processData:false,      
             
           beforeSubmit: function() {
                   //上传图片之前的处理   
           },
           uploadProgress: function (event, position, total, percentComplete){ 
               //在这里控制进度条   
           },
           success:function(){
               
           },
           error:function(data){
               alert('上传图片出错');
           }
       });
   }));

//绑定文件选择事件，一选择了图片，就让`form`提交。   

   $("#fileupload").on("change", function() {
       $(this).parent().submit();
});
PHP

<?php
  //通过$_FILES[]去获取文件
  echo '$_FILES['file']';
遇到的坑：

序列化表单，因为是文件，不能通过val()，text()等方法获取到它的值，只能通过序列化表单提交。代码里面使用.serialize()，有另外一种做法是使用.FormData()来提交，但是实验过程中，一开始正常，后来报错了。在stackoverflow.com上有人看到有人遇到同样地问题，没有解决，于是就放弃了。
普通的ajax是没办法或者说很难拿到上传进度的。这里使用了一个插件jQuery Form Plugin，使用方法很简单，原本ajax的配置都能用，而且有很多实用功能和详尽的使用文档。推荐~
ajax上传图片这三个参数必须配置contentType: false, cache: false, processData:false,。
获取本地预览图，这种方法可能会有浏览器兼容性问题。

$("#fileupload").change(function(){
  if (this.files && this.files[0]) {
       var reader = new FileReader();            
       reader.onload = function (e) {
             $('#theImg').attr('src', e.target.result);
    }
       reader.readAsDataURL(this.files[0]);
   }
}
php部分注意虽然Ajax那里使用的是POST方法，但是后台接受的时候只要是文件都是用$_FILES。你可以通过$_FILES['file']['type']去判断文件格式来做安全处理，我们这里只是演示。还有其他参数，比如tmp_name是文件路径，name是文件名。后台接收以后，你可以使用move_uploaded_file()来将文件保存到服务器上。这里就不多说。

如果提示： $(...).ajaxSubmit is not a function

页面js出现TypeError: $(...).ajaxSubmit is not a function 错误。

解决办法是：将jQuery-form.js文件引入页面即可。

jquery-form.js 下载地址：链接: http://pan.baidu.com/s/1ntHqJKP 密码: geb2