$_files数组为空的常见原因是表单缺少enctype="multipart/form-data"、ajax未正确配置formdata及processdata/contenttype选项,或php.ini中upload_max_filesize/post_max_size过小且file_uploads=off。

PHP上传文件时$_FILES数组为什么总是空
常见错误是表单没加 enctype="multipart/form-data",或者用 AJAX 发送时没设 FormData 或漏了 processData: false 和 contentType: false。另外,post_max_size 和 upload_max_filesize 这两个 php.ini 配置项如果太小,也会导致整个 $_FILES 为空,而不是报错——这点特别容易被忽略。
检查方法:打印 $_FILES 和 error_get_last(),再用 phpinfo() 确认实际生效的配置值。
- 表单必须写:
<form enctype="multipart/form-data" method="POST"></form> - php.ini 中
file_uploads = On必须开启 -
upload_max_filesize要 ≥ 单个文件预期大小,post_max_size要 ≥ 所有字段总大小(含文件+文本)
怎么安全地验证上传文件的真实类型
别信 $_FILES['file']['type'],它只是浏览器传来的 MIME 字符串,可以任意伪造。真正可靠的方式是读取文件头(magic bytes),用 finfo_open() 检查。
比如用户上传一个 .jpg 文件,但把后缀改成 .php 并塞进 PHP 代码,仅靠扩展名或 type 字段完全拦不住。
- 用
finfo_open(FILEINFO_MIME_TYPE)获取真实 MIME 类型 - 白名单比黑名单更安全,例如只允许
image/jpeg、image/png,不接受application/octet-stream - 注意
finfo在某些共享主机上可能被禁用,需提前检查extension_loaded('fileinfo')
if (function_exists('finfo_open')) {
$finfo = finfo_open(FILEINFO_MIME_TYPE);
$realType = finfo_file($finfo, $_FILES['file']['tmp_name']);
finfo_close($finfo);
if (!in_array($realType, ['image/jpeg', 'image/png'])) {
die('不支持的文件类型');
}
}
限制上传文件大小的两种时机和区别
前端 <input type="file" maxlength> 无效,HTML 标准根本不支持这个属性;JS 的 file.size 只能做友好提示,不能替代服务端校验。真正起作用的是 PHP 层面的两次判断:一次在接收前(php.ini 级别),一次在业务逻辑里($_FILES['file']['size'])。
- php.ini 的
upload_max_filesize是硬限制,超了直接进$_FILES['file']['error'] === UPLOAD_ERR_INI_SIZE - 业务中还要自己检查
$_FILES['file']['size'] > 2 * 1024 * 1024,因为用户可能绕过前端,拼接 POST 请求发大文件 - 注意单位:php.ini 里写
2M表示 2 MiB(1024×1024),不是 MB(1000×1000)
move_uploaded_file() 失败的常见原因
最常踩的坑是目标目录不存在、无写入权限,或路径用了相对路径却没搞清当前工作目录(getcwd() 不一定等于脚本所在目录)。另一个隐蔽问题是临时文件已被其他逻辑清理掉——比如用了某些框架的自动清理钩子,或同一请求中多次调用 move_uploaded_file()。
- 目标路径必须是绝对路径,推荐用
__DIR__ . '/uploads/'拼接 - 确保目录存在且权限正确:
is_writable()要返回 true,Linux 下通常是chmod 755或775 - 检查
$_FILES['file']['error'] === UPLOAD_ERR_OK再调用move_uploaded_file(),否则会静默失败 - 不要用
copy()替代,它不处理临时文件生命周期,也不校验上传状态
文件类型验证和大小限制必须同时落在服务端,前端只是体验优化。临时文件路径、真实 MIME 判断、目录权限这三处最容易在测试环境没问题、上线后突然失效。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











