PHP实现零停机时间的文件缓存更新：原子性替换策略

// 例如: /path/to/cache_root/temp_cache_60b7e3e7f3b6c
$tempCacheDir = $baseCachePath . DIRECTORY_SEPARATOR . 'temp_cache_' . uniqid();
if (!mkdir($tempCacheDir, 0755, true)) {
    throw new Exception("无法创建临时缓存目录: " . $tempCacheDir);
}

// 这是一个回调函数，负责将缓存文件写入指定的目录
$cacheGenerator($tempCacheDir);

// 例如: /path/to/cache_root/new_cache_symlink_60b7e3e7f3b6c
$newSymlinkTempPath = $baseCachePath . DIRECTORY_SEPARATOR . 'new_cache_symlink_' . uniqid();
if (!symlink($tempCacheDir, $newSymlinkTempPath)) {
    throw new Exception("无法创建新的临时符号链接: " . $newSymlinkTempPath);
}

// 原子性地替换旧的符号链接
if (!rename($newSymlinkTempPath, $activeCacheSymlink)) {
    // 如果 rename 失败，需要清理新创建的临时符号链接
    unlink($newSymlinkTempPath);
    throw new Exception("无法原子性切换缓存符号链接。");
}

// 获取旧的实际缓存目录路径，用于后续清理
$oldCacheDir = '';
if (is_link($activeCacheSymlink)) { // 在 rename 之前获取
    $oldCacheDir = readlink($activeCacheSymlink);
}
// ... (执行原子性切换) ...
// 清理旧缓存
if (!empty($oldCacheDir) && file_exists($oldCacheDir) && is_dir($oldCacheDir)) {
    // 确保 deleteDirectory 函数能够递归删除非空目录
    deleteDirectory($oldCacheDir);
}

<?php

/**
 * 递归删除目录及其内容
 * @param string $dir 要删除的目录路径
 * @return bool 成功返回 true，失败返回 false
 */
function deleteDirectory($dir) {
    if (!file_exists($dir)) {
        return true;
    }
    if (!is_dir($dir)) {
        return unlink($dir);
    }
    foreach (scandir($dir) as $item) {
        if ($item == '.' || $item == '..') {
            continue;
        }
        if (!deleteDirectory($dir . DIRECTORY_SEPARATOR . $item)) {
            return false;
        }
    }
    return rmdir($dir);
}

/**
 * 原子性地更新文件缓存
 *
 * @param string $baseCachePath 缓存文件存放的基础目录，例如: /var/www/app/cache
 * @param callable $cacheGenerator 一个回调函数，接受一个参数($targetDir)，
 *                                  负责将所有缓存文件生成到该 $targetDir 目录中。
 * @throws Exception 如果更新过程中发生任何错误
 */
function updateCacheAtomically($baseCachePath, callable $cacheGenerator) {
    // 确保基础目录存在
    if (!is_dir($baseCachePath)) {
        if (!mkdir($baseCachePath, 0755, true)) {
            throw new Exception("无法创建缓存基础目录: " . $baseCachePath);
        }
    }

    // 定义当前活跃的缓存符号链接路径
    $activeCacheSymlink = $baseCachePath . DIRECTORY_SEPARATOR . 'current_cache';
    $oldCacheDir = '';

    // 如果活跃符号链接存在，获取它当前指向的实际缓存目录，用于后续清理
    if (is_link($activeCacheSymlink)) {
        $oldCacheDir = readlink($activeCacheSymlink);
    }

    // 1. 创建一个唯一的临时缓存目录
    $tempCacheDir = $baseCachePath . DIRECTORY_SEPARATOR . 'temp_cache_' . uniqid();
    if (!mkdir($tempCacheDir, 0755, true)) {
        throw new Exception("无法创建临时缓存目录: " . $tempCacheDir);
    }

    // 用于错误处理，确保临时文件被清理
    $newSymlinkTempPath = '';

    try {
        // 2. 在临时目录中生成所有新的缓存文件
        echo "正在生成新缓存文件到临时目录: " . $tempCacheDir . PHP_EOL;
        $cacheGenerator($tempCacheDir);

        // 3. (可选) 验证缓存完整性
        // 可以在这里添加逻辑，检查 $tempCacheDir 中是否包含所有预期的文件
        // 例如: if (!file_exists($tempCacheDir . '/data.json')) { throw new Exception("缓存文件缺失"); }

        // 4. 原子性切换：
        //    a. 创建一个指向新缓存目录的临时符号链接
        $newSymlinkTempPath = $baseCachePath . DIRECTORY_SEPARATOR . 'new_cache_symlink_' . uniqid();
        if (!symlink($tempCacheDir, $newSymlinkTempPath)) {
            throw new Exception("无法创建新的临时符号链接: " . $newSymlinkTempPath);
        }

        //    b. 原子性地替换旧的符号链接为新的符号链接
        //       rename() 在这里会替换目标文件/目录，如果是符号链接，则替换符号链接本身
        if (!rename($newSymlinkTempPath, $activeCacheSymlink)) {
            // 如果 rename 失败，需要清理新创建的临时符号链接
            unlink($newSymlinkTempPath); // 尝试清理
            throw new Exception("无法原子性切换缓存符号链接。");
        }

        // 5. 清理旧的缓存目录 (如果存在且不再被使用)
        if (!empty($oldCacheDir) && file_exists($oldCacheDir) && is_dir($oldCacheDir)) {
            echo "正在清理旧