PHP文件上传失败的排查与修复求助

以下是针对你遇到的符合校验条件但上传失败问题的具体排查步骤：

• 检查上传目录权限
  确保Web服务器进程（如Apache的www-data、Nginx的nginx用户）对目标上传目录拥有写入权限：

  • Linux/macOS执行命令：

    chmod 755 /your/upload/directory/path
    chown www-data:www-data /your/upload/directory/path
    

  • Windows系统右键上传目录→属性→安全，给IIS_IUSRS或对应Web服务用户组添加写入权限。

• 核对PHP核心上传配置
  打开php.ini文件，检查以下参数是否满足上传需求：

  upload_max_filesize = 10M ; 需大于你自定义的文件大小限制
  post_max_size = 12M ; 必须大于upload_max_filesize
  max_execution_time = 30 ; 大文件上传可适当调高
  max_input_time = 60
  

  修改后重启Web服务器生效。

• 确认上传路径有效性
  避免使用相对路径导致的定位错误，改用绝对路径测试：

  $target_dir = $_SERVER['DOCUMENT_ROOT'] . "/uploads/";
  // 先打印路径确认是否存在
  var_dump(is_dir($target_dir));
  

  若返回false，需手动创建上传目录。

• 捕获原生上传错误码
  在upload.php中添加PHP原生错误捕获逻辑，直接定位系统层面的问题：

  if ($_FILES["fileToUpload"]["error"] !== UPLOAD_ERR_OK) {
      $error_messages = [
          UPLOAD_ERR_INI_SIZE => "文件大小超过php.ini限制",
          UPLOAD_ERR_FORM_SIZE => "文件大小超过表单MAX_FILE_SIZE限制",
          UPLOAD_ERR_PARTIAL => "文件仅完成部分上传",
          UPLOAD_ERR_NO_FILE => "未选择上传文件",
          UPLOAD_ERR_NO_TMP_DIR => "服务器缺少临时上传目录",
          UPLOAD_ERR_CANT_WRITE => "无法将文件写入磁盘",
          UPLOAD_ERR_EXTENSION => "PHP扩展阻止了文件上传"
      ];
      echo $error_messages[$_FILES["fileToUpload"]["error"]];
      exit;
  }
  

• 修复图片真实性校验逻辑
  若仅用getimagesize()判断图片，可能存在格式兼容问题（如WebP），补充MIME类型双重校验：

  $finfo = new Finfo(FILEINFO_MIME_TYPE);
  $file_mime = $finfo->file($_FILES["fileToUpload"]["tmp_name"]);
  $allowed_mimes = ["image/jpeg", "image/png", "image/gif", "image/webp"];
  if (!in_array($file_mime, $allowed_mimes) || !getimagesize($_FILES["fileToUpload"]["tmp_name"])) {
      echo "文件不是合法图片";
      exit;
  }
  

• 优化文件名处理逻辑
  避免因文件名重复、特殊字符导致的写入失败：

  $file_name = uniqid() . "_" . basename($_FILES["fileToUpload"]["name"]);
  $target_file = $target_dir . $file_name;
  

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