frankenphp 不支持自动执行 php artisan migrate，因其仅处理 http 请求而非部署任务；正确做法是在软链接切换版本前后手动运行迁移命令并清理缓存。
FrankenPHP 本身不提供发布钩子或部署生命周期管理，php artisan migrate 必须由你手动触发，且不能在 FrankenPHP 进程内“自动执行”——它和 Nginx+PHP-FPM 环境一样，只是运行时，不是部署工具。
为什么不能在 Caddyfile 或 FrankenPHP 启动时自动跑 migrate
FrankenPHP 的职责是接收 HTTP 请求并执行 PHP 脚本（如 public/index.php），它不监听部署事件、不读取 Git 钩子、也不执行 CLI 命令。所谓“发布时迁移”，本质是运维动作，必须在服务重启前、代码切换后、缓存清理前完成。
-
frankenphp进程启动后不会主动调用php artisan；它甚至不知道 Laravel 存在 - Caddyfile 中的
php_server只处理 HTTP 请求，不支持执行任意 shell 命令 - 若强行在
public/index.php开头加exec('php artisan migrate')，会严重拖慢首请求、并发下重复执行、且失败时直接 500
推荐做法：在软链接切换前后执行 migrate
这与 FrankenPHP 的回滚机制强绑定——你本就该用软链接切换版本（如 /var/www/current → /var/www/myapp-v1.3.0），迁移就该卡在这个时间点。
- 上线新版本前：
cd /var/www/myapp-v1.3.0 && php artisan migrate --force - 确认成功后，再切软链接：
ln -sf /var/www/myapp-v1.3.0 /var/www/current - 回滚时同理：先
cd /var/www/myapp-v1.2.3 && php artisan migrate:rollback --force --step=1，再切回旧链接 - 务必加
--force：FrankenPHP 环境默认不交互，没这个参数会卡住等待 stdin
注意 Laravel 迁移在 FrankenPHP 下的两个硬限制
迁移命令本身能跑，但它的行为边界和 PHP-FPM 完全一致，别指望 FrankenPHP “更智能”：
-
migrate:rollback不会还原DROP COLUMN或RENAME TABLE——这些是破坏性操作，框架不保存旧结构快照 - 如果迁移里写了
DB::table(...)->update(...)这类数据变更，回滚时down()方法必须显式写反向逻辑，否则数据丢失 - 建议每次发布前执行
php artisan migrate:status，把输出中的最新 migration 时间戳记入发布日志，方便精准回退到某一步
真正容易被忽略的是：迁移成功 ≠ 服务可用。你得确保 OPcache 已清、Redis 缓存已刷、Worker 进程（如果开了）已重启——否则新代码里的模型变更可能被旧字节码或旧配置缓存覆盖，报出 Class not found 或路由错乱。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
