rename()重命名目录时目标已存在（非空）会直接失败并返回false，抛出“File exists”警告；PHP不会自动删除或合并目录，必须手动递归清理后重试。
rename() 重命名目录时目标已存在会怎样
PHP 的 rename() 对目录和文件的处理逻辑不同：文件被同名目标覆盖是静默成功的；而目录遇到同名目标（非空）直接报 Warning: rename(): File exists 并返回 false。它不会删除、合并或提示“是否覆盖”，行为就是失败。
常见误判是以为加了 if (file_exists($new_dir)) unlink($new_dir); 就能清掉——但 unlink() 只删文件，对目录无效，还会触发 Warning: unlink(): Is a directory。
- 必须先用
is_dir($new_dir)判断，再递归删除（如自定义rrmdir()或调用exec('rm -rf ' . escapeshellarg($new_dir))，仅限 Linux） - Windows 下不能依赖
exec('rmdir /s /q')，需用 PHP 原生递归遍历 +unlink()+rmdir() - 更稳妥的做法是先
rename($old_dir, $backup_dir)备份旧目录，再操作新目录，避免中间态丢失
跨文件系统重命名必然失败，怎么提前发现
rename() 是原子级系统调用，本质是 mv 命令的封装，跨挂载点（比如从 /home 移到 /mnt/usb）时底层会 fallback 到 copy+delete，但 PHP 的 rename() 不做 fallback，直接返回 false，且不抛异常，只可能有 warning。
无法靠 file_exists() 或权限检查提前识别——因为源和目标路径本身都合法。唯一可靠方式是检查是否同设备：
立即学习“PHP免费学习笔记（深入）”；
- 用
stat($path)['dev']获取设备号，对比源与目标父目录的dev值（注意：目标父目录必须存在，否则stat()失败） - 若设备号不同，必须改用
copy()+rrmdir()组合实现“伪重命名” - 尤其在 Docker 容器或 NAS 挂载场景下，
/var/www和/data很可能分属不同文件系统
中文目录名在 Windows 和 Linux 下表现不一致
Linux 文件系统（ext4/xfs）原生支持 UTF-8 路径，只要 PHP 脚本文件保存为 UTF-8、Web 服务器环境变量（如 LANG）设置正确，rename() 处理中文目录名基本无坑；Windows 则复杂得多。
Windows 默认使用系统 ANSI 编码（如 GBK），而 PHP 内部字符串是字节流，不做自动转码。结果就是：rename('旧目录', '新目录') 在 Windows 上可能因编码 mismatch 导致 No such file or directory。
- 统一用
mb_convert_encoding($path, 'UTF-8', 'auto')转换路径（但需确认源编码） - 更稳的方式是避开中文名，用英文+时间戳替代，比如
dir_202606251752 - 不要依赖
iconv()，Windows 下常因缺失编码别名报错；mbstring扩展必须启用
SELinux 或进程占用导致 Permission denied
Linux 下 Permission denied 不一定是权限位问题，很可能是 SELinux 上下文限制或目录被其他进程锁定（如 IDE 实时扫描、rsync 正在同步、Apache 正在读取索引）。
rename() 需要对源目录有 read+execute 权限（进入目录），对目标父目录有 write+execute 权限（创建子项）。但即使权限全开，仍可能失败。
- 临时关闭 SELinux 测试：
setenforce 0，若成功则说明是上下文问题，需用chcon -R -t httpd_sys_rw_content_t /path - 用
lsof +D /path查看是否有进程正在访问该目录 - Windows 下资源管理器选中目录、CMD 进入该目录、甚至某些杀毒软件实时监控，都会导致
rename()拒绝操作
rename() 绝不自动创建上级路径，哪怕只差一级。这个约束在动态生成路径时特别容易漏检。 
