PHP 中 rename()处理含 % 文件名失败的根本原因是 % 在 shell、URL 编码或 Web 服务器层被提前解析，而非 PHP 限制；应使用 rawurldecode()解码 HTTP 来源文件名，拼接绝对路径后直接调用 rename()。
PHP 中用 rename() 替换含 % 的文件名会失败？
直接调用 rename() 处理含百分号（%）的文件名，大概率失败，且不报错或只报 Warning: rename(): No such file or directory。根本原因不是 PHP 本身限制，而是 % 在 shell 层、URL 编码 上下文或某些文件系统 API 中被提前解释——尤其当你从 URL、表单或日志里拿到原始文件名时，%20 这类编码可能已混入，或 % 被当成格式化占位符误解析。
先确认文件名里到底有没有真实 % 字符
别急着替换，先用 var_dump() 看清原始 字节：
var_dump($filename); // 输出类似：string(15) "report%final.pdf" // 或更危险的：string(17) "report%20final.pdf"如果看到 %20，说明是 URL 编码残留，必须先 urldecode()；如果看到裸 %（如 %final），则需转义或绕过解析层。
-
%是合法文件名字符（Linux/macOS/NTFS 都支持），但 PHP 的某些扩展（如glob()、scandir()）或 Web 服务器（Nginx/Apache 对 URI 的预处理）可能提前截断或拒绝 - Windows 下
%本身不禁止，但 cmd/powershell 会尝试展开 环境变量（如%PATH%），若你用exec()调用 shell 命令重命名，就必然出错 - 最稳妥路径：全程用 PHP 原生函数操作，避免经过 shell
安全替换含 % 的文件名的三步法
核心原则：不依赖外部命令，不拼接字符串进 shell，对 % 不做特殊转义（它本就不需转义），只确保路径字节准确。
立即学习“PHP 免费学习笔记（深入）”；
- 用
rawurldecode()处理从 HTTP 请求来的文件名（比urldecode()更严格，能处理%25→%） - 用
realpath()或手动拼接绝对路径，避免相对路径引发的解析歧义 - 直接调用
rename($old_path, $new_path)，两个参数都传完整、未被 shell 解析过的字符串
示例：
$original = "data%report.pdf"; // 来自 $_POST['filename'] 或数据库 $decoded = rawurldecode($original); // 若原串含 %25，则此步必要 $old_path = __DIR__ . '/uploads/' . $decoded; $new_path = __DIR__ . '/uploads/' . 'clean_report.pdf'; if (rename($old_path, $new_path)) {echo "OK";} else {error_log("rename failed:" . $old_path . "→" . $new_path); // 检查 error_log 输出的路径是否含意外空格或不可见字符 }为什么不用 str_replace('%', '%', $name)？
加反斜杠毫无意义。PHP 的 rename() 不走 shell，不需要 shell 转义；文件系统根本不认 % 这种写法——它要么找名为 % 的文件（不存在），要么因路径非法失败。真正要防的是：% 出现在 shell 命令中（如 exec("mv'$old''$new'")），此时应改用 escapeshellarg()，但更推荐彻底弃用 exec()。
容易被忽略的一点：Web 服务器（尤其是 Nginx）默认会 decode URI，再交给 PHP；如果你在 location 块里用了 rewrite 或 try_files，可能已二次 decode，导致 %2520 变成 %20 再变成空格——这种嵌套编码问题，必须在入口统一 rawurldecode() 一次并仅一次。
