rename() 是 php 中重命名文件的唯一可靠方法，具备原子性、跨文件系统支持等优势；需注意 windows 下目标存在时需先 unlink()，中文文件名须统一 utf-8 编码。
rename() 是唯一可靠的选择
PHP 中重命名文件，rename() 不是“之一”，而是事实标准——它原子性完成重命名或移动，跨文件系统也支持（只要目标目录可写），且不依赖 shell 命令或额外扩展。
常见误区是用 copy() + unlink() 模拟重命名：这在大文件或高并发下极危险，中间状态可能被其他进程读到损坏副本，或删错源文件。
-
rename()第一个参数是原路径（string），第二个是目标路径（string），返回bool - 目标路径含目录时，等效于移动+重命名；仅改文件名则保持同目录
- 若目标已存在，Linux 下会直接覆盖（Windows 默认失败，需先
unlink()）
处理 Windows 下的“目标文件已存在”错误
在 Windows 环境调用 rename() 时，如果目标文件存在，函数直接返回 false，error_get_last() 通常显示 "File exists" ——这不是 PHP bug，而是 Windows API 行为。
安全做法是显式检查并清理目标：
立即学习“PHP免费学习笔记（深入）”；
if (file_exists($newPath)) {
unlink($newPath);
}
if (!rename($oldPath, $newPath)) {
throw new RuntimeException("重命名失败: " . error_get_last()['message']);
}
注意：unlink() 对只读文件会失败，必要时先 chmod($newPath, 0644)。
中文文件名与编码陷阱
PHP 文件系统函数本身不处理字符编码，rename() 的参数按字节传递。若脚本文件保存为 UTF-8，但 Web 服务器（如 Apache）或终端环境默认是 GBK，中文名会乱码导致 rename() 找不到源文件或创建非法路径。
- 确认脚本、Web 服务器、操作系统终端三者编码一致（推荐全站 UTF-8）
- 避免直接用 $_POST 或 URL 参数拼接文件名，先
mb_convert_encoding($name, 'UTF-8', 'auto') - Linux 下文件系统（ext4）原生支持 UTF-8 路径；Windows NTFS 存储为 UTF-16，PHP 会自动转换，但旧版 PHP（
重命名后权限与所有权是否保留
rename() 不改变文件内容、权限（mode）、所有者（owner）和所属组（group）——这些元数据全部继承自原文件。这点和 Linux 命令 mv 一致。
如果你需要同步更新权限（比如新目录有不同 umask），必须手动 chmod()：
if (rename($oldPath, $newPath)) {
chmod($newPath, 0644); // 显式设定
}
注意：chown() 和 chgrp() 在大多数共享主机上被禁用，且仅对 root 或文件所有者有效，实际项目中极少使用。
真正容易被忽略的是：重命名操作本身不触发 inotify 监控事件中的 “moved_to”，而是发出 “moved_from” + “moved_to” 成对事件——做文件监听时别只捕获单边。
