部署swoole生产环境需确保进程稳定、代理通畅、更新不中断、问题可追踪。使用supervisor守护进程，配置nginx反向代理并支持websocket头信息，通过kill -usr1实现平滑重启，结合inotify或ci/cd自动化发布，输出日志至文件并用logrotate归档，集成prometheus+grafana监控qps、内存、协程等指标，关键异常告警通知，避免全局变量堆积导致内存泄漏，保障服务长期稳定运行。
将Swoole项目部署到生产环境，关键在于稳定性、性能优化和安全防护。Swoole运行在常驻内存模式下，与传统的PHP-FPM有本质区别，因此部署方式也需调整。以下是实际操作中的核心要点。
使用进程管理工具守护服务
Swoole应用一旦启动就是长期运行的进程，必须确保进程崩溃后能自动重启，避免服务中断。
- 推荐使用 Supervisor 管理Swoole进程，它可以监控主进程状态并在异常退出时自动拉起。
- 配置示例：在 /etc/supervisor/conf.d/swoole.conf 中添加：
[program:swoole-server] command=php /www/wwwroot/your-project/bin/start.php autostart=true autorestart=true user=www-data redirect_stderr=true stdout_logfile=/var/log/swoole.log
保存后执行 supervisorctl reload 加载配置。
配置反向代理接入Nginx
Swoole默认监听内网端口（如127.0.0.1:9501），应通过Nginx反向代理对外提供HTTP服务。
- 在Nginx中设置proxy_pass指向Swoole服务：
server {
listen 80;
server_name api.yourdomain.com;
location / {
proxy_http_version 1.1;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
proxy_pass http://127.0.0.1:9501;
}
}
注意：如果使用WebSocket，需正确处理Upgrade头信息。
代码热更新与平滑重启
生产环境不能直接停机更新代码，需支持平滑重启。
- 利用Swoole的信号机制，在代码变更后发送 kill -USR1 {master_pid} 触发worker进程逐个重启。
- 结合文件监听工具（如inotify）或CI/CD脚本，在发布新版本时自动执行reload命令。
- 确保业务逻辑中无全局变量堆积，防止内存泄漏。
日志与监控不可少
常驻内存程序出问题难以排查，完善的日志和监控体系至关重要。
基本上就这些。部署Swoole不是简单替换FPM，而是要重新理解服务生命周期管理。只要进程稳、代理通、更新不中断、问题可追踪，就能在生产环境稳定运行。
