PHP7 中 rename() 不能安全递归移动目录，必须用「复制+删除」实现：因 rename() 对非空目录行为未定义，跨挂载点必失败，且存在覆盖、权限、符号链接等风险；推荐先 copyDirectory 校验后 deleteDirectory。
rename() 不能跨文件系统移动目录，PHP7 中递归移动目录必须拆解为「复制 + 删除」两步，不存在原子性移动操作。
为什么不能直接用 rename() 递归移动目录
即使源和目标在同一磁盘分区，rename() 对非空目录的行为在 PHP7 中仍是未定义的：它可能成功（某些 Linux 文件系统），也可能失败并报 Warning: rename(): Directory not empty。跨挂载点（如 /home 和 /var/www 不同分区）时必然失败。所以任何声称“rename() 可以递归移动目录”的做法都不可靠。
scandir() + 递归 rename() 的典型陷阱
有人尝试先 mkdir() 目标目录，再对每个子项调用 rename()，但会遇到以下问题：
- 子目录内有文件时，
rename($src_subdir, $dst_subdir)仍可能失败（尤其 Windows 或 NFS） - 没有检查目标路径是否已存在同名文件，导致静默覆盖或权限拒绝
- 忽略
is_writable()和is_readable()验证，出错后难以定位是权限还是路径问题 - 未处理符号链接：直接
rename()会移动链接本身，而非其指向内容
安全递归移动的实操步骤（推荐）
本质是「先完整复制，再递归删除源」，中间加校验防中断丢失：
- 用
copyDirectory()（基于scandir()+copy()）把整个源目录结构复制到目标位置 - 复制完成后，逐个比对关键文件的
md5_file()或filesize()，确认无损坏或截断 - 校验通过后，调用健壮的
deleteDirectory()（CHILD_FIRST 模式优先）清理源目录 - 全程使用绝对路径，避免
chdir()引起的相对路径歧义 - 每步操作前加
if (!is_readable($path)) { trigger_error("Read denied: $path", E_USER_WARNING); }
性能与边界情况提醒
大目录（>10k 文件）下，纯 PHP 递归易触发 max_execution_time 超时；深层嵌套可能耗尽栈空间。生产环境建议：
立即学习“PHP免费学习笔记（深入）”；
- 用
RecursiveIteratorIterator+RecursiveDirectoryIterator替代手写递归，更省内存 - 对超大文件跳过
md5_file()，改用filemtime()+filesize()快速校验 - 若确定源/目标在同一文件系统且有 shell 权限，用
exec('mv ' . escapeshellarg($src) . ' ' . escapeshellarg($dst))更快——但必须严格过滤路径，禁用用户输入直接拼接
realpath() 和 stat() 的 dev 字段确认是否同设备，否则复制+删除就变成唯一安全选项。 
