回滚必须用软链接切换而非覆盖文件，因frankenphp是单进程嵌入式模型，硬覆盖后opcache不自动失效、worker进程仍执行旧字节码，易触发fatal error；需同步清空opcache、redis缓存并stop-workers确保逻辑一致。
回滚必须用软链接切换，不能直接覆盖文件，否则旧字节码仍驻留 OPcache、Worker 进程继续执行旧逻辑，极大概率触发 Fatal error: Class 'X' not found 或 Cannot redeclare function。
为什么不能用 git checkout 或 rsync 覆盖回滚
FrankenPHP 是单进程嵌入式模型，没有 PHP-FPM 那样的多进程热加载机制。硬覆盖后：
-
OPcache不会自动失效，opcache_get_status()['scripts']里仍显示旧路径的已编译脚本 - 正在运行的
worker进程不会感知文件变化，继续加载旧版本public/index.php - 如果
php_worker指向的是相对路径或未随代码更新，新 worker 启动失败却无明显报错
正确回滚操作：三步完成，毫秒级生效
前提是部署时已按版本隔离目录（如 /var/www/myapp-v1.2.3、/var/www/myapp-v1.3.0），且 Caddyfile 中使用软链接路径：
- 执行
ln -sf /var/www/myapp-v1.2.3 /var/www/current - 清空 OPcache：
frankenphp php-cli -r "opcache_reset();" - 清空 Laravel 缓存：
php artisan config:clear && php artisan route:clear && php artisan view:clear（若用了config:cache，需再执行php artisan config:cache）
数据库迁移必须同步回滚，不能只退代码
Laravel 的 migrate:rollback 只执行 down() 方法，但无法恢复已执行的破坏性操作：
- 新增字段 →
migrate:rollback安全可用 -
DROP COLUMN或DROP TABLE→ 必须提前备份表结构与数据，靠mysqldump还原 - 填充类变更（如
DB::table('settings')->insert()）→down()必须手写删除逻辑，否则残留数据会干扰旧版业务
Redis 和 Worker 进程也得一起“退”
FrankenPHP 不会自动刷新缓存或重启 worker，这些必须手动干预：
- 删 Redis 中的配置缓存键：
redis-cli DEL "laravel:cache:config" "laravel:cache:routes"（键名依实际缓存前缀而定） - 执行
frankenphp stop-workers—— 它向所有活跃 worker 发送优雅退出信号，新请求由新 worker（加载旧代码）处理 - 确认 worker 已切换：查
ps aux | grep index.php，看进程启动路径是否指向/var/www/current/public/index.php
最容易被忽略的是：回滚后不执行 frankenphp stop-workers，旧 worker 仍在跑新代码逻辑；或者忘了清 Redis 缓存，导致路由/配置仍走新版本定义。这两项不做，等于没回滚。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
