PHP中move_uploaded_file无法移动图片至上传文件夹，请求代码排查

我来帮你排查这个文件上传的问题，先梳理几个关键问题和修复步骤：

1. 先解决「看不到具体错误」的核心问题 #

你当前代码里的错误输出逻辑完全错了：mysqli_error($con)是用来获取数据库操作的错误信息，和move_uploaded_file的文件上传操作毫无关系！这就是你只看到"error"却没具体提示的原因。

把错误输出改成这样，就能拿到真实的上传错误：

else {
    $upload_error = error_get_last();
    echo "上传失败: " . $upload_error['message'];
}

2. 逐一排查常见上传失败原因 #

权限与路径问题 #

• 确认upload文件夹存在，且PHP运行的用户（通常是www-data、apache或nginx）有写入权限。测试阶段可以用命令设置权限：chmod 755 upload，生产环境建议更严格的权限配置。
• 尽量用绝对路径避免相对路径歧义，比如把上传路径改成：

  $upload_path = __DIR__ . "/upload/" . $image; // __DIR__代表当前脚本所在目录
  $uploading = move_uploaded_file($imgtmp, $upload_path);
  

PHP配置限制 #

检查php.ini里的上传相关参数，也可以在脚本开头加phpinfo();查看当前生效配置：

• upload_max_filesize：是否小于你上传的图片大小
• post_max_size：这个值必须大于upload_max_filesize
• max_execution_time：上传大文件时是否超时
• upload_tmp_dir：临时文件夹是否存在且有读写权限

文件合法性问题 #

你的代码完全没验证上传文件是否是合法图片，这不仅有安全隐患，也可能导致上传被拦截：

// 验证文件MIME类型
$allowed_mimes = ['image/jpeg', 'image/png', 'image/gif'];
if (!in_array($_FILES['prod_image']['type'], $allowed_mimes)) {
    die("仅支持上传JPG/PNG/GIF格式图片");
}

// 验证文件扩展名
$allowed_exts = ['jpg', 'jpeg', 'png', 'gif'];
$file_ext = strtolower(pathinfo($image, PATHINFO_EXTENSION));
if (!in_array($file_ext, $allowed_exts)) {
    die("文件扩展名不合法");
}

3. 修复代码中的其他严重问题 #

消除SQL注入风险 #

你直接把用户输入拼接到SQL语句里，存在极高的注入漏洞，必须用预处理语句：

// 替换原来的insert语句
$qry = "INSERT INTO products (prod_name, prod_family, sur_finish, type, size, application, upfile) VALUES (?, ?, ?, ?, ?, ?, ?)";
$stmt = mysqli_prepare($con, $qry);
mysqli_stmt_bind_param($stmt, "sssssss", $prod_name, $prod_family, $sur_finish, $type, $size, $application, $upfile);
$ex = mysqli_stmt_execute($stmt);

避免文件覆盖 #

如果用户上传同名文件，会直接覆盖旧文件，建议给文件重命名：

$new_filename = uniqid() . "." . $file_ext; // 用随机ID生成新文件名
$upfile = "upload/" . $new_filename;

完整修正后的代码示例 #

<?php
include('database.php');
if(isset($_POST['addproduct'])) {
    // 获取表单数据
    $prod_name = $_POST['prod_name'];
    $prod_family = $_POST['prod_family'];
    $sur_finish = $_POST['sur_finish'];
    $type = $_POST['type'];
    $size = $_POST['size'];
    $application = implode(" & ", $_POST['application']);

    // 处理文件上传
    $file = $_FILES['prod_image'];
    $imgtmp = $file['tmp_name'];
    $file_error = $file['error'];

    // 先检查文件是否正常上传
    if($file_error !== UPLOAD_ERR_OK) {
        $error_map = [
            UPLOAD_ERR_INI_SIZE => "文件超过php.ini限制大小",
            UPLOAD_ERR_FORM_SIZE => "文件超过表单限制大小",
            UPLOAD_ERR_PARTIAL => "文件仅部分上传",
            UPLOAD_ERR_NO_FILE => "未选择上传文件",
            UPLOAD_ERR_NO_TMP_DIR => "服务器临时文件夹不存在",
            UPLOAD_ERR_CANT_WRITE => "无法写入磁盘",
            UPLOAD_ERR_EXTENSION => "PHP扩展阻止了文件上传"
        ];
        echo "上传错误: " . ($error_map[$file_error] ?? "未知错误");
        exit;
    }

    // 验证文件类型
    $allowed_mimes = ['image/jpeg', 'image/png', 'image/gif'];
    $allowed_exts = ['jpg', 'jpeg', 'png', 'gif'];
    $file_mime = $file['type'];
    $file_ext = strtolower(pathinfo($file['name'], PATHINFO_EXTENSION));

    if(!in_array($file_mime, $allowed_mimes) || !in_array($file_ext, $allowed_exts)) {
        echo "仅支持上传JPG/PNG/GIF格式的图片";
        exit;
    }

    // 确保上传目录存在
    $upload_dir = __DIR__ . "/upload";
    if(!is_dir($upload_dir)) {
        mkdir($upload_dir, 0755, true);
    }

    // 生成唯一文件名
    $new_filename = uniqid() . "." . $file_ext;
    $upload_path = $upload_dir . "/" . $new_filename;
    $upfile = "upload/" . $new_filename;

    // 执行文件移动
    $uploading = move_uploaded_file($imgtmp, $upload_path);
    if($uploading) {
        echo "文件上传成功！";
        // 预处理插入数据库
        $qry = "INSERT INTO products (prod_name, prod_family, sur_finish, type, size, application, upfile) VALUES (?, ?, ?, ?, ?, ?, ?)";
        $stmt = mysqli_prepare($con, $qry);
        mysqli_stmt_bind_param($stmt, "sssssss", $prod_name, $prod_family, $sur_finish, $type, $size, $application, $upfile);
        if(mysqli_stmt_execute($stmt)) {
            echo "产品信息已成功保存";
        } else {
            echo "数据库保存失败: " . mysqli_error($con);
        }
    } else {
        $last_error = error_get_last();
        echo "文件移动失败: " . $last_error['message'];
    }
}
?>

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