上传失败时$_FILES为空或error=4，需检查表单enctype、php.ini文件上传配置及字段名一致性；move_uploaded_file()失败主因是权限、路径或open_basedir限制；安全命名须校验扩展名白名单并用随机字符串重命名。
上传失败时 $_FILES 为空或 error 值为 4 怎么办
这通常不是 PHP 代码问题，而是表单或服务器配置没到位。先确认三点：
-
必须带enctype="multipart/form-data"，缺了就根本不会传文件 -
php.ini中file_uploads = On，且upload_max_filesize和post_max_size要足够大（比如都设为20M） - 上传字段名要和
$_FILES中的键一致，比如对应$_FILES['avatar']
检查 $_FILES['xxx']['error'] 的值：4 表示没有文件被选中，1 或 2 是超限，6 是找不到临时目录 —— 这时候要查 upload_tmp_dir 是否可写。
move_uploaded_file() 返回 false 的常见原因
函数失败不等于文件没上传，它只负责把临时文件挪到目标位置。失败往往卡在权限、路径或安全限制上：
- 目标目录必须存在，且 Web 服务器用户（如
www-data或apache）有写权限 - 路径不能是相对路径（如
"uploads/"），建议用__DIR__ . '/uploads/' . $filename - 如果启用了
open_basedir，目标路径必须落在允许范围内 - Windows 下注意反斜杠转义问题，统一用
/或DIRECTORY_SEPARATOR
if (move_uploaded_file($_FILES['file']['tmp_name'], __DIR__ . '/uploads/' . $safe_name)) {
echo '上传成功';
} else {
error_log('move_uploaded_file failed: ' . print_r($_FILES['file'], true));
}
如何安全地生成保存文件名
绝不能直接用 $_FILES['xxx']['name']，它可能含路径、特殊字符甚至恶意扩展名（如 shell.php.jpg）。关键步骤是：
I-Shop购物系统
下载
部分功能简介：商品收藏夹功能热门商品最新商品分级价格功能自选风格打印结算页面内部短信箱商品评论增加上一商品，下一商品功能增强商家提示功能友情链接用户在线统计用户来访统计用户来访信息用户积分功能广告设置用户组分类邮件系统后台实现更新用户数据系统图片设置模板管理CSS风格管理申诉内容过滤功能用户注册过滤特征字符IP库管理及来访限制及管理压缩，恢复，备份数据库功能上传文件管理商品类别管理商品添加/修改/
立即学习“PHP免费学习笔记（深入）”；
- 用
pathinfo()提取原始扩展名，再白名单校验（如只允许['jpg', 'png', 'pdf']） - 用
uniqid() . bin2hex(random_bytes(8))生成随机前缀，避免重名和猜测 - 强制小写扩展名，防止大小写绕过（如
.PHP） - 不要保留原始文件名中的中文或空格，它们在某些系统下会出问题
$ext = strtolower(pathinfo($_FILES['file']['name'], PATHINFO_EXTENSION));
$allowed = ['jpg', 'jpeg', 'png', 'pdf'];
if (!in_array($ext, $allowed)) {
die('不支持的文件类型');
}
$safe_name = uniqid() . '_' . bin2hex(random_bytes(8)) . '.' . $ext;
为什么上传大文件时页面直接 500 或空白
这不是 PHP 报错，而是 Nginx / Apache 在请求体到达 PHP 前就拦截了。重点查 Web 服务器配置：
- Nginx：检查
client_max_body_size（单位是10M这种），需 ≥php.ini中的post_max_size - Apache：确认
LimitRequestBody没设成 0 或过小值 - 如果用云 WAF（如 Cloudflare），它也有默认 100MB 上传限制，需单独调整
- 超时也要同步调大：
fastcgi_read_timeout（Nginx）或Timeout（Apache）
调试时打开 error_log 并设为 error_reporting(E_ALL)，否则静默失败很难定位。
