0

0

使用 Ajax 和 FormData 实现文件上传及文本数据提交的完整教程

霞舞

霞舞

发布时间:2025-10-15 13:09:00

|

225人浏览过

|

来源于php中文网

原创

使用 ajax 和 formdata 实现文件上传及文本数据提交的完整教程

本文旨在解决在使用 Ajax 和 FormData 进行文件上传时,遇到的 $_POST 和 $_FILES 为空的问题。通过详细的代码示例和解释,我们将展示如何正确地构建 FormData 对象,并通过 Ajax 将文件和文本数据发送到服务器端,同时避免常见的错误配置,确保数据能够成功地被 PHP 脚本接收和处理。

在使用 Ajax 进行文件上传时,FormData 对象是一个强大的工具,它允许我们模拟 HTML 表单提交,并包含文件和其他表单数据。然而,如果配置不正确,可能会导致服务器端无法接收到数据,表现为 $_POST 和 $_FILES 为空。本文将详细介绍如何正确地使用 FormData 对象,并通过 Ajax 将文件和文本数据上传到服务器。

HTML 表单结构

首先,我们需要一个 HTML 表单,用于收集用户输入的文件和文本数据。关键在于正确设置 enctype 属性为 "multipart/form-data",这是文件上传的必要条件。

<form name="usrupload" method="POST" enctype="multipart/form-data">
  <label class="form-label text-start">Enter your Name
    <input class="form-control" name="name" type="text" placeholder="John" />
  </label>

  <label class="form-label">Title
    <input class="form-control" type="text" name="title" placeholder="Operator" />
  </label>

  <label class="form-label">Your Cute Photo (format: jpg and png only, less than 500kb)
    <input class="form-control"  name="file" type="file" />
  </label>

  <input type='button' name='bttn' value='Submit' />
</form>

注意事项:

  • 确保每个 input 元素都有唯一的 name 属性,这对于服务器端区分不同的输入字段至关重要。
  • 使用

JavaScript (jQuery) 代码

接下来,我们使用 JavaScript 和 jQuery 来处理表单提交和 Ajax 请求。

ReportPlus数据报表中心小程序
ReportPlus数据报表中心小程序

ReportPlust意在打造一套精美的数据报表模板,里面高度封装日历组件、表格组件、排行榜组件、条形进度条组件、文本块组件以及ucharts的多个图表组件,用户只需要按照虚拟数据的格式,传特定数据即可方便、快捷地打造出属于自己的报表页面。该小程序主要使用了ucharts和wyb-table两插件实现的数据报表功能。 特点使用的是uni-app中最受欢迎的图表uCharts插件完成图表展示,该插件

下载
const form = document.forms.usrupload;

form.bttn.onclick = () => {
  var form_data = new FormData(form);
  $.ajax({
    type: 'POST',
    dataType: 'text',
    cache: false,
    contentType: false,
    processData: false,
    url: 'save_data.php',
    data: form_data,
    success: function(data) {
      alert(data)
      window.location = 'account.php';
    }
  });
}

关键点解释:

  1. FormData(form): 直接将表单元素作为参数传递给 FormData 构造函数。这会自动收集表单中的所有字段和文件数据。
  2. contentType: false 和 processData: false: 这两个选项对于文件上传至关重要。contentType: false 告诉 jQuery 不要设置 Content-Type header,让浏览器根据 FormData 的内容自动设置。processData: false 告诉 jQuery 不要将 data 转换为字符串。
  3. data: form_data: 直接将 FormData 对象作为 data 选项的值传递给 Ajax 请求。

PHP 服务器端代码

最后,我们需要 PHP 代码来接收和处理上传的文件和文本数据。

<?php

$name = $_POST['name'];
$title = $_POST['title'];
$file = $_FILES['file'];

// 处理文件上传
$filename = $file['name'];
$tmp_name = $file['tmp_name'];
$error = $file['error'];

if ($error === UPLOAD_ERR_OK) {
  // 移动文件到指定目录
  $destination = 'uploads/' . $filename;
  move_uploaded_file($tmp_name, $destination);

  echo "File uploaded successfully!";
} else {
  echo "File upload failed with error code: " . $error;
}

// 其他处理逻辑,例如将数据保存到数据库

?>

要点说明:

  • 使用 $_POST 数组访问文本数据,例如 $_POST['name'] 和 $_POST['title']。
  • 使用 $_FILES 数组访问上传的文件信息,例如 $_FILES['file']['name'](文件名)和 $_FILES['file']['tmp_name'](临时文件路径)。
  • 务必检查 $_FILES['file']['error'] 的值,以确保文件上传成功。
  • 使用 move_uploaded_file() 函数将临时文件移动到指定目录。

常见问题和解决方案

  • $_POST 和 $_FILES 为空: 检查 HTML 表单的 enctype 属性是否设置为 "multipart/form-data",并确保 Ajax 请求的 contentType 和 processData 选项设置为 false。
  • 文件上传失败: 检查 $_FILES['file']['error'] 的值,并根据错误代码进行排查。常见的错误包括文件大小超过限制、文件类型不符合要求等。
  • JavaScript 错误: 确保 jQuery 库已正确加载,并且 JavaScript 代码没有语法错误。

总结

通过本文的教程,您应该能够正确地使用 Ajax 和 FormData 对象进行文件上传,并成功地在服务器端接收和处理数据。关键在于正确配置 HTML 表单、JavaScript 代码和 PHP 服务器端代码,并注意避免常见的错误。记住,FormData 对象是一个强大的工具,可以简化文件上传的流程,提高用户体验。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
jquery插件有哪些
jquery插件有哪些

jquery插件有jQuery UI、jQuery Validate、jQuery DataTables、jQuery Slick、jQuery LazyLoad、jQuery Countdown、jQuery Lightbox、jQuery FullCalendar、jQuery Chosen和jQuery EasyUI等。本专题为大家提供jquery插件相关的文章、下载、课程内容,供大家免费下载体验。

156

2023.09.12

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

334

2023.10.13

jquery删除元素的方法
jquery删除元素的方法

jquery可以通过.remove() 方法、 .detach() 方法、.empty() 方法、.unwrap() 方法、.replaceWith() 方法、.html('') 方法和.hide() 方法来删除元素。更多关于jquery相关的问题,详情请看本专题下面的文章。php中文网欢迎大家前来学习。

405

2023.11.10

jQuery hover()方法的使用
jQuery hover()方法的使用

hover()是jQuery中一个常用的方法,它用于绑定两个事件处理函数,这两个函数将在鼠标指针进入和离开匹配的元素时执行。想了解更多hover()的相关内容,可以阅读本专题下面的文章。

515

2023.12.04

jquery实现分页方法
jquery实现分页方法

在jQuery中实现分页可以使用插件或者自定义实现。想了解更多jquery分页的相关内容,可以阅读本专题下面的文章。

312

2023.12.06

jquery中隐藏元素是什么
jquery中隐藏元素是什么

jquery中隐藏元素是非常重要的一个概念,在使用jquery隐藏元素之前,需要先了解css样式中关于元素隐藏的属性,比如display、visibility、opacity等属性。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

128

2024.02.23

jquery中什么是高亮显示
jquery中什么是高亮显示

jquery中高亮显示是指对页面搜索关键词时进行高亮显示,其实现办法:1、先获取要高亮显示的行,获取搜索的内容,再遍历整行内容,最后添加高亮颜色;2、使用“jquery highlight”高亮插件。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

183

2024.02.23

jQuery 正则表达式相关教程
jQuery 正则表达式相关教程

本专题整合了jQuery正则表达式相关教程大全,阅读专题下面的文章了解更多详细内容。

51

2026.01.13

Go高并发任务调度与Goroutine池化实践
Go高并发任务调度与Goroutine池化实践

本专题围绕 Go 语言在高并发任务处理场景中的实践展开,系统讲解 Goroutine 调度模型、Channel 通信机制以及并发控制策略。内容包括任务队列设计、Goroutine 池化管理、资源限制控制以及并发任务的性能优化方法。通过实际案例演示,帮助开发者构建稳定高效的 Go 并发任务处理系统,提高系统在高负载环境下的处理能力与稳定性。

22

2026.03.10

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
PHP课程
PHP课程

共137课时 | 13.3万人学习

JavaScript ES5基础线上课程教学
JavaScript ES5基础线上课程教学

共6课时 | 11.3万人学习

PHP新手语法线上课程教学
PHP新手语法线上课程教学

共13课时 | 1.0万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号