使用 PHP rename() 替换含多点文件名时，必须用 pathinfo() 拆解路径、dirname()/basename() 构造新路径，并调用 realpath() 校验，否则易因路径解析错误导致文件误写或覆盖。
PHP rename() 替换含点号的文件名要小心路径解析
直接用 rename() 替换带多个点号的文件名（比如 report.v1.2024.pdf → report.v2.2024.pdf）时，PHP 不会报错，但容易因路径处理不当导致目标文件写入到错误目录，甚至覆盖同名文件。根本原因在于 PHP 对 . 和 .. 的路径解析是运行时行为，而 rename() 本身不校验路径合法性。
- 务必对源路径和目标路径都调用
realpath()或至少用dirname()+basename()拆解再拼接，避免传入相对路径片段 - 若文件名来自用户输入（如表单、URL 参数），必须先用
basename()过滤掉路径遍历字符（../、/etc/passwd等） -
rename()第二个参数（目标）如果只写文件名（无斜杠），会被视为当前工作目录下的文件，而非源文件所在目录 —— 这是最常见的误操作
正确提取并替换带多点的文件名（不含路径）
不能简单用 str_replace() 或正则全局替换所有点，否则会破坏扩展名或路径分隔逻辑。应优先使用 PHP 原生函数分离「目录」「文件名主体」「扩展名」三部分。
- 用
pathinfo($filename, PATHINFO_DIRNAME)获取目录部分 - 用
pathinfo($filename, PATHINFO_FILENAME)获取不含扩展名的主名称（注意：它会截掉最后一个点之后的内容，report.v1.2024→report.v1.2024，不是report.v1） - 用
pathinfo($filename, PATHINFO_EXTENSION)获取真实扩展名（只取最后一个点后的部分） - 组合新文件名时，确保扩展名仍为原值，仅修改
FILENAME部分
$_old = '/var/www/uploads/report.v1.2024.pdf';
$path_info = pathinfo($_old);
$new_filename = $path_info['dirname'] . '/' . str_replace('v1', 'v2', $path_info['filename']) . '.' . $path_info['extension'];
// 结果：/var/www/uploads/report.v2.2024.pdf
if (rename($_old, $new_filename)) {
echo "OK";
} else {
echo "Rename failed: " . error_get_last()['message'];
}
Windows 下大小写不敏感 + 点号结尾的坑
Windows 文件系统对文件名大小写不敏感，且允许文件名以点号结尾（如 test.），但 PHP 在该平台下可能将 test..pdf 解析为 test.pdf，或在 rename() 时静默失败。Linux 则直接拒绝创建以点结尾的文件名。
- 用
substr($basename, -1) === '.'检查文件名是否以点结尾，如有，强制截断（rtrim($basename, '.')） - 在 Windows 上测试前，先用
file_exists()检查目标路径是否已存在大小写不同但实际相同的文件（如Report.PDF和report.pdf） - 跨平台部署时，统一用小写扩展名 + 标准化文件名（
mb_strtolower()+ 正则清理非 ASCII 字符）可减少歧义
rename() 失败却没报错？检查 open_basedir 和权限链
rename() 在某些情况下返回 false 但 error_get_last() 为空，常见于 open_basedir 限制或跨文件系统移动（如从 /tmp 到 /home）。此时 PHP 实际执行的是「copy + unlink」模拟，而 copy 可能因权限不足静默失败。
立即学习“PHP免费学习笔记（深入）”；
- 确认源和目标都在
open_basedir白名单内（查看phpinfo()或ini_get('open_basedir')） - 用
is_writable(dirname($target))显式检查目标目录是否可写，而不是依赖rename()返回值 - 跨分区重命名必然失败，必须改用
copy()+unlink()，并手动处理失败回滚
pathinfo() 拆解、用 dirname()/basename() 构造，再加一层 realpath() 校验。否则看似替换了版本号，实则把文件丢进了上层目录，或者覆盖了配置文件。 
