rename() 失败常见原因包括跨文件系统、权限不足、目标存在或被占用、路径非绝对或相对不可访问、目标目录不存在、用户输入未过滤导致路径遍历；Windows 下需注意文件锁定，调试应开启错误显示并用 error_get_last() 捕获。
rename() 函数在 PHP 中改名失败的常见原因
PHP 的 rename() 不是“改个名字”那么简单，它本质是系统级的原子操作，跨文件系统、权限不足、目标已存在都会直接失败，错误信息通常是 Warning: rename(): No such file or directory 或 Permission denied。
- 源路径和目标路径必须是**绝对路径**或**当前工作目录下可访问的相对路径**；用
__DIR__或realpath()显式拼接更稳 - 目标文件若已存在，
rename()在绝大多数系统（Linux/macOS）上会静默覆盖；但 Windows 下可能因文件被占用而失败 - 源和目标不能跨磁盘分区（比如从
/var/www移到/home/user），否则返回false且不报错细节——需用is_dir()+dirname()提前校验是否同设备
Windows 下 rename() 报错 “Access is denied” 怎么办
这通常不是权限设置问题，而是目标文件正被其他进程（如文本编辑器、IDE、杀毒软件、甚至 PHP 自己的 fopen('r+') 句柄）锁定。PHP 无法强制解锁。
- 先用
clearstatcache()清缓存，再用is_writable()检查目标目录是否可写（注意：不是检查目标文件！） - 尝试在重命名前加
fclose()所有对该文件的打开句柄，或用gc_collect_cycles()触发垃圾回收 - 实在不行，改用“复制 + 删除”组合：
copy()后unlink()源文件，但要注意原子性丢失和大文件性能损耗
rename() 跨目录移动文件时路径怎么写才安全
别依赖 getcwd()，它受脚本执行方式影响（CLI vs Web Server），容易出错。路径必须明确、可预测。
- 统一用
__DIR__或dirname(__FILE__)作为基准，例如：rename(__DIR__ . '/old.txt', __DIR__ . '/sub/new.txt') - 目标目录必须**事先存在**，
rename()不会自动创建父级目录；缺失时会报No such file or directory—— 需提前mkdir(..., 0755, true) - 路径中避免用户输入直拼，务必用
basename()过滤文件名，防止../路径遍历，例如：$new_name = basename($_POST['name']); rename($src, __DIR__ . '/uploads/' . $new_name);
rename() 返回 false 但没报错？怎么调试
默认情况下，PHP 可能抑制了 warning 级错误（尤其生产环境 error_reporting 关闭时），导致只看到 false 却不知原因。
立即学习“PHP免费学习笔记（深入）”；
- 临时开启错误显示：
error_reporting(E_ALL); ini_set('display_errors', '1');，再跑一次 - 用
error_get_last()捕获最后一次错误，放在rename()后立即调用，例如：if (!rename($a, $b)) { var_dump(error_get_last()); } - 检查返回值必须用
=== false，因为成功时返回true，而某些旧版本在失败时可能返回null或空字符串
