必须。rename() 静默覆盖目标文件，但因目录不可写、源不可读或文件被占用等失败时不抛异常；安全替换需三步检查：源文件存在可读、目标目录存在可写、目标文件是否存在以决定备份或中止。

PHP 中用 rename() 替换文件前必须先判断存在吗？

必须。直接调用 rename() 覆盖目标路径，若目标文件已存在，它会静默覆盖；但若目标目录不存在、权限不足或源文件不存在，rename() 会失败并返回 false，不抛异常。所以「判断存在」不是为了防止覆盖，而是为了明确控制逻辑分支——比如你想保留旧文件、提示用户、或跳过操作。

安全替换的典型逻辑流程

真正需要的是三步检查：源文件是否存在且可读、目标路径所在目录是否存在且可写、目标文件是否已存在（决定是否备份/确认）。

linux-performance-analyzer

Linux 性能分析与调优专家，覆盖 CPU、内存、磁盘 I/O、网络、内核参数、编译优化、容器/K8s。适用场景：系统卡顿/高负载、内存不足/OOM/Swap 高、CPU 异常/iowait 高。

下载

• file_exists($source) + is_readable($source) 确保能读取原文件
• is_dir(dirname($target)) + is_writable(dirname($target)) 避免因目录不可写导致失败
• file_exists($target) 判断是否要处理冲突：重命名旧文件（如加 .bak）、删除、或中止

完整可执行的替换示例（带冲突处理）

$source = '/path/to/old.txt';
$target = '/path/to/new.txt';

if (!file_exists($source) || !is_readable($source)) {
    throw new Exception("源文件不存在或不可读: {$source}");
}

$targetDir = dirname($target);
if (!is_dir($targetDir) || !is_writable($targetDir)) {
    throw new Exception("目标目录不可写: {$targetDir}");
}

if (file_exists($target)) {
    $backup = $target . '.bak';
    if (file_exists($backup)) {
        unlink($backup); // 清理旧备份
    }
    if (!rename($target, $backup)) {
        throw new Exception("无法备份已有目标文件: {$target}");
    }
}

if (!rename($source, $target)) {
    throw new Exception("文件替换失败，请检查权限或磁盘空间");
}

为什么不用 copy() + unlink()？

看似等价，但有关键区别：

• rename() 是原子操作（同一文件系统下），不会出现“复制一半失败留下残缺文件”的情况
• copy() + unlink() 涉及两次 I/O，中间若出错（如磁盘满），可能造成源文件被删、目标未写全
• 跨文件系统时 rename() 会退化为 copy+unlink，但 PHP 不暴露该细节，所以仍应优先用 rename() 并捕获失败
• 注意：rename() 在 Windows 上对正在打开的文件会失败（Linux 可能成功），这点常被忽略

实际替换时最易漏掉的是目标目录写权限检查和 Windows 下文件占用场景——这两个问题一旦发生，错误信息往往只显示 “failed to rename”，不指明根因。