rename() 可原子化跨目录移动文件，无需 copy+unlink；需预检路径存在性与权限，处理中文名要编码统一并过滤非法字符，跨文件系统时须降级为 copy+校验+unlink。
用 rename() 批量移动文件最直接
PHP 没有内置的“批量移动”函数，但 rename() 本身是原子操作，既可重命名也可跨目录移动，只要目标目录有写权限、源路径存在、目标路径不冲突，就一步到位。别绕路用 copy() + unlink()，多一次 I/O 还可能中断留脏数据。
常见错误现象：Warning: rename(): No such file or directory —— 多半是源路径拼错，或没加 realpath() / __DIR__ 做路径归一化；Permission denied 则常因目标目录不可写，或跨文件系统（如从 /tmp 移到 /home）失败（部分系统限制）。
- 始终用
is_file($src)和is_dir($dest_dir)预检，别只靠rename()返回值判断 - 目标路径必须包含完整文件名，比如
rename('a.txt', 'backup/a.txt')，不能只写'backup/' - 批量时建议用
foreach包裹，单个失败不影响其余；别用array_map(rename, ...)——rename()不接受回调式调用
处理中文文件名或特殊字符要转义路径
Linux/macOS 下路径本身支持 UTF-8，但 PHP 的 rename() 在某些旧版本或 CGI 模式下会因环境编码不一致导致乱码失败；Windows 则对 :、、<code>> 等字符敏感。安全做法是：不依赖用户直传的文件名构造路径，而是用哈希或白名单过滤后生成目标名。
使用场景：上传后按日期归档，或清理临时目录。例如把 uploads/tmp_*.jpg 移到 uploads/processed/ 下并重命名为 img_{md5}.jpg。
立即学习“PHP免费学习笔记（深入）”；
- 用
mb_convert_encoding($filename, 'UTF-8', 'auto')统一输入编码（如果来源不可控） - 目标文件名建议用
basename($src)提取后，再过一遍preg_replace('/[^a-zA-Z0-9._-]/', '_', $name)清洗 - 绝对路径优先用
__DIR__ . '/uploads/...'，避免相对路径在 CLI/Web 下行为不一致
大文件或大量文件时注意超时和内存
rename() 本身不读文件内容，所以无论 1KB 还是 1GB，耗时都极短——它只是更新 inode 指针。真正卡住的往往是循环本身：比如用 glob('*.log') 匹配十万文件，数组全载入内存会爆；或 Apache 默认 30 秒超时，脚本中途被杀。
- 用
scandir()+foreach配合yield（PHP 5.5+）流式处理，避免一次性加载全部文件名 - CLI 模式下加
set_time_limit(0)；Web 下建议分页处理，每次最多 100 个，用 AJAX 轮询或队列解耦 - 移动前用
disk_free_space($dest_dir)检查目标磁盘剩余空间，避免移一半报错
跨分区移动失败时 fallback 到 copy+unlink
rename() 跨文件系统（比如 ext4 → NTFS 挂载点，或 Docker 容器内外）会返回 false 并报 EXDEV 错误。此时必须降级：先 copy()，校验 md5_file() 一致性，再 unlink() 源文件。不校验就删源文件，风险极高。
容易踩的坑：有人用 if (!rename(...)) { copy(...); unlink(...); }，但没检查 copy() 是否成功，结果源删了、目标没拷完，文件就丢了。
- 用
clearstatcache(true, $src)在unlink()前刷新文件状态，避免缓存导致误判 - 目标目录不存在时，
rename()不会自动创建，需提前mkdir($dest_dir, 0755, true) - 生产环境强烈建议加日志：记录每个文件的源、目标、是否成功、错误码（
error_get_last()）
rename 一把梭。 
