Ajax+PHP图片上传报错，求助排查move_uploaded_file路径异常

嘿，我一眼就揪出你问题的根源了——咱们先拆解下这个报错：

message: "move_uploaded_file(/site/uploads/users/user.png): failed to open stream: No such file or directory"

这个错误的核心原因有两个：

1. 目标目录压根不存在：你写的/site/uploads/users/在Windows的XAMPP环境里，指的是系统根目录（C盘根目录）下的路径，但你的项目肯定是放在C:\xampp\htdocs里的，这个路径自然找不到。
2. 路径格式错了：直接用/site/这种绝对路径，在Windows环境下会指向系统根，而不是你的项目根目录。

接下来给你一步步的修复方案：

1. 先搞定目录创建与路径拼接 #

修改你的Controller代码，自动创建缺失的目录，并用项目根目录来拼接正确路径：

public function upload(){
    if(!empty($_FILES) && isset($_FILES['user-photo-input'])):
        $file = $_FILES['user-photo-input'];
        if(is_uploaded_file($file['tmp_name'])):
            // 用$_SERVER['DOCUMENT_ROOT']获取项目的真实根目录路径
            $uploadDir = $_SERVER['DOCUMENT_ROOT'] . '/site/uploads/users/';
            
            // 检查目录是否存在，不存在就递归创建（第三个参数true支持多级目录创建）
            if (!is_dir($uploadDir)) {
                mkdir($uploadDir, 0755, true);
            }
            
            $trgPath = $uploadDir . $file['name'];
            if(move_uploaded_file($file['tmp_name'], $trgPath)):
                // 返回给前端用相对路径就行，方便页面展示图片
                $webPath = '/site/uploads/users/' . $file['name'];
                return response()->json(['success' => '1', 'photo' => $webPath]);
            else:
                // 加上错误返回，方便调试排查权限问题
                return response()->json(['success' => '0', 'error' => '无法移动文件，可能是目录权限不足']);
            endif;
        endif;
    endif;
    // 处理没有文件上传的情况
    return response()->json(['success' => '0', 'error' => '未检测到上传文件']);
}

2. 检查前端表单的必填属性 #

别漏了给上传表单加enctype="multipart/form-data"，不然Ajax根本传不了文件：

<form id="user-upload-photo" enctype="multipart/form-data">
    <input type="file" name="user-photo-input" />
    <button type="submit">上传头像</button>
</form>

3. 额外的安全小建议 #

• 别直接用用户上传的文件名，容易出现重名或者恶意文件名（比如路径遍历字符），可以生成唯一文件名：

  // 保留原文件后缀，生成唯一文件名
  $extension = pathinfo($file['name'], PATHINFO_EXTENSION);
  $uniqueName = uniqid('user_', true) . '.' . $extension;
  $trgPath = $uploadDir . $uniqueName;
  

• 记得限制上传文件的类型和大小，避免上传恶意文件或者超大文件。

内容的提问来源于stack exchange，提问作者Valter Sousa Cardoso