PHP文件上传必须先检查$_FILES'file'是否为UPLOAD_ERR_OK,再校验扩展名、用move_uploaded_file安全落地,确保表单enctype和php.ini配置正确。
$_FILES 结构和错误码PHP 文件上传失败,90% 是因为没读 $_FILES['file']['error'] 就直接处理。这个数组不是“有值就代表成功”,它包含 name、tmp_name、size、type、error 五个键,其中 error 才是判断依据。常见错误码:0(成功),1(超 upload_max_filesize),2(超 HTML 表单 MAX_FILE_SIZE),4(未选择文件)。
实操建议:
if ($_FILES['file']['error'] 
=== UPLOAD_ERR_OK),而不是只看 !empty($_FILES['file']['tmp_name'])
$_FILES['file']['tmp_name'] 是临时路径,仅本次请求有效,不复制或移动就失效$_FILES['file']['type'](浏览器提供,可伪造),校验 MIME 类型应使用 finfo_file() 或扩展名白名单move_uploaded_file() 而不是 copy() 或 rename()
move_uploaded_file() 是 PHP 唯一安全的上传文件落地方式。它会检查源文件是否为合法上传临时文件(即是否在 $_FILES 中生成),防止 LFI 或路径遍历攻击。直接 copy($_FILES['file']['tmp_name'], $dest) 是严重安全隐患。
实操建议:
__DIR__ . '/uploads/' . basename($safe_filename) 拼接$_POST['dir'] 构造目标路径md5_file($_FILES['file']['tmp_name']) . '.' . pathinfo($_FILES['file']['name'], PATHINFO_EXTENSION)),别直接用原名前端 缺失、max_file_size 隐藏域缺失、或后端 php.ini 的 file_uploads 关闭,都会让 $_FILES 为空,但不会报错——容易误判为“没提交”。
实操建议:
enctype="multipart/form-data",否则 $_FILES 永远为空ini_get('file_uploads') 和 ini_get('upload_max_filesize') 动态检查配置post_max_size(必须 ≥ upload_max_filesize),否则整个 POST 被截断,$_FILES 为空且 $_POST 也不全var_dump($_FILES, $_POST, ini_get('file_uploads')); 快速定位是前端漏配还是后端限制以下是一个最小可行、带错误反馈的上传逻辑,不依赖框架,可直接测试:
注意 uploads/ 目录需手动创建并设好权限;uniqid() 避免同名覆盖,但生产环境建议用更健壮的文件名生成策略;真正的安全校验还需加 MIME 类型检测和病毒扫描,但那是另一层的事了。