PHP写文件前必须先备份，核心是用copy()或rename()配合时间戳/哈希生成备份名，并在修改前完成；临时文件+原子重命名更安全，需检查copy返回值、控制备份数量、验证JSON/YAML格式合法性。
PHP写文件前必须先备份的可靠做法
直接覆盖原文件等于把退路删了，出错就只能靠运维救火。PHP本身没内置“原子写入+自动备份”机制，得自己搭一层保险——核心是用 copy() 或 rename() 配合时间戳/哈希生成备份名，且备份动作必须在任何修改发生前完成。
- 优先用
copy($source, $backup_path)，它失败会返回false，可立刻中止后续操作 - 备份路径建议包含日期和原始文件名，比如
$backup_path = $original . '.bak.' . date('Ymd-His') - 别用
file_put_contents($file, $content, FILE_APPEND)这类追加模式去“改文件”，它不触发备份逻辑，也容易破坏结构 - 如果原文件权限受限（如 web 服务器用户无写权限），
copy()会静默失败，务必检查返回值并记录错误
用临时文件+原子重命名实现安全覆盖
比直接写原文件更稳妥：先写到临时路径，再用 rename() 原子替换。这个过程天然适合插入备份环节——只要在 rename() 前执行一次 copy()，就能确保旧版本已存档。
- 临时文件路径用
tempnam(sys_get_temp_dir(), 'php_edit_')生成，避免冲突 - 写完临时文件后，立即
copy($original, $backup_path)，再rename($temp_file, $original) -
rename()在同分区下是原子操作，不会出现“一半新一半旧”的中间态 - 注意：跨分区
rename()实际是复制+删除，此时必须确认磁盘空间足够，否则备份和重命名都可能卡住
备份文件太多？加个自动清理逻辑
没人手动删 .bak.* 文件，很快就会占满空间。清理不能靠 cron 外部调度，得在每次备份时顺手处理，否则备份目录会失控。
- 用
glob($pattern)找出所有匹配备份文件，例如glob($original . '.bak.*') - 按修改时间排序，保留最新的 N 个：
array_slice(array_reverse($files), 0, 5) - 用
unlink()删除多余项，但别用rm -rf或递归删除，防止误删 - 清理动作放在备份成功之后、主文件写入之前，这样即使清理出错，至少旧文件还在
JSON/YAML 配置文件修改时的特殊处理
这类文件一旦格式出错（比如多逗号、少引号），直接导致整个应用挂掉。不能只备份文件，还得验证内容合法性。
立即学习“PHP免费学习笔记（深入）”；
- 读取原文件后，用
json_decode(file_get_contents($file), true)检查是否解析成功，json_last_error()不为 0 就别继续 - 修改数组后，用
json_encode($data, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT)格式化输出，方便人工核对 - 备份文件名里加上校验码，例如
$backup_path = $original . '.bak.' . substr(md5_file($original), 0, 8)，一眼看出是否真备份了 - 别依赖
file_put_contents()的LOCK_EX——它只防并发写，不防语法错误或逻辑错
