Symfony Filesystem组件无原生原子替换方法，需先用dumpFile写临时文件，再用rename原子重命名；该操作仅在同文件系统下保证原子性，跨分区会退化为复制+删除，失去安全性。
Symfony 8.0 的 Filesystem 组件本身不提供“原子替换文件内容”的原生方法，但可通过组合标准 PHP 文件操作与组件能力实现真正原子性——核心在于避免直接写入目标文件，而是先写入临时文件，再用原子重命名（rename()）完成切换。
为什么不能直接用 file_put_contents？
直接覆盖写入存在风险：若进程被中断、磁盘满或权限异常，目标文件可能损坏或变为空。而 POSIX 系统中 rename() 对同一文件系统上的文件是原子操作，无论文件大小，要么成功切换，要么完全不变。
用 Filesystem 实现安全原子写入
Symfony Filesystem 提供了 dumpFile() 和 rename()，但需手动控制流程。推荐做法：
- 生成唯一临时文件路径，例如基于目标路径 +
.tmp-随机后缀 - 调用
$filesystem->dumpFile($tempPath, $newContent)写入内容 - 确认写入成功后，执行
$filesystem->rename($tempPath, $targetPath) - 若重命名失败（如跨分区），需手动清理临时文件并抛出异常
注意跨文件系统限制
rename() 原子性仅在源与目标位于同一挂载点时成立。若临时目录（如 /tmp）和目标目录（如 /var/www/app/config/）不在同一分区，rename() 会退化为复制+删除，失去原子性。此时应确保临时文件创建在目标目录同级（如 $targetPath . '.tmp'），或改用 fopen(..., 'c') + flock() + ftruncate() + fwrite() 手动控制。
配合权限与备份更稳妥
生产环境建议额外处理：
- 写入前备份原文件（
$filesystem->copy($targetPath, $backupPath)），失败时可回滚 - 设置目标文件权限（
$filesystem->chmod($targetPath, 0644)）在重命名后立即执行 - 对敏感配置文件，可结合
filemtime()或 checksum 校验写入完整性
