PHP文件上传时文件数据存入$_POST而非$_FILES问题求助

核心排查方向（按出现概率从高到低排序） #

• JS提交逻辑冲突：检查页面是否绑定了表单提交事件，用$.serialize()/手动拼接FormData错误的方式提交表单——这类序列化方法默认不会携带文件二进制数据，只会把文件名作为普通字符串提交到$_POST，这是同一份代码之前能用、突然失效的最高发原因，一般是后续加了表单校验、异步提交逻辑时引入的问题。
• 大小限制超限：核对两类配置：
  • PHP配置：打印phpinfo()确认file_uploads=On，post_max_size、upload_max_filesize值大于你要上传的图片大小，upload_tmp_dir配置的临时目录存在且有Web进程读写权限
  • Web服务器配置：Nginx/Apache的请求体大小限制（如Nginx的client_max_body_size）要大于上传文件大小，超限后请求会被截断，PHP无法接收到完整文件数据
• 请求被拦截：检查服务器WAF、安全防护插件是否拦截了multipart/form-data类型的上传请求，拦截后PHP无法正常解析文件字段。
• 表单字段重名：检查页面是否存在其他name="files"的普通输入框，覆盖了文件字段的解析结果。

现有代码问题修正 #

你贴的代码存在几处逻辑错误，需要同步修复：

1. 多余的多文件上传逻辑报错：你的file输入框没有加multiple属性，属于单文件上传场景，代码中move_uploaded_file($_FILES['files']['tmp_name'][$i], $target_file)这段引用了未定义的$i变量，会直接触发报错，直接删除这段冗余逻辑即可。
2. 缺少上传错误校验：在处理上传文件前先校验错误码，能快速定位根因，修复后的完整处理代码如下：

if (isset($_POST['submit'])) {
    // 先校验上传错误
    if ($_FILES['files']['error'] !== UPLOAD_ERR_OK) {
        exit("上传失败，错误码：".$_FILES['files']['error']."，对应说明：1=超PHP配置大小限制 2=超表单大小限制 3=文件传输中断 4=未选择文件 6=临时目录不存在 7=写入磁盘失败");
    }
    $filename = $_FILES['files']['name'];
    $target_file = 'upload/' . $filename;
    $file_extension = strtolower(pathinfo($target_file, PATHINFO_EXTENSION));
    $valid_extension = array("png", "jpeg", "jpg");
    if (!in_array($file_extension, $valid_extension)) {
        exit("仅支持png、jpg、jpeg格式图片");
    }
    // 自动创建不存在的上传目录，设置正确权限
    if (!is_dir('upload')) mkdir('upload', 0755, true);
    try {
        if (move_uploaded_file($_FILES['files']['tmp_name'], $target_file)) {
            $query = "INSERT INTO `images` (`vraag_id`, `img_name`, `image`) VALUES (?, ?, ?)";
            $statement = $conn->prepare($query);
            $statement->execute(array($id2, $filename, $target_file));
        } else {
            throw new \Exception("文件保存到目标目录失败，请检查upload目录权限");
        }
    } catch (Exception $e) {
        echo "Error: " . $e->getMessage();
    }
}

快速验证技巧：在处理代码最开头先打印var_dump($_POST);var_dump($_FILES);die;，根据输出结果可以快速缩小排查范围，如果$_FILES完全为空，优先查前面提到的JS提交、大小限制问题。

内容的提问来源于stack exchange，提问作者Jean