rename()函数不支持批量重命名，需循环调用；须确保目标父目录存在、路径不冲突、同文件系统，否则需降级为复制+删除，并注意路径拼接、跨平台分隔符及glob筛选等细节。
rename() 函数不能直接批量重命名文件夹
PHP 的 rename() 本身只支持单次操作，且对目标路径有严格要求：目标父目录必须存在、目标路径不能已存在、跨文件系统可能失败。想“批量”改名，本质是写个循环调用它，而不是找某个隐藏的批量开关。
常见错误现象：Warning: rename(): No such file or directory —— 多半是目标父目录不存在；Warning: rename(): File exists —— 没检查目标文件夹是否已存在；还有人误用 scandir() 后直接 foreach 改名，结果边遍历边修改导致漏改或重复改。
- 先用
glob()或scandir()获取待处理文件夹列表，过滤掉.和.. - 确保每个新名字对应的目标父目录已存在（可用
is_dir()+mkdir()配合recursive参数） - 改名前用
is_dir()确认源路径存在且是目录，用!is_dir($new_path)确保目标未被占用 - 建议加异常防护：用
@rename()抑制警告，再结合error_get_last()判断是否真失败
用 glob() 匹配带规则的文件夹名更安全
比起 scandir() 返回全部条目再手工过滤，glob() 能直接按 shell 风格通配符筛选，比如只改 user_* 开头的文件夹，或排除 cache、logs 等敏感目录。
注意点：glob() 默认不返回隐藏目录（以 . 开头），如果需要包含，得显式写 .*；另外 Windows 下大小写不敏感，Linux 下敏感，匹配时别依赖大小写差异。
立即学习“PHP免费学习笔记（深入）”；
- 匹配当前目录下所有以
old_开头的文件夹：glob('old_*', GLOB_ONLYDIR) - 匹配多级路径（如
uploads/*/temp）需加GLOB_BRACE或分步处理 -
GLOB_ONLYDIR很关键，否则会混入同名文件，后续rename()可能静默失败
重命名时路径拼接容易出错
PHP 中路径分隔符在不同系统上不统一，硬写 / 或 都可能翻车。尤其当源路径来自用户输入或配置，没做 realpath() 或 dirname() 标准化时，rename('a/b', 'c/d') 可能因相对路径解析错位而失败。
典型错误：$new = str_replace('old_', 'new_', $old); rename($old, $new); —— 如果 $old 是相对路径，$new 就可能指向错位置；或者 $old 带尾部斜杠（如 folder/），str_replace 后变成 new_folder/，但 rename() 对尾部斜杠敏感，部分环境会报错。
- 统一用
dirname($path) . DIRECTORY_SEPARATOR . $basename拼新路径 - 用
rtrim($path, '/\')去掉原始路径末尾斜杠再处理 - 改名前用
realpath($old)和realpath(dirname($new))确认两个路径都可解析
跨磁盘或远程挂载点重命名会失败
rename() 在 Linux 下本质是 mv 系统调用，仅支持同一文件系统内的原子重命名。如果源和目标在不同分区、NAS 或 Docker 卷绑定路径下，会直接返回 false 并报 EXDEV 错误（PHP 显示为 Invalid cross-device link）。
这种情况没法绕过，只能退化为“复制 + 删除”：用 exec('cp -r ...') 或递归 copy() + rrmdir()，但要注意权限继承、符号链接处理、大文件阻塞等问题。
- 先用
disk_free_space()和filesize()估算空间，避免复制中途爆盘 - 递归复制后，用
sha1_file()校验关键文件（非全量），再删原目录 - 不要用
system('mv ...')试图替代 —— 它同样受 EXDEV 限制，且引入 shell 注入风险
最麻烦的不是语法，是判断什么时候该用 rename()，什么时候必须切到复制流程。这个判断点藏在 stat($old)['dev'] !== stat(dirname($new))['dev'] 里，但多数人根本没想到要查设备号。
