PHP中替换文件名唯一推荐方式是rename()，它直接调用系统重命名操作，速度快且原子性强，但要求源目标路径同文件系统，并需手动检查返回值及双重验证存在性。
PHP中用 rename() 替换文件名最直接
PHP 没有专门叫“文件名替换”的函数，实际就是调用系统级的重命名操作，rename() 是唯一推荐方式。它不复制内容、不读取文件，只是改 inode 或目录项，速度快且原子性强。
注意：源路径和目标路径必须在同一个文件系统内，跨分区会失败（返回 false）；权限不足、目标已存在、父目录不可写都会导致失败。
-
rename()第二个参数是完整新路径，不只是新文件名，比如/path/to/newname.txt - 如果只想改名不改位置，建议先用
dirname($old)和basename($new)拼接，避免路径拼错 - 失败时不抛异常，必须手动检查返回值：
if (rename($old, $new) === false) { /* 处理错误 */ }
替换后怎么验证文件是否真被重命名了
不能只靠 rename() 返回 true 就认为成功——它只表示系统调用成功，但可能因缓存、NFS 延迟或 race condition 导致后续读取仍看到旧名。真正可靠的验证是「双重检查」：
- 先用
file_exists($old)确认原文件已不存在 - 再用
file_exists($new)确认新路径可访问 - 进一步校验可用
is_file($new)+filesize($new)确保它是个正常文件且大小合理（比如不为 0）
特别注意：Windows 下 NTFS 有短文件名缓存，极少数情况 file_exists() 可能短暂返回旧结果，加 clearstatcache(true, $old); clearstatcache(true, $new); 更稳妥。
立即学习“PHP免费学习笔记（深入）”；
批量替换文件名时容易踩的坑
比如把 img_001.jpg 改成 photo_001.jpg，用 str_replace() 或 preg_replace() 处理文件名字符串本身没问题，但路径处理极易出错：
foreach ($files as $old_path) {
$dir = dirname($old_path);
$base = basename($old_path);
$new_base = preg_replace('/^img_(\d+\.jpg)$/', 'photo_$1', $base);
$new_path = $dir . '/' . $new_base; // ❌ 错误：没处理 Windows 路径分隔符
// ✅ 应该用：$new_path = $dir . DIRECTORY_SEPARATOR . $new_base;
}- 硬编码
'/'在 Windows 上会生成非法路径，必须用DIRECTORY_SEPARATOR - 批量操作前建议先
is_writable($dir)检查目标目录权限，否则中途失败难回滚 - 若涉及大量文件，
rename()连续调用没问题，但别在循环里反复scandir()，避免目录状态变化干扰
验证结果时为什么 md5_file() 不是必需项
单纯重命名不需要校验内容一致性——rename() 不动文件数据，所以 md5_file($old) 和 md5_file($new) 理论上一定相同。但实际中极少需要这一步，因为：
- 验证耗时（尤其大文件），拖慢流程
- 如果
rename()成功且两次file_exists()都通过，内容完整性已由文件系统保证 - 真正要防的是「重命名失败但代码误判成功」，所以重点应放在错误捕获和路径存在性检查上
只有当你怀疑存储层异常（如损坏的 NFS 挂载、只读文件系统假成功）时，才考虑加 md5_file() 对照，但那是运维层面问题，不属于常规 PHP 文件操作逻辑。
