PHP检测文件名是否存在并自动追加递增计数后缀的实现方法

原代码核心错误点 #

• 循环内计数变量$dupe未更新：你在循环里每次都是用初始值2做+1运算，$dupe本身的值始终没有修改，要是file (2)也存在，后续永远只会生成file (3)，直接进入死循环
• 前后判断的变量不一致：外层if判断的是$receverfs是否存在，但后续生成文件名用的是$subject，大概率是变量名写错了，要统一用你需要检测的目标文件名变量
• 输出位置错误：echo放在while循环内部，会把所有中间生成的重复文件名都打印出来，应该等循环结束找到最终可用的文件名之后再输出
• 未兼容带扩展名的文件：如果是带后缀的文件比如test.txt，现有逻辑会生成test.txt (2)，如果需要生成test (2).txt需要额外拆分扩展名处理

修复后可用代码 #

基础版（和你需求逻辑一致，直接在完整文件名后追加计数后缀） #

// 替换为你实际要检测的目标文件名变量，统一用$subject即可
$targetFile = $subject;
$finalName = $targetFile;

if (file_exists($finalName)) {
    $dupe = 2; // 直接用整型，避免弱类型异常
    do {
        $finalName = "{$targetFile} ({$dupe})";
        $dupe++; // 每次循环更新计数变量
    } while (file_exists($finalName));
}

// 循环结束后统一输出最终可用文件名
echo $finalName;

兼容扩展名版（带后缀的文件会把计数放在扩展名前面，比如file.jpg生成file (2).jpg） #

$targetFile = $subject;
$finalName = $targetFile;

if (file_exists($finalName)) {
    // 拆分文件名和扩展名
    $ext = pathinfo($targetFile, PATHINFO_EXTENSION);
    $nameWithoutExt = pathinfo($targetFile, PATHINFO_FILENAME);
    $dupe = 2;
    do {
        if ($ext) {
            $finalName = "{$nameWithoutExt} ({$dupe}).{$ext}";
        } else {
            $finalName = "{$nameWithoutExt} ({$dupe})";
        }
        $dupe++;
    } while (file_exists($finalName));
}

echo $finalName;

内容的提问来源于stack exchange，提问作者Im_not_200iq