rename() 是 php 最稳妥的重命名方式，原子性强、跨目录一步到位，但需检查返回值、确保路径完整、目录存在、权限充足，并配合 pathinfo() 安全拼接新名、事务更新数据库。
PHP 用 rename() 替换文件名最直接
只要目标路径有写权限、源文件存在，rename() 就是 PHP 原生最稳妥的重命名方式。它原子性强，跨目录移动+改名一步到位，不会出现“文件残留”或“只移动不改名”的中间态。
常见错误是忽略返回值判断，导致失败了还不知道：
-
rename()成功返回true，失败返回false，不抛异常 - 源路径必须是完整路径（相对或绝对），不能只传文件名
- 目标路径若含不存在的目录，
rename()不会自动创建，直接失败 - windows 下对大小写不敏感，linux 下
file.txt→FILE.TXT可能被当作“同名”，返回 false
if (!rename('/var/www/uploads/photo_123.jpg', '/var/www/uploads/avatar_user456.png')) { error_log('rename failed: ' . error_get_last()['message']); }动态生成新文件名时，别硬拼字符串
用 sprintf() 或 str_replace() 拼接容易出错，尤其当原始文件名含特殊字符（如空格、中文、%）时，可能破坏路径结构或触发意外格式化。
推荐用 pathinfo() 拆解再组合，确保扩展名和目录分离处理：
立即学习“PHP免费学习笔记（深入）”；
-
pathinfo($old_path, PATHINFO_DIRNAME)提取目录 -
pathinfo($old_path, PATHINFO_EXTENSION)提取扩展名（含点） - 新文件名用
uniqid()+ 用户 ID + 时间戳等组合，避免冲突 - 最终用
realpath()或dirname(__FILE__)确保路径真实可写
$old = '/upload/用户上传 (2).jpg'; $info = pathinfo($old); $new_name = sprintf('user_%d_%s.%s', $user_id, uniqid(), $info['extension']); $new_path = $info['dirname'] . '/' . $new_name; if (!rename($old, $new_path)) { throw new RuntimeException("Failed to rename {$old} to {$new_path}"); }批量替换多个文件名要注意顺序和覆盖风险
如果循环处理一批文件并统一改名（比如 img1.jpg → pic_001.jpg），顺序不对会导致“刚重命名的文件又被当成源文件再次处理”——特别是用 glob() 获取列表后直接 foreach 的情况。
关键点：
- 先收集所有源路径到数组，再统一重命名，避免边遍历边修改文件系统状态
- 目标文件名要全局唯一，否则后一个会覆盖前一个（
rename()不提示，静默覆盖） - 若需保留原始顺序，用
array_values(array_filter(glob(...)))清理空值再索引重排 - Linux 下注意文件系统是否区分大小写；同一目录下
A.jpg和a.jpg是两个文件，但重命名时可能冲突
Web 场景下重命名后记得更新数据库记录
文件名变了，但数据库里还存着旧路径，前端访问就 404。这不是 PHP 文件操作问题，而是业务逻辑断层。
必须在 rename() 成功后立刻执行数据库更新：
- 用事务包裹：先
UPDATE file_table SET path = ? WHERE id = ?，再rename()；或反过来，但要有回滚机制 - 避免“先 rename 再 update”，万一 update 失败，文件已丢原路径，又没新记录，彻底丢失引用
- 如果用 UUID 或时间戳做新名，建议把新名也作为字段存入 DB，而不是靠拼接规则反推
- cdn 或对象存储（如 OSS）场景下，
rename()不适用，得调对应 SDK 的 copy + delete 接口
真正容易被忽略的是：开发时本地测试路径没问题，上线后 Web 服务器用户（如 www-data）可能没权限写入目标目录，rename() 静默失败，日志里只有 “Permission denied”，但没人看 error_log。