PHP文件上传失败主因是服务器配置与路径处理问题，需检查表单enctype、php.ini上传开关及大小限制、目标目录权限与绝对路径、临时文件有效性，并用finfo_open校验真实类型而非$_FILES['type']。
PHP 文件上传本身不难，但线上出问题时往往卡在 $_FILES 为空、move_uploaded_file() 失败、或上传后文件内容损坏——核心原因通常是服务器配置和路径处理没对齐，不是代码写错了。
为什么 $_FILES 总是空？检查这三处硬性条件
表单没发对、PHP 没收住、服务器拦住了——三个环节缺一不可。
- HTML 表单必须带
enctype="multipart/form-data"，漏掉这个属性，浏览器根本不会把文件二进制数据发过去 -
php.ini中file_uploads = On必须启用，否则 PHP 直接忽略所有上传字段 -
post_max_size和upload_max_filesize要同时调大；比如想传 10MB 文件，upload_max_filesize = 10M不够，还得确保post_max_size >= 10M（POST 数据包含文件头和其他字段）
move_uploaded_file() 返回 false 的真实原因
它失败几乎从不因为“文件太大”或“格式不对”，而是权限、路径、临时目录这三个实际问题。
- 目标目录必须存在且 Web 进程（如 www-data 或 nginx 用户）有写权限，
chmod 755不够，得是775或更宽松 - 目标路径不能是相对路径（如
"uploads/file.jpg"），要转成绝对路径：__DIR__ . '/uploads/' . $filename - 临时文件可能已被清理：如果上传耗时过长、或脚本中途
exit，$_FILES['file']['tmp_name']对应的临时文件就失效了，move_uploaded_file()必然失败
如何安全地校验上传文件，而不是只看 $_FILES['file']['type']
$_FILES['file']['type'] 是浏览器传来的 MIME 类型，完全可伪造，不能用于判断文件真实类型。
立即学习“PHP免费学习笔记（深入）”；
- 用
finfo_open(FILEINFO_MIME_TYPE)读取文件头识别真实类型，例如：finfo_file(finfo_open(FILEINFO_MIME_TYPE), $_FILES['file']['tmp_name'])返回"image/jpeg" - 对图片类文件，可加一层
getimagesize($_FILES['file']['tmp_name'])，返回非 false 才说明是有效图片 - 不要依赖扩展名做判断，但可以结合真实 MIME 类型限制保存后的扩展名，比如
"image/png"→ 强制存为.png
上传大文件时，前端分片不是必须的，但得先绕过超时陷阱
PHP 默认 max_execution_time = 30，上传一个 200MB 文件很容易超时，但直接调大这个值治标不治本。
- 先关掉执行时间限制：
set_time_limit(0)放在上传逻辑开头，否则脚本会在接收完数据前被 kill - Nginx 用户注意：
client_max_body_size和fastcgi_read_timeout都要同步调大，否则请求在 PHP 之前就被 Nginx 拒绝或中断 - 真正稳定的大文件上传，还是得前端分片 + 后端合并，否则单次上传失败就得重来，用户体验差
最常被跳过的其实是临时目录状态检查：sys_get_temp_dir() 返回的路径是否可写、空间是否充足、是否被 SELinux 限制——这些不报错，只让 move_uploaded_file() 静默失败。
