PHP rename函数间歇性失效及临时文件不存在警告问题排查求助

这问题确实够头疼的——5%的间歇性失败，连延迟重试和shell命令都不管用，大概率是系统层面的文件系统特性或者tempnam的潜在竞态在搞鬼。我之前碰到过类似的场景，咱们一步步拆解解决：

核心问题分析 #

你用tempnam()创建临时文件，看似没问题，但它的底层逻辑是“先检查文件名是否存在→再创建文件”，这中间有个极小的时间窗口，如果是多进程环境（比如PHP-FPM的多进程），或者文件系统缓存延迟，就可能出现刚创建的文件“消失”的情况。另外，PHP会缓存文件状态信息（比如filesize()的结果），这也可能导致判断和实际操作不同步。

可行解决方案 #

1. 用原子方式创建临时文件，替代tempnam #

放弃tempnam()，改用fopen的x模式（排他创建），操作系统会保证只有当文件完全不存在时才创建，彻底避免竞态窗口：

$external_file = fopen($url, 'rb');
if ($external_file) {
    // 生成唯一文件名，用uniqid保证随机性
    $tmpfile = __DIR__.'/cache/test_'.uniqid('', true);
    // x模式：原子创建文件，文件已存在则直接失败
    $newfile = fopen($tmpfile, 'xb');
    if (!$newfile) {
        // 极端情况文件名重复，重试一次
        $tmpfile = __DIR__.'/cache/test_'.uniqid('', true);
        $newfile = fopen($tmpfile, 'xb');
        if (!$newfile) {
            fclose($external_file);
            throw new \Exception('Could not create unique temp file');
        }
    }

    // 读写逻辑不变
    while (!feof($external_file)) {
        fwrite($newfile, fread($external_file, 1024 * 64), 1024 * 64);
    }

    // 关键：先刷新缓冲区，再强制同步到磁盘
    fflush($newfile);
    fsync($newfile);
    fclose($newfile);
    fclose($external_file);

    // 清理PHP的文件状态缓存，确保后续操作拿到最新状态
    clearstatcache(true, $tmpfile);
    if (filesize($tmpfile)) {
        clearstatcache(true, $tmpfile);
        if (!rename($tmpfile, $filename)) {
            error_log('manual move try');
            // 这里可以加个文件存在检查再执行shell命令
            if (file_exists($tmpfile)) {
                error_log(`mv {$tmpfile} {$filename}`);
            } else {
                error_log('Temp file vanished before manual move!');
            }
        }
    }
}

2. 简化文件读写逻辑，用copy替代手动操作 #

如果你的需求只是把外部URL的文件存到临时目录，直接用PHP内置的copy()函数，它的内部实现更可靠，减少手动处理句柄的出错点：

$tmpfile = __DIR__.'/cache/test_'.uniqid('', true);
if (!copy($url, $tmpfile)) {
    throw new \Exception('Failed to copy external file');
}

clearstatcache(true, $tmpfile);
if (filesize($tmpfile)) {
    clearstatcache(true, $tmpfile);
    if (!rename($tmpfile, $filename)) {
        error_log('manual move try');
        if (file_exists($tmpfile)) {
            error_log(`mv {$tmpfile} {$filename}`);
        }
    }
}

3. 排查是否有外部进程干扰 #

如果上面的方法还是不行，建议在出错时打印缓存目录的文件列表，确认文件是真的被删除还是PHP状态缓存的问题：

if (!file_exists($tmpfile)) {
    $cacheFiles = scandir(__DIR__.'/cache/');
    error_log('Temp file missing! Cache dir contents: '.implode(', ', $cacheFiles));
}

这能帮你排查是不是有定时任务、其他脚本误删了缓存目录的文件。

关键注意点 #

• fsync()：强制将文件数据同步到磁盘，避免文件系统写缓存延迟导致的文件状态不一致；
• clearstatcache(true, $tmpfile)：清理PHP针对该文件的状态缓存，确保filesize()和rename()拿到的是最新的文件状态；
• 原子创建：用x模式创建文件彻底避免tempnam()的竞态窗口。

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