PHP中重命名含空格文件失败？调用file_exists仍无效，求问题原因

核心问题 #

前端提交文件名时，空格可能被自动URL编码为%20，而你直接将$_POST['oldname']拼接到路径中，导致生成的文件路径带%20而非真实空格，和服务器上的实际文件名不匹配，因此rename()找不到目标文件，执行失败。

解决方案 #

1. 解码POST参数中的空格
   对传入的旧文件名做URL解码处理，修正路径匹配问题：

   function renamePDF()
   {
       $path = __DIR__ . "/../../uploads/";
       // 对旧文件名进行URL解码，还原空格
       $old = $path . urldecode($_POST['oldname']);
       $new = $path . $_POST['newName'] . ".pdf";
       rename($old, $new);
   }
   

2. 增加错误排查机制
   给rename()添加错误判断，输出具体错误信息，方便后续排查其他潜在问题：

   function renamePDF()
   {
       $path = __DIR__ . "/../../uploads/";
       $old = $path . urldecode($_POST['oldname']);
       $new = $path . $_POST['newName'] . ".pdf";
       
       if (!rename($old, $new)) {
           $error = error_get_last();
           echo "重命名失败: " . $error['message'];
       }
   }
   

额外建议 #

• 路径安全校验：不要直接信任用户输入，可通过realpath()验证文件是否在指定的uploads目录内，防止路径遍历攻击：

  $oldRealPath = realpath($old);
  $uploadRealPath = realpath($path);
  if ($oldRealPath === false || strpos($oldRealPath, $uploadRealPath) !== 0) {
      die("无效的文件路径");
  }
  

• 权限检查：确保uploads目录具备足够的读写权限，避免因权限不足导致重命名失败。

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