小程序上传图片时$_FILES收不到数据，主因是前端wx.uploadFile的name字段与PHP中$_FILES键名不一致；需确保前后端字段名严格匹配，并检查目录权限、路径、Nginx/Apache上传限制及错误码。
小程序上传图片到 PHP 后端，关键不是“能不能传”，而是「$_FILES 为什么收不到」——绝大多数问题出在前端没发对、后端没配好，而不是 PHP 本身不支持。
小程序 wx.uploadFile 发送的文件字段名必须和 PHP 的 $_FILES 键名一致
小程序调用 wx.uploadFile 时，默认把文件塞进名为 file 的表单字段（除非你显式指定 name）。PHP 收到后，会把它放在 $_FILES['file'] 里。如果你后端代码写成 $_FILES['image'] 或 $_FILES['pic']，那就永远为空。
实操建议：
- 前端明确指定
name: 'file'，避免依赖默认值 - 后端用
var_dump($_FILES)看一眼实际结构，别猜 - 如果小程序改了
name（比如改成avatar），PHP 就得读$_FILES['avatar']，二者必须严格对应
move_uploaded_file 失败的常见原因和检查点
move_uploaded_file 返回 false 不代表文件没传上来，只说明「临时文件搬不动」。常见卡点：
iWebShop开源商城系统
下载
iWebShop是一款基于PHP语言及MYSQL数据库开发的B2B2C多用户开源免费的商城系统，系统支持自营和多商家入驻、集成微信商城、手机商城、移动端APP商城、三级分销、视频电商直播、微信小程序等于一体，它可以承载大数据量且性能优良，还可以跨平台，界面美观功能丰富是电商建站首选源码。iWebShop开源商城系统 v5.14 更新日志：新增商品编辑页面规格图片上传优化商品详情页面规格图片与主图切
立即学习“PHP免费学习笔记（深入）”；
- 目标目录不存在或 PHP 没有写权限（Linux 下注意
www-data或nginx用户权限） - 目标路径是相对路径（如
'uploads/xxx.jpg'），但当前工作目录不是你预期的——一律用__DIR__ . '/uploads/xxx.jpg' - 临时文件已被自动清理（比如上传超时、Nginx 设置了
client_max_body_size限制，导致截断） -
$_FILES['file']['error']不为 0：要先检查这个值，1是超upload_max_filesize，2是超MAX_FILE_SIZE隐藏域，6是找不到临时目录
Nginx / Apache 配置容易被忽略的上传限制
即使 PHP 的 upload_max_filesize 和 post_max_size 调大了，Web 服务器层照样能拦住大图：
- Nginx 必须设置
client_max_body_size 10M（放在http、server或location块中），否则 1MB 以上的图直接 413 Request Entity Too Large - Apache 默认没有 body 大小限制，但若启用了
mod_security，可能拦截 multipart 请求——可临时关掉测试 - HTTPS 环境下，某些 CDN（如腾讯云 CDN）会默认限制 POST body 大小，需单独配置
真正麻烦的不是上传逻辑本身，而是错误信息被层层吞掉：小程序只报“fail”，PHP 不打日志，Nginx 错误日志又没开——三者日志得一起看，缺一不可。
