Swoole项目如何部署到生产环境

部署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服务。

Codiga

可自定义的静态代码分析检测工具

下载

• 在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的日志输出到文件，并使用logrotate定期归档。
• 集成Prometheus + Grafana监控QPS、内存占用、协程数等指标。
• 关键异常通过邮件或企业微信告警通知。