rename() 本质是原子移动操作，可跨目录重命名或覆盖文件，但需注意权限、独占锁定及系统差异；合并需自定义逻辑，安全替换应采用临时文件+原子 rename，批量重命名需生成唯一候选名。
PHP 中用 rename() 替换文件名的基本操作
直接调用 rename() 是最常用的文件重命名方式，它本质是移动（move），所以能跨目录、也能覆盖目标路径下已存在的同名文件——但默认不合并内容，而是直接覆盖。
关键点：如果目标文件已存在，rename() 会静默覆盖（Linux/macOS 下）或在 Windows 下可能失败并返回 false，取决于系统权限和 PHP 版本。
-
rename('old.txt', 'new.txt')：目标不存在时成功；存在时 Linux 默认覆盖，Windows 可能报错Permission denied - 必须确保 PHP 进程对源文件有读权限，对目标目录有写权限
- 不能用于重命名正在被其他进程独占打开的文件（如被文本编辑器锁定）
遇到重复文件名时怎么「合并」而非覆盖？
PHP 本身没有内置的“合并同名文件”函数，所谓“合并”，实际是你自己定义逻辑：比如把新内容追加到旧文件末尾、或按时间戳重命名新文件、或读取两者内容做去重合并。常见做法是先检查目标是否存在，再决定行为。
if (file_exists('data.log')) {
file_put_contents('data.log', PHP_EOL . $new_content, FILE_APPEND | LOCK_EX);
} else {
file_put_contents('data.log', $new_content);
}
上面代码实现的是「追加写入」，适用于日志类场景。若要真正去重合并两个文本文件（比如都是用户名列表），需读取、去重、写回：
立即学习“PHP免费学习笔记（深入）”；
$lines1 = file('a.txt', FILE_IGNORE_NEW_LINES);
$lines2 = file('b.txt', FILE_IGNORE_NEW_LINES);
$merged = array_unique(array_merge($lines1, $lines2));
file_put_contents('a.txt', implode(PHP_EOL, $merged) . PHP_EOL);
-
array_unique()去重基于字符串全等比较，注意换行符和空格会影响结果 - 大文件慎用
file()，会一次性加载进内存；超 1MB 建议逐行处理 - 如果原文件需保留，记得先
copy()或rename()备份
安全替换：避免意外覆盖的原子化操作
直接 rename() 覆盖风险高，尤其在并发写入时。更稳妥的方式是生成唯一临时名 → 写入 → 原子替换：
$temp = tempnam(sys_get_temp_dir(), 'upload_');
if (file_put_contents($temp, $content) !== false) {
rename($temp, $target_file); // 此步是原子的
}
这样即使写入中途失败，也不会污染原文件；且 rename() 在同一文件系统内是原子操作，不会出现“半新半旧”状态。
-
tempnam()生成的临时文件路径需与目标在同一挂载点，否则rename()会失败（PHP 会退化为 copy+unlink） - 检查
file_put_contents()返回值，它返回写入字节数，失败时为false - 不要依赖
is_writable()判断，它有时会误报；直接尝试写 + 捕获错误更可靠
批量处理时怎么自动跳过/重命名重复文件名？
上传多个文件时，常遇到用户传了多个 report.pdf。你需要给后续文件加后缀，如 report_1.pdf、report_2.pdf，而不是覆盖前一个。
function get_safe_filename($dir, $filename) {
$path = $dir . '/' . $filename;
if (!file_exists($path)) return $filename;
$info = pathinfo($filename);
$name = $info['filename'];
$ext = $info['extension'] ?? '';
$i = 1;
do {
$candidate = $name . '_' . $i . ($ext ? '.' . $ext : '');
$path = $dir . '/' . $candidate;
$i++;
} while (file_exists($path));
return $candidate;
}
$safe_name = get_safe_filename('/var/uploads', 'test.jpg');
- 该函数只生成安全文件名，不执行移动；你仍需配合
move_uploaded_file()或rename() - 注意
pathinfo()在无扩展名时返回空数组，所以用空合并（?? ''）兜底 - 高并发下仍可能冲突（两个请求同时判断不存在 → 同时写），生产环境建议加锁或用数据库唯一约束辅助
