正确快照流程是先读旧内容再写新内容，成功后存旧内容为历史版；限制版本数（如5个）、避免重复存档（md5比对）、命名含时间戳与md5、可选流包装器透明化，注意open_basedir/selinux权限及清理策略。
用 file_put_contents + file_get_contents 做基础版本快照
PHP 本身不带文件版本系统，但多数简单场景只需要保留最近几次修改内容——直接读写文件配合时间戳或序号命名就足够。关键不是“存多少版”，而是“怎么避免覆盖时丢数据”。
常见错误是先 file_put_contents($path, $new) 再去备份旧文件，万一写入失败，原文件已丢失。正确顺序是：先读旧内容 → 写新内容 → 成功后再存旧内容为历史版。
- 每次修改前用
file_get_contents($path)读取当前内容 - 新内容写入成功后，再用
file_put_contents("{$path}.v" . date('Ymd-His'), $old_content)存快照 - 建议限制快照数量，比如只保留最近 5 个：
glob("{$path}.v*")取出所有版本文件，array_slice(..., -5)留下最新的，其余unlink()
用 spl_object_hash 或 md5_file 避免重复存相同内容
用户反复点保存但内容没变，不该生成新版本——否则日志爆炸、磁盘白占。不能只比对时间戳，得比内容。
小文件用 md5_file($path) 最稳；大文件（>10MB）建议用 spl_object_hash(new SplFileObject($path)) 快速判断是否同一文件对象（仅适用于未重命名/移动的场景），但更推荐分块 hash_file('md5', $path, true) 避免内存溢出。
- 存版本前先算当前文件的
md5_file($path)，和上一个版本文件的 MD5 比对 - MD5 相同就跳过本次存档，直接返回成功
- 把 MD5 值也写进版本文件名，比如
{$path}.v{$timestamp}-{$md5_short}，方便排查
用 stream_wrapper_register 实现透明版本读写（进阶）
如果多个地方都在读写同一个配置文件，又不想到处改代码，可以注册自定义流包装器，让 fopen('versioned://config.json', 'w') 自动触发版本逻辑。
这招适合已有项目想无侵入加版本能力，但要注意：PHP 8.0+ 对 stream_wrapper_register 的异常处理更严格，必须实现全部必需方法（stream_open, stream_write, stream_read 等），漏一个就会 Warning: fopen(): Unable to find wrapper。
- 注册前先检查是否已存在：
in_array('versioned', stream_get_wrappers()) -
stream_write方法里必须调用父级逻辑写入真实文件，再额外触发备份 - 调试时用
var_dump(stream_get_wrappers())确认注册成功
注意 open_basedir 和 SELinux 导致的写入失败
本地测试好好的，上线就 file_put_contents(): failed to open stream: Permission denied——大概率不是权限数字问题，而是 PHP 被 open_basedir 锁死了路径，或者 SELinux 的 httpd_can_network_connect 关了导致无法访问 NFS 挂载的备份目录。
查法很简单：echo ini_get('open_basedir')；SELinux 下运行 ausearch -m avc -ts recent | grep httpd 看拒绝记录。
- 版本文件别和源文件放同一级目录，比如源在
/var/www/config.php，版本存到/var/www/.versions/config.php.v20240520，然后把.versions加进open_basedir - 如果用
chroot或容器，确保备份路径在容器内可写且上下文标签正确（ls -Z看，必要时chcon -R -t httpd_sys_rw_content_t /path/to/versions）
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
