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",这是文件上传的必要条件。

注意事项:

  • 确保每个 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 代码来接收和处理上传的文件和文本数据。

要点说明:

  • 使用 $_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 对象是一个强大的工具,可以简化文件上传的流程,提高用户体验。

相关专题

更多
php文件怎么打开
php文件怎么打开

打开php文件步骤:1、选择文本编辑器;2、在选择的文本编辑器中,创建一个新的文件,并将其保存为.php文件;3、在创建的PHP文件中,编写PHP代码;4、要在本地计算机上运行PHP文件,需要设置一个服务器环境;5、安装服务器环境后,需要将PHP文件放入服务器目录中;6、一旦将PHP文件放入服务器目录中,就可以通过浏览器来运行它。

2541

2023.09.01

php怎么取出数组的前几个元素
php怎么取出数组的前几个元素

取出php数组的前几个元素的方法有使用array_slice()函数、使用array_splice()函数、使用循环遍历、使用array_slice()函数和array_values()函数等。本专题为大家提供php数组相关的文章、下载、课程内容,供大家免费下载体验。

1609

2023.10.11

php反序列化失败怎么办
php反序列化失败怎么办

php反序列化失败的解决办法检查序列化数据。检查类定义、检查错误日志、更新PHP版本和应用安全措施等。本专题为大家提供php反序列化相关的文章、下载、课程内容,供大家免费下载体验。

1500

2023.10.11

php怎么连接mssql数据库
php怎么连接mssql数据库

连接方法:1、通过mssql_系列函数;2、通过sqlsrv_系列函数;3、通过odbc方式连接;4、通过PDO方式;5、通过COM方式连接。想了解php怎么连接mssql数据库的详细内容,可以访问下面的文章。

952

2023.10.23

php连接mssql数据库的方法
php连接mssql数据库的方法

php连接mssql数据库的方法有使用PHP的MSSQL扩展、使用PDO等。想了解更多php连接mssql数据库相关内容,可以阅读本专题下面的文章。

1416

2023.10.23

html怎么上传
html怎么上传

html通过使用HTML表单、JavaScript和PHP上传。更多关于html的问题详细请看本专题下面的文章。php中文网欢迎大家前来学习。

1234

2023.11.03

PHP出现乱码怎么解决
PHP出现乱码怎么解决

PHP出现乱码可以通过修改PHP文件头部的字符编码设置、检查PHP文件的编码格式、检查数据库连接设置和检查HTML页面的字符编码设置来解决。更多关于php乱码的问题详情请看本专题下面的文章。php中文网欢迎大家前来学习。

1446

2023.11.09

php文件怎么在手机上打开
php文件怎么在手机上打开

php文件在手机上打开需要在手机上搭建一个能够运行php的服务器环境,并将php文件上传到服务器上。再在手机上的浏览器中输入服务器的IP地址或域名,加上php文件的路径,即可打开php文件并查看其内容。更多关于php相关问题,详情请看本专题下面的文章。php中文网欢迎大家前来学习。

1306

2023.11.13

Golang gRPC 服务开发与Protobuf实战
Golang gRPC 服务开发与Protobuf实战

本专题系统讲解 Golang 在 gRPC 服务开发中的完整实践,涵盖 Protobuf 定义与代码生成、gRPC 服务端与客户端实现、流式 RPC(Unary/Server/Client/Bidirectional)、错误处理、拦截器、中间件以及与 HTTP/REST 的对接方案。通过实际案例,帮助学习者掌握 使用 Go 构建高性能、强类型、可扩展的 RPC 服务体系,适用于微服务与内部系统通信场景。

8

2026.01.15

热门下载

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

精品课程

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

共137课时 | 8.7万人学习

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

共6课时 | 7万人学习

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

共13课时 | 0.9万人学习

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

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