JS与PHP实现文件上传:FormData与Base64方案详解

作者:阿沐时间:2026-10-22 21:20:06浏览:260

本文详解利用JavaScript与PHP实现文件上传的两种主流方案。首先介绍基于FormData对象的XMLHttpRequest 2上传方式,涵盖自定义按钮触发、文件选择及后端PHP接收保存的完整流程。其次分析Base64字符串传输图片的原理与优缺点,指出其虽能减少HTTP请求但会增加体积,建议优先使用FormData方案以平衡效率与流量。

本文通过具体实例,讲解如何结合JavaScript与PHP后台代码完成文件上传功能,供读者参考学习。

利用 FormData 对象形式上传

一、利用 FormData 对象形式上传

FormData 是 XMLHttpRequest 2 规范中的产物,其兼容性覆盖至 IE10 及以上版本。

FormData 对象能够将表单中所有元素的 name 属性与对应的 value 值组合成查询字符串(queryString)并提交至后台。在使用 Ajax 进行异步提交时,使用 FormData 对象可有效减少手动拼接查询字符串的工作量。

使用 FormData 对象

1. 获取 form 对象,并将其作为参数传入 FormData 构造函数中。

HTML 代码示例如下:


<form name="form1" id="form1">
   <input type="text" name="name" value="fdipzone">
   <input type="text" name="gender" value="male">
</form>

JavaScript 代码示例如下:


var form = document.getElementById('form1');
var formdata = new FormData(form);

2. 创建一个空的 FormData 对象,随后调用 append 方法逐个添加键值对。


var formdata = new FormData();
formdata.append('name','fdipzone');
formdata.append('gender','male');

以下是使用 FormData 提交表单及上传文件的完整实例:

实例1

在实际项目中,默认的 <input type="file"/> 样式往往不符合设计需求。通常的做法是自定义一个 <button> 按钮,并隐藏一个 <input type="file"/> 元素(因其原生样式较难看)。当用户点击自定义按钮时,通过 JavaScript 触发隐藏 input 的 click 事件,从而唤起文件选择对话框。

HTML 结构代码如下:


<input type="file"
    :style="{display: 'none'}"
    ref="input" @change="selectedFile"
/>
<button @click="upload">上传</button>

JavaScript 逻辑代码如下:


methods: {
  triggerSelect () {
   this.$refs.input.click()
  },
  selectedFile (e) {
   console.log(e.target.files[0])
   //根据项目需求做具体处理,比如说获取文件名
  },
  async upload () {
   //如果不需要用到上传后的返回值可以把 async...await 语法去掉
   let files = this.$refs.input.files;
   if(files.length > 0) {
    let form = new FormData();
    form.append('file', files[0])
    let data = await new Promise((resolve, reject) => {
      axios({
       url: '',
       method: 'post',
       data: form
      })
       .then(res => {
        resolve(res)
       })
       .catch(err => {
        reject(err)
       })
     })
   }
  }
}

实例2


<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html>
 <head>
 <meta http-equiv="content-type" content="text/html; charset=utf-8">
 <title> FormData Demo </title>
 </head>
 <body>
  <form name="form1" id="form1">
    <p>name:<input type="text" name="name" ></p>
    <p>gender:<input type="radio" name="gender" value="1">male <input type="radio" name="gender" value="2">female</p>
    <p>photo:<input type="file" name="photo" id="photo"></p>
    <p><input type="button" name="b1" value="submit" onclick="fsubmit()"></p>
  </form>
  <div id="result"></div>
 <script src="https://code.jquery.com/jquery-1.11.0.min.js"></script>
 <script type="text/javascript">
  function fsubmit(){
    var data = new FormData($('#form1')[0]);
    $.ajax({
      url: 'server.php',
      type: 'POST',
      data: data,
      dataType: 'JSON',
      cache: false,
      processData: false, //不处理发送的数据,因为data值是FormData对象,不需要对数据做处理
      contentType: false  //不设置Content-type请求头
    }).done(function(ret){
      if(ret['isSuccess']){
        var result = '';
        result += 'name=' + ret['name'] + '<br>';
        result += 'gender=' + ret['gender'] + '<br>';
        result += '<img src="' + ret['photo'] + '" width="100">';
        $('#result').html(result);
      }else{
        alert('提交失敗');
      }
    });
    return false;
  }
 </script>
</body>
</html>

后端处理文件 server.php


<?php
$name = isset($_POST['name'])? $_POST['name'] : '';
$gender = isset($_POST['gender'])? $_POST['gender'] : '';
$filename = time().substr($_FILES['photo']['name'], strrpos($_FILES['photo']['name'],'.'));
$response = array();
if(move_uploaded_file($_FILES['photo']['tmp_name'], $filename)){
  $response['isSuccess'] = true;
  $response['name'] = $name;
  $response['gender'] = $gender;
  $response['photo'] = $filename;
}else{
  $response['isSuccess'] = false;
}
echo json_encode($response);
?>

展示带图片预览的上传功能示例


// -------- 将以base64的图片url数据转换为Blob --------
function convertBase64UrlToBlob(urlData, filetype){
    //去掉url的头,并转换为byte
    var bytes = window.atob(urlData.split(',')[1]);
    //处理异常,将ascii码小于0的转换为大于0
    var ab = new ArrayBuffer(bytes.length);
    var ia = new Uint8Array(ab);
    var i;
    for (i = 0; i < bytes.length; i++) {
      ia[i] = bytes.charCodeAt(i);
    }
    return new Blob([ab], {type : filetype});
}
$input.on('change', function (e) {
    var input = $input.get(0);
    var files = input.files || [];
    if (files.length === 0) {
      return;
    }
    console.log('选中 ' + files.length + ' 个文件');
    // 遍历选中的文件,预览、上传
    $.each(files, function (key, file) {
      var filename = file.name || '';
      var fileType = file.type || '';
      var reader = new FileReader();
      // onload事件
      reader.onload = function (e) {
        var base64 = e.target.result || this.result;
        var formData = new FormData();
        formData.append("upload_file", convertBase64UrlToBlob(base64, fileType), filename);
        var xhr = new XMLHttpRequest();
        // 开始上传
        xhr.open('POST', uploadImgUrl, true);
        // 发送数据
        xhr.send(formData);
      });
      reader.readAsDataURL(file);
    });
});

base64 字符串方式上传图片

二、base64 字符串方式上传图片

Base64 在线转换工具参考:http://tools.jb51.net/transcoding/img2base64

DataURI 技术允许在 HTML 文档中嵌入小型文件,可通过 img 标签或 CSS 引入转换后的 Base64 编码数据。这种方式有助于减少独立的 HTTP 请求,从而加快小图像的加载速度。需要注意的是,经过 Base64 编码后的文件体积通常比源文件增大约 30%。

Base64 在 CSS 中的使用示例:


.box{
 background-image: url("data:image/jpg;base64,/9j/4QMZR...");
}

Base64 在 HTML 中的使用示例:


<img src="data:image/jpg;base64,/9j/4QMZR..." />

不推荐使用 Base64 方式,因其效率较低、消耗流量且占用存储空间。建议优先采用将 Base64 图片格式转换为 FormData 形式进行传递的方案。

更多关于 JavaScript 相关内容感兴趣的读者可查看本站专题:《JavaScript表单(form)操作技巧大全》、《JavaScript查找算法技巧总结》、《JavaScript数据结构与算法技巧总结》、《JavaScript遍历算法与技巧总结》、《JavaScript错误与调试技巧总结》及《JavaScript数学运算用法总结》

希望本文所述的实现方法对读者的 JavaScript 程序设计有所帮助。

作者最新文章