rename()本身支持含等号文件名，失败主因是Web服务器（如Apache/Nginx）在路径传递中误解析等号，导致PHP接收路径被截断或污染；CLI模式下无此问题。
PHP 中用 rename() 替换含等号的文件名会失败？
直接调用 rename() 处理含 = 的文件名，通常不会报错，但可能静默失败或目标路径被意外截断——尤其当等号出现在查询参数风格路径中（比如 file=name=value.jpg），某些 Web 服务器（如 Apache + mod_rewrite）或 shell 层会提前解析等号，导致 PHP 实际收到的 $_SERVER['PATH_INFO'] 或 $_GET 被污染，进而影响文件路径构造。
真实场景下等号文件名的常见来源
用户上传时未过滤原始文件名、CDN 回源带参重命名、日志系统自动生成含时间戳和键值对的文件名（如 log=error&ts=1712345678.txt），都可能导致等号混入文件名。此时重点不是“能不能 rename”，而是“路径是否被完整传递到 PHP”。
- Web 服务器（如 Nginx）默认不解析 URL 中的等号，但若配置了
try_files或rewrite规则，且规则里用了$args或未转义的变量，就可能把=当成分隔符 - PHP CLI 模式下无此问题，
rename()可安全操作含等号的文件名（只要路径字符串本身没被 shell 解析） - Windows 系统对
=无限制，Linux/macOS 也完全支持，问题几乎全出在「路径如何抵达 PHP」这一环
安全替换含等号文件名的实操步骤
核心原则：绕过任何可能解析等号的中间层，确保 PHP 拿到的是原始、未解码的文件路径。
- 用
rawurldecode()处理传入的文件名（如果来自 URL 参数），避免浏览器自动编码导致%3D被误认为普通字符 - 构造绝对路径时，始终用
realpath()或__DIR__ . DIRECTORY_SEPARATOR拼接，杜绝相对路径被当前工作目录干扰 - 检查源文件是否存在用
is_file()，而非依赖file_exists()（后者对某些挂载文件系统可能有缓存偏差） - 执行
rename()前，先用var_dump()打印完整源/目标路径，确认等号仍在字符串中（例如string(22) "data/file=name=value.jpg"）
if (is_file($old_path = __DIR__ . '/data/' . rawurldecode($_GET['old']))) {
$new_name = rawurldecode($_GET['new']);
$new_path = __DIR__ . '/data/' . $new_name;
if (rename($old_path, $new_path)) {
echo "OK";
} else {
error_log("rename failed: $old_path -> $new_path");
}
}
为什么不用 str_replace() 或正则预处理等号？
因为等号本身是合法文件名字符，不需要、也不应该被“过滤”或“替换”。强行用 str_replace('=', '_', $filename) 会破坏原始语义，比如把 config=prod.json 改成 config_prod.json，后续程序可能无法按约定键名识别配置环境。真正要处理的是「传输链路」，不是文件名内容。
立即学习“PHP免费学习笔记（深入）”；
最容易被忽略的一点：Apache 的 AcceptPathInfo Off（默认）会导致 PATH_INFO 中含等号时整个 path 被截断；Nginx 的 fastcgi_split_path_info 正则若没转义等号，也会切错。这些配置层面的问题，比 PHP 代码更常成为根因。
