PHP如何实现类似事务的批量文件操作（删除、创建）避免内容缺失？

核心思路是不要直接修改线上正在使用的文件目录，所有生成操作在临时隔离环境完成后，通过系统级原子操作实现瞬间切换，用户完全感知不到更新过程。

方案1：目录原子重命名实现（无额外依赖，兼容性最好） #

这是生产环境最常用的方案，利用Linux同分区下rename系统调用的原子性实现无感知切换：

• 先固定3个工作目录：
  • cache_new：临时生成新缓存的隔离目录，更新过程中完全不影响线上访问
  • cache_current：线上实际对外提供访问的工作目录
  • cache_old：切换后暂存旧版本缓存的目录，后续异步清理
• 调整原有生成流程如下：
  1. 清空并重建cache_new目录，将所有新的JSON缓存文件全部生成到该目录下，即使耗时5分钟也不会对线上访问产生任何影响
  2. 所有缓存生成完成后，先做完整性校验：比如检查文件数量是否在10~15区间、每个文件是否可以正常解析为JSON，确认生成完全成功再进入下一步
  3. 执行原子切换：先将旧的cache_current重命名为cache_old（如果已有cache_old先提前删除），再将已经校验通过的cache_new重命名为cache_current
  4. 异步清理cache_old下的旧文件，不需要阻塞主流程
• 示例代码片段：

// 定义三个工作目录路径
$newDir = __DIR__ . '/cache_new';
$currentDir = __DIR__ . '/cache_current';
$oldDir = __DIR__ . '/cache_old';

// 1. 初始化临时目录
if (is_dir($newDir)) {
    recursiveDelete($newDir); // 自定义递归删除目录函数
}
mkdir($newDir, 0755, true);

// 2. 生成所有缓存到临时目录（你的原有生成逻辑）
generateAllJsonCache($newDir);

// 3. 校验缓存完整性（根据业务规则自定义）
if (!checkCacheIntegrity($newDir)) {
    throw new Exception("缓存生成不完整，终止切换");
}

// 4. 执行原子切换
if (is_dir($oldDir)) {
    recursiveDelete($oldDir);
}
rename($currentDir, $oldDir);
rename($newDir, $currentDir);

// 5. 注册 shutdown 函数异步清理旧文件，不阻塞主流程
register_shutdown_function(function() use ($oldDir) {
    recursiveDelete($oldDir);
});

• 注意事项：需要保证三个目录在同一个磁盘分区下，此时PHP的rename()函数底层直接调用系统原子操作，不会出现中间状态。如果是web服务器直接托管静态缓存文件，不需要修改服务配置，切换后瞬间生效。

方案2：软链接切换实现 #

如果不方便调整现有目录结构，可通过软链接实现版本切换：

• 每次生成缓存到带唯一版本号的目录，比如cache_202405201430/
• 校验通过后，用原子操作将指向线上缓存的软链接cache_current修改为指向新的版本目录
• 后续异步删除历史版本目录即可
  修改软链接时要先生成临时软链再用rename()覆盖原有软链，避免中间状态访问异常。

高可用兜底优化 #

如果业务可用性要求极高，可在缓存读取逻辑中加一层降级规则：如果当前cache_current目录文件缺失，自动 fallback 到上一个可用的缓存版本，完全避免出现空白或内容缺失提示。

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