PHP中移动文件最直接的方法是使用rename()函数，它在同文件系统内原子性完成移动，跨文件系统时需改用copy()+unlink()并校验一致性。
用 rename() 移动文件最直接
PHP 没有专门叫“移动文件”的函数，rename() 就是干这事的——它本质是重命名，但跨目录时就是移动。只要源路径和目标路径在同一个文件系统里，rename() 就能原子性完成，不占额外磁盘空间，也不怕中间出错残留临时文件。
常见错误现象：Warning: rename(): No such file or directory，通常是源路径写错（比如漏了 ./ 或相对路径没对齐当前工作目录），或目标目录不存在。
- 目标目录必须已存在，
rename()不会自动创建父级目录 - 确保 PHP 进程对源文件有读权限，对目标目录有写权限
- Windows 下路径分隔符用
/或\都行，Linux/macOS 必须用/ - 如果要跨磁盘（比如从
/tmp移到/home且挂载点不同），rename()会失败，得改用copy()+unlink()
示例：
$src = '/var/www/uploads/photo.jpg';
$dst = '/var/www/archive/photo_2024.jpg';
if (rename($src, $dst)) {
echo "移动成功";
} else {
echo "移动失败：检查路径和权限";
}
跨文件系统时用 copy() + unlink()
当 rename() 返回 false，且 error_get_last()['message'] 含 Invalid cross-device link，说明跨了挂载点。这时只能先复制再删源，但要注意顺序和异常处理。
立即学习“PHP免费学习笔记（深入）”；
容易踩的坑：先 unlink() 再 copy() ——万一复制失败，文件就丢了；或者没检查 copy() 是否真成功，直接删源。
- 务必先
copy()，确认返回true，再unlink()源文件 - 复制后建议用
md5_file()校验源和目标内容一致（尤其大文件） - 目标路径的父目录需提前用
mkdir(..., 0755, true)创建好
示例片段：
if (!copy($src, $dst)) {
throw new Exception("复制失败");
}
if (md5_file($src) !== md5_file($dst)) {
unlink($dst);
throw new Exception("校验失败，目标文件损坏");
}
if (!unlink($src)) {
throw new Exception("删除源文件失败");
}
移动前必须做的三件事
别急着调函数，漏掉这些会导致静默失败或权限问题。
- 用
is_file($src)确认源存在且是文件（不是目录） - 用
is_writable(dirname($dst))检查目标目录是否可写 - 用
realpath($src)和realpath($dst)展开路径，避免符号链接或../导致误判
特别注意：is_writable() 在某些 Linux 环境下对目录可能返回 false（即使权限是 755），因为 PHP 可能以不同用户运行。此时应结合 touch() 尝试创建测试文件来实测。
批量移动时别硬写循环
一次移动几百个文件？别直接 for 循环调 rename()。性能瓶颈常不在 PHP，而在系统调用开销和磁盘 I/O。
- 用
scandir()或glob()获取文件列表后，先过滤、排序，再逐个处理 - 每移动 10–20 个文件后加
usleep(10000)，避免短时间大量系统调用拖慢服务器 - 记录失败项到数组，全部处理完再统一报错，而不是遇到第一个失败就中断
- 大文件（>10MB）建议用
stream_copy_to_stream()替代copy()，内存更可控
真正复杂的地方在于：路径合法性校验、并发写冲突、NFS 挂载下的 rename() 行为差异、以及 Windows 下文件正在被其他进程占用时的错误码处理——这些不会在简单示例里出现，但上线后大概率撞上。
