rename() 是 PHP 唯一可靠的重命名目录方法，本质为系统级操作，要求路径合法、权限充足、同文件系统，且需手动处理冲突、大小写及 SELinux 等跨平台与安全限制。
rename() 是唯一可靠的方法
PHP 修改文件夹名称只能用 rename()，没有其他内置函数可替代。它本质是操作系统级的重命名操作，既适用于文件也适用于目录，只要权限和路径合法就成功。
常见错误现象包括：Warning: rename(): No such file or directory（源路径不存在或拼写错误）、Permission denied（目标父目录不可写，或源目录被进程占用）、File exists（目标路径已存在且非空目录）。
- 源路径和目标路径必须是**绝对路径**或**相对于当前工作目录的正确相对路径**；建议统一用
__DIR__或realpath()构造 - 目标路径的父目录必须存在且具有写权限；
rename()不会自动创建上级目录 - 不能跨文件系统重命名（例如从
/home移到/mnt/usb），此时会失败并返回false - Windows 下对正在被打开的文件夹（如被资源管理器选中、被 IDE 监控）可能拒绝操作
修改前必须检查目标是否已存在
直接调用 rename() 覆盖已有同名目录会失败——PHP 不会自动删除或合并，而是抛出警告并返回 false。必须手动处理冲突。
典型场景：用户上传压缩包后解压到固定名称的临时目录，下次运行前需清空或重命名旧目录。
立即学习“PHP免费学习笔记（深入）”；
- 用
is_dir()检查目标是否存在，存在则先rrmdir()（自定义递归删除函数）或exec('rm -rf ...')（仅 Linux，慎用） - 不要依赖
unlink()删除目录，它只删文件；删空目录要用rmdir()，但前提是目录为空 - 若想“安全覆盖”，推荐先
rename()旧目录为带时间戳的备份名，再重命名新目录，避免中间态丢失
注意 Windows 和 Linux 的大小写敏感差异
在 Linux/macOS 上，rename('A', 'a') 是合法操作；但在 Windows 上，由于文件系统不区分大小写，该调用会返回 true 但实际无变化，甚至可能引发后续路径判断混乱。
使用场景：部署脚本在多平台运行时，目录名变更逻辑意外失效。
- 跨平台代码中，避免仅靠大小写区分目录名
- 判断目录是否存在时，别用
file_exists()后再rename()，而应统一用is_dir()并规范路径格式 - 若需强制更新，可先
rename()到一个临时名（如加_tmp），再rename()到目标名，绕过大小写判定歧义
权限与 SELinux 可能静默阻止操作
即使 PHP 进程有读写权限，Linux 上启用了 SELinux 时，rename() 也可能失败且不报具体原因，只返回 false。日志里看不到明显错误，调试困难。
典型表现：本地开发环境一切正常，上线到 CentOS/RHEL 服务器后重命名始终失败。
- 临时验证：执行
setenforce 0关闭 SELinux，再测试；若恢复成功，说明是策略限制 - 永久修复：用
audit2why查看拒绝日志，再用audit2allow生成并加载新策略 - Web 服务器用户（如
www-data或apache）必须对源目录、目标父目录都有rename权限，SELinux 中对应为move_dir和add_name
rename() 成功只表示系统调用完成，不代表后续代码能立刻读取新目录下的文件——某些 NFS 或容器挂载场景存在缓存延迟，需要主动 clearstatcache() 或加短暂 usleep(10000) 再访问。 
