升级 laravel 后重启常驻进程,核心在于确保新代码被加载且旧状态被清除。对于 queue worker,需发送 sigterm 信号触发优雅退出;horizon 依赖 supervisor 或 systemd 管理,通过 `systemctl restart` 刷新服务;octane 则需重启 swoole 或 roadrunner 进程以重新编译和加载应用代码。

Queue Worker 如何优雅重启
向运行中的 worker 进程发送 SIGTERM 信号,使其完成当前任务后退出,配合 Supervisor 的自动重启机制实现无缝切换。

php artisan queue:work --daemon # 在另一个终端执行: pkill -TERM -f "queue:work"
上述命令会终止所有由 artisan queue:work 启动的进程。若使用 Supervisor,配置文件中 autorestart=true 会自动拉起新进程。注意,--daemon 模式(默认)会在内存中保持应用实例,因此必须重启才能加载新代码。若未使用守护模式,每次任务处理都会重新引导应用,但性能较差。
Horizon 与 Octane 的重启策略
Horizon 作为监控面板,其重启依赖于底层进程管理器;Octane 需要重启主进程以重新加载应用程序容器。
Laravel Cloud(cloud.laravel.com)。此技能用于处理所有 Laravel Cloud 请求,包括搜索和读取数据。只要任务涉及 Laravel Cloud,即使用此技能。

# Horizon (假设使用 Supervisor) supervisorctl restart horizon # Octane php artisan octane:start --server=swoole # 重启时直接 Ctrl+C 停止并重新启动 php artisan octane:start --server=swoole
Horizon 本身不持有应用状态,它通过 Redis 监听队列。重启 Horizon 主要是为了更新其内部的状态缓存和监控数据。Octane 则将应用加载到内存中,任何代码变更都需要重启 Octane 进程。对于 Swoole 服务器,重启会导致短暂的服务中断,建议在低峰期进行。RoadRunner 同样需要重启进程来重新加载代码。
升级后如何验证进程已生效
检查进程 ID 是否变化,以及应用版本标识是否正确输出,确认新代码已加载。
php artisan about # 查看 Laravel 版本 ps aux | grep queue:work # 对比 PID 是否更新
执行 php artisan about 可以显示当前应用的版本信息,确保与升级后的版本一致。同时,观察 ps aux 输出的进程 ID,如果 PID 发生变化,说明进程已成功重启。对于 Octane,可以通过访问应用并检查日志,确认没有旧的错误堆栈出现。

















