Core PHP中AJAX POST提交表单未触发预期文件校验逻辑问题

问题现象 #

通过AJAX POST提交带文件上传的表单时，未选择文件点击提交，后端输出Sorry, there was an error uploading your file.，但预期应输出File Not Selected。

问题原因 #

后端代码依赖isset($_POST['btnupload'])判断表单是否提交，但使用new FormData(this)创建表单数据时，submit按钮的name="btnupload"不会被自动包含到FormData中，导致后端该判断条件始终不成立，进入错误分支。

修复方案 #

有两种可行的修复方式：

方式一：修改后端判断逻辑（推荐） #

直接跳过对btnupload的判断，直接检查文件是否存在：

<?php
if(!empty($_FILES["product_file"]["name"])){
    // 文件存在时的后续处理逻辑
} else {
    echo 'File Not Selected'; 
}
?>

方式二：前端手动添加btnupload到FormData #

在AJAX提交前，手动将btnupload字段添加到FormData中：

$('#uploadproImage').on('submit', function (e) {
    e.preventDefault();
    let formData = new FormData(this);
    // 手动添加submit按钮的字段
    formData.append('btnupload', '1');
    $.ajax({
        type: 'POST',
        url: 'appcode/product.php',
        data: formData,
        dataType: 'json',
        contentType: false,
        cache: false,
        processData: false,
        success: function (response) {
            alert(response);
            // 后续逻辑
        }
    });
});

补充优化 #

当前后端输出纯文本，但前端AJAX设置了dataType: 'json'，会导致JSON解析失败，建议统一输出JSON格式：

<?php
header('Content-Type: application/json');
if(!empty($_FILES["product_file"]["name"])){
    echo json_encode(['status' => 1, 'msg' => 'File selected']);
} else {
    echo json_encode(['status' => 0, 'msg' => 'File Not Selected']);
}
?>

前端回调可对应处理JSON响应：

success: function (response) {
    alert(response.msg);
    if (response.status == 1) {
        $('#uploadproImage')[0].reset();
    }
}

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