JS与PHP实现文件上传:FormData与Base64方案详解
本文详解利用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 程序设计有所帮助。
为什么叫JavaScript:语言命名由来及与Java的历史渊源
2026-11-05 11:37:48
JS获取当前时间年月日时分秒并格式化为YYYY-MM-DD HH:mm:ss
2026-11-04 21:25:21
不同语言间JS与Java/Python加密结果不一致怎么办
2026-11-04 18:27:23
Mock.js 拦截 Axios 和 Fetch 请求的原理与配置方法
2026-11-04 08:13:59
JS怎么获取当前日期并格式化为YYYY-MM-DD
2026-11-03 18:47:03
