0

0

Nodejs连PHP如何传文件_用FormData与PHP接收法【指南】

雪夜

雪夜

发布时间:2026-02-08 13:51:09

|

964人浏览过

|

来源于php中文网

原创

可行,需用 form-data 库模拟 FormData 并以可读流方式添加文件;PHP 中 $_FILES 为空主因是配置限制或未校验错误码,须检查 php.ini 上传限制、MIME 类型及文件保存安全措施。

nodejs连php如何传文件_用formdata与php接收法【指南】

Node.jsaxiosnode-fetch 发送 FormData 到 PHP 是否可行?

不可直接用原生 FormData浏览器专属),Node.js 环境没有 window.FormData。必须用兼容库模拟,否则会报错 ReferenceError: FormData is not defined

推荐方案:用 form-data 库构造 multipart/form-data 请求体,配合 axiosnode-fetch 发送。

  • 安装:npm install form-data axios
  • 关键点:不能直接传 JS 对象或 JSON;必须把文件转为可读流(fs.createReadStream())再 append 进 FormData 实例
  • 注意设置 Content-Type:让 axios 自动处理(不手动设),否则 PHP 无法解析 multipart
const FormData = require('form-data');
const fs = require('fs');
const axios = require('axios');

const form = new FormData();
form.append('file', fs.createReadStream('./test.pdf'));
form.append('desc', 'upload from node');

axios.post('https://example.com/upload.php', form)
  .then(res => console.log(res.data));

PHP 接收时为什么 $_FILES 为空?

常见原因不是 Node.js 发得不对,而是 PHP 配置或接收逻辑没对上。

  • post_max_sizeupload_max_filesizephp.ini 中太小(如默认 2M),大文件直接被截断,$_FILES 为空且无错误提示
  • PHP 脚本开头没加 error_reporting(E_ALL); ini_set('display_errors', 1);,导致上传失败静默
  • 没检查 $_FILES['file']['error'] 值:0=成功,1/2=超限,3=部分上传,4=无文件
  • Apache/Nginx 反向代理时可能拦截或改写 Content-Type,需确认请求头中 Content-Type 确实是 multipart/form-data; boundary=...

PHP 如何安全保存接收到的文件?

别直接用 $_FILES['file']['tmp_name'] + move_uploaded_file() 就完事,绕过校验会引发任意文件写入。

DeepSider
DeepSider

浏览器AI侧边栏对话插件,集成多个AI大模型

下载

立即学习PHP免费学习笔记(深入)”;

  • 先验证 $_FILES['file']['error'] === 0
  • finfo_open(FILEINFO_MIME_TYPE) 检查真实 MIME 类型(不能信 $_FILES['file']['type']前端可伪造)
  • 限制扩展名白名单:['pdf', 'jpg', 'png'],而非黑名单
  • 生成新文件名(如 uniqid() . '.' . $ext),避免覆盖或路径遍历(../../.php
  • 保存路径不要在 Web 可访问目录下,或至少加 .htaccess 禁止执行

调试时怎么确认文件真的发过去了?

靠 PHP 打印日志容易误判,因为 $_FILES 为空时,$_POST 和原始 body 也未必能拿到——multipart 被 PHP 解析器丢弃了。

  • 在 PHP 入口第一行加:file_put_contents('/tmp/debug-raw.txt', file_get_contents('php://input'));,看是否为空(空说明请求根本没进 PHP 或被 web server 拦截)
  • var_dump($_SERVER['CONTENT_TYPE'], $_SERVER['CONTENT_LENGTH']); 确认 header 是否正常
  • Node.js 端开启 axios 的 transformRequest 或用 curl -v 对比,确认发出的 boundary 和字段名与 PHP 期望一致
  • 临时把 PHP 改成只输出 print_r($_FILES); print_r($_POST);,并确保响应状态码是 200(非 500 或 Nginx 502)

边界情况多在流处理、编码、配置三处,调通一次后建议封装成最小可复用函数,而不是每次拼 FormData

热门AI工具

更多
DeepSeek
DeepSeek

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

豆包大模型
豆包大模型

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

通义千问
通义千问

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

腾讯元宝
腾讯元宝

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

文心一言
文心一言

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

讯飞写作
讯飞写作

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

即梦AI
即梦AI

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

ChatGPT
ChatGPT

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

相关专题

更多
nginx 重启
nginx 重启

nginx重启对于网站的运维来说是非常重要的,根据不同的需求,可以选择简单重启、平滑重启或定时重启等方式。本专题为大家提供nginx重启的相关的文章、下载、课程内容,供大家免费下载体验。

234

2023.07.27

nginx 配置详解
nginx 配置详解

Nginx的配置是指设置和调整Nginx服务器的行为和功能的过程。通过配置文件,可以定义虚拟主机、HTTP请求处理、反向代理、缓存和负载均衡等功能。Nginx的配置语法简洁而强大,允许管理员根据自己的需要进行灵活的调整。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

509

2023.08.04

nginx配置详解
nginx配置详解

NGINX与其他服务类似,因为它具有以特定格式编写的基于文本的配置文件。本专题为大家提供nginx配置相关的文章,大家可以免费学习。

543

2023.08.04

tomcat和nginx有哪些区别
tomcat和nginx有哪些区别

tomcat和nginx的区别:1、应用领域;2、性能;3、功能;4、配置;5、安全性;6、扩展性;7、部署复杂性;8、社区支持;9、成本;10、日志管理。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

236

2024.02.23

nginx报404怎么解决
nginx报404怎么解决

当访问 nginx 网页服务器时遇到 404 错误,表明服务器无法找到请求资源,可以通过以下步骤解决:1. 检查文件是否存在且路径正确;2. 检查文件权限并更改为 644 或 755;3. 检查 nginx 配置,确保根目录设置正确、没有冲突配置等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

409

2024.07.09

Nginx报404错误解决方法
Nginx报404错误解决方法

解决方法:只需要加上这段配置:try_files $uri $uri/ /index.html;即可。想了解更多Nginx的相关内容,可以阅读本专题下面的文章。

3585

2024.08.07

nginx部署php项目教程汇总
nginx部署php项目教程汇总

本专题整合了nginx部署php项目教程汇总,阅读专题下面的文章了解更多详细内容。

41

2026.01.13

nginx配置文件详细教程
nginx配置文件详细教程

本专题整合了nginx配置文件相关教程详细汇总,阅读专题下面的文章了解更多详细内容。

60

2026.01.13

Golang处理数据库错误教程合集
Golang处理数据库错误教程合集

本专题整合了Golang数据库错误处理方法、技巧、管理策略相关内容,阅读专题下面的文章了解更多详细内容。

61

2026.02.06

热门下载

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

精品课程

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

共137课时 | 11.3万人学习

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号