0

0

如何使用 Ajax 无表单提交上传文件(支持多图上传)

碧海醫心

碧海醫心

发布时间:2026-02-01 20:59:01

|

623人浏览过

|

来源于php中文网

原创

如何使用 Ajax 无表单提交上传文件(支持多图上传)

本文详解如何在不依赖 `

` 标签和传统 submit 行为的前提下,通过原生 `formdata` 和 jquery ajax 正确上传文件(如图片),重点解决 `filelist` 对象无法直接传入 `formdata.append()` 导致后端接收为 `[object filelist]` 的常见错误。

在实际开发中,常需实现“点击按钮即上传选中文件”的交互(例如头像预览后一键更新、富文本编辑器内图片拖拽上传等),此时往往不希望包裹

标签,也不触发页面跳转或默认提交行为。但若直接将 input[type="file"].files(即 FileList 对象)作为值传入 FormData.append(),JavaScript 会将其隐式转换为字符串 "[object FileList]",导致后端 $_FILES 中仅存无效字符串而非真实文件数据——这正是你日志中看到 Array ( [images] => Array ( [0] => [object FileList] ) ) 的根本原因。

正确做法是遍历 FileList,逐个将 File 实例追加至 FormData。每个 File 对象本身是 Blob 的子类,可被 FormData 原生识别并序列化为 multipart/form-data 的二进制字段。

以下是修正后的完整代码示例(含关键注释):

浚心时尚购物商城程序
浚心时尚购物商城程序

时尚购物程序v1.01、全立体设计。此系统由3个Flash动画为主线(正式版带原文件),设计更形象,网站更有吸引力。这种设计在网店系统内绝无仅有,使您的网店与众不同。2、内置音乐播放器,简单灵活的操作即可完成设置,前台任意调用。并带详细说明文件,一看就懂。合理使用此功能,可使网站更富渲染力。3、支持多图显示,每件产品最多可以上传9张图片。4、后台功能强大,销售管理,财务管理,在线支付平台管理等功能

下载
$('.formimgaj').each(function() {
  const fileInput = $( ".form-control-file", this )[0]; // 获取原生 DOM 元素
  const uploadBtn = $(this).find(".butt_img_upload");

  uploadBtn.on('click', function(e) {
    e.preventDefault();

    // ✅ 关键:检查是否有文件被选择
    if (!fileInput || !fileInput.files || fileInput.files.length === 0) {
      console.warn('未选择任何文件');
      return;
    }

    const formData = new FormData();

    // ✅ 关键:遍历 FileList,逐个 append 单个 File 对象
    for (let i = 0; i < fileInput.files.length; i++) {
      formData.append('images[]', fileInput.files[i]); // 注意:[] 表明后端接收为数组
    }
    formData.append('type', 'updateimg');

    // 可选:前端调试 —— 打印 FormData 内容(需配合 Response API)
    // new Response(formData).text().then(text => console.log('FormData content:', text));

    $.ajax({
      type: 'POST',
      url: 'php/update.php',
      data: formData,
      processData: false,  // ❗必须设为 false,禁止 jQuery 自动处理数据
      contentType: false,  // ❗必须设为 false,让浏览器自动设置正确的 multipart Content-Type
      cache: false,
      success: function(response) {
        console.log('上传成功:', response);
      },
      error: function(xhr, status, error) {
        console.error('上传失败:', status, error);
      }
    });
  });
});

⚠️ 注意事项与最佳实践:

  • HTML 中无需 enctype 属性:enctype="multipart/form-data" 仅对 标签有效,
    上设置无效,应移除。
  • 确保 input[type="file"] 支持多选:若需上传多张图片,请添加 multiple 属性:
  • 后端接收逻辑需匹配:PHP 中应通过 $_FILES['images']['tmp_name'] 数组访问(注意是二维数组),例如:
    if ($_POST['type'] === 'updateimg' && !empty($_FILES['images']['name'])) {
        $fileCount = count($_FILES['images']['name']);
        for ($i = 0; $i < $fileCount; $i++) {
            $tmpName = $_FILES['images']['tmp_name'][$i];
            $name    = $_FILES['images']['name'][$i];
            // ... 移动文件、校验、保存等逻辑
        }
    }
  • 增强用户体验:建议在上传前校验文件类型、大小,并提供加载状态提示(如禁用按钮、显示 spinner)。
  • 通过以上方式,即可彻底摆脱表单束缚,灵活、可靠地实现无刷新文件上传,同时保证前后端数据结构一致、语义清晰。

热门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插件相关的文章、下载、课程内容,供大家免费下载体验。

151

2023.09.12

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

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

313

2023.10.13

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

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

396

2023.11.10

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

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

504

2023.12.04

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

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

187

2023.12.06

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

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

120

2024.02.23

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

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

176

2024.02.23

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

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

40

2026.01.13

go语言 注释编码
go语言 注释编码

本专题整合了go语言注释、注释规范等等内容,阅读专题下面的文章了解更多详细内容。

30

2026.01.31

热门下载

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

精品课程

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

共137课时 | 10.7万人学习

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

共6课时 | 11.2万人学习

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

共13课时 | 0.9万人学习

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

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