Webman部署到生产环境流程_PHP Webman使用Nginx反向代理配置【部署】-php教程-PHP中文网

webman生产环境必须关闭debug模式并启用pcntl/posix扩展，nginx需透传真实ip及协议头，静态资源应由nginx直接处理，启动后须验证进程、端口与日志三者状态。

webman部署到生产环境流程_php webman使用nginx反向代理配置【部署】

Webman 启动前必须关掉 `debug` 模式

不关 debug 会导致日志爆炸、敏感信息泄露、性能下降，甚至被扫描出路由结构。生产环境只要看到 'debug' => true 就不能上线。

修改 config/app.php 中这一行：

'debug' => false,

同时确认 PHP 版本 ≥ 8.0，且 pcntl 和 posix 扩展已启用 —— 缺一不可，否则 php start.php start -d 会直接报错退出，不是卡住，是根本起不来。

检查扩展：运行 php -m | grep -E "pcntl|posix"，必须有输出
若用宝塔，PHP 设置页的「禁用函数」里要删掉 pcntl_fork、posix_kill 等
Docker 环境下需在 Dockerfile 或 docker-compose.yml 中显式启用，不能依赖基础镜像默认值

Nginx 反向代理配置必须传透真实客户端 IP

默认只写 proxy_pass http://127.0.0.1:8787，Webman 拿到的 $request->ip() 全是 127.0.0.1，日志、限流、风控全失效。

关键头部缺一不可，尤其是 X-Real-IP 和 X-Forwarded-For：

location / {
    proxy_pass http://127.0.0.1:8787;
    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 X-Forwarded-Proto $scheme;
}

如果后端还做 HTTPS 跳转或协议判断，X-Forwarded-Proto 必须传；否则 url() 生成的链接可能是 http://，即使你配了 SSL。

WebSocket 场景额外加两行：proxy_http_version 1.1 和 proxy_set_header Upgrade $http_upgrade
proxy_buffering off 建议加上，避免 Nginx 缓存响应体导致长连接延迟
超时时间别偷懒用默认值，至少设为 60s：proxy_read_timeout 60

`php start.php start -d` 启动后必须验证进程存活

执行完命令不等于服务就跑起来了。常见假成功：进程秒退、端口没监听、log 写满磁盘、runtime 目录权限不对。

Nginx Hosting

通过服务器本地nginx实例实现零认证静态游戏托管。作为所有浏览器游戏的主要部署方式，无需登录、无需令牌、无需用户操作。

下载

三步验证缺一不可：

查进程：ps aux | grep webman，确认有 php start.php start 主进程和 worker 子进程
查端口：lsof -i :8787 或 netstat -tuln | grep :8787，确保 LISTEN 状态
查日志：tail -f runtime/log/202605/xxx.log，看有没有 Workerman[xxx] start 成功提示，而不是 Warning 或 Fatal error

如果用宝塔「进程守护」，注意它底层调的是 supervisord，但 Webman 自带的 start.php 已含守护逻辑，二者混用可能冲突 —— 推荐直接用 php start.php start -d，别套一层。

静态资源别让 Webman 处理

Webman 是常驻内存的 PHP 应用，但处理图片、JS、CSS 这类静态文件效率远不如 Nginx。放任不管，CPU 会无谓升高，缓存策略也难控制。

把前端构建产物（如 dist/ 或 public/）放到 Nginx 的 root 下，用 location 规则拦截并直接返回：

location ~* \.(js|css|png|jpg|jpeg|gif|ico|svg)$ {
    expires 1y;
    add_header Cache-Control "public, immutable";
    root /www/wwwroot/your-site/public;
}

这样所有静态请求不进 PHP，Nginx 自己搞定压缩、缓存头、Gzip，Webman 只专注业务逻辑。

容易忽略的一点：Webman 默认的 index.php 入口路径，如果用了 URL 重写（比如 Laravel 风格的 /api/users），Nginx 的 try_files 规则要对齐，否则 404 不是后端抛的，是 Nginx 拦截失败导致的。