Workerman生产环境部署必须确保服务稳定、高可用且能承受真实流量压力，需校验PHP≥7.4、启用pcntl/posix扩展、ulimit≥65535，禁用display_errors，用systemd/supervisord管理进程，Worker count按CPU倍数配置，禁用dev依赖，绑定内网IP监听，Nginx反代WSS，状态存Redis并用Pub/Sub跨节点广播，Docker推荐Alpine或Debian镜像，日志重定向至文件并接入ELK/Prometheus监控。
Workerman生产环境部署必须确保服务稳定、高可用且能承受真实流量压力，不能只靠开发机上跑通就认为ready。
基础运行环境校验
确认PHP版本不低于7.4（推荐8.1+），并强制启用pcntl和posix扩展：php -m | grep -E '^(pcntl|posix)$'。缺失任一扩展会导致Worker无法fork子进程或信号处理失效，【服务启动后立即退出或无法reload】。
检查系统ulimit -n输出值，必须≥65535。Linux默认常为1024，低值会触发“Too many open files”错误，连接数卡在几百就断连。
禁用PHP的display_errors和error_reporting(E_ALL)，改用error_log写入日志文件。线上开启错误显示等于主动暴露路径和变量名。
进程与守护模式配置
使用start -d参数后台启动，但必须配合systemd或supervisord管理进程生命周期。单纯php start.php start -d在终端关闭后可能被kill掉，【Windows下-d参数完全无效，只能前台运行】。
为每个Worker实例设置独立count值：Gateway建议设为CPU核心数×2，BusinessWorker可设为CPU核心数×4，避免单节点过载拖垮整个集群。
禁止在生产环境使用dev依赖：composer install --no-dev --optimize-autoloader。vendor/autoload.php加载速度提升30%以上，且排除测试类误执行风险。
网络与安全加固
绑定监听地址必须显式指定内网IP或127.0.0.1，严禁使用0.0.0.0暴露到公网。例如new Worker('websocket://10.0.1.5:2346')，而非'websocket://0.0.0.0:2346'。
防火墙只开放业务端口（如2345/2346）和SSH端口，其他全部拒绝。UFW示例：sudo ufw allow 2346 && sudo ufw enable。
WebSocket连接必须启用SSL：用nginx反向代理wss请求，后端仍走ws协议。Workerman原生不支持TLS直连，硬编码证书会导致热更新困难且私钥泄漏风险高。
状态存储与跨节点通信
用户在线状态、房间成员列表、消息未读数等数据必须存入Redis，不能放在PHP进程内存里。否则多机部署时状态割裂，A服务器用户发的消息B服务器收不到。
跨节点广播采用Redis Pub/Sub机制：BusinessWorker发布消息到channel，所有Gateway订阅该channel并转发给本地连接的客户端。避免自建TCP心跳同步带来的延迟和丢包。
Redis连接必须配置超时和重试：['scheme' => 'tcp', 'host' => '10.0.1.10', 'port' => 6379, 'timeout' => 0.5, 'read_timeout' => 1.0, 'retry_interval' => 0.1]。网络抖动时短超时能快速失败降级，防止阻塞整个事件循环。
Docker容器化部署要点
方法一：Alpine镜像精简部署
FROM php:8.1-cli-alpine → RUN apk add --no-cache pcntl posix redis → COPY . /app → CMD ["php", "start.php"]。镜像体积控制在80MB内，启动速度快，适合K8s滚动更新。
方法二：Debian基础镜像稳态部署
FROM php:8.1-cli → RUN docker-php-ext-install pcntl posix opcache → COPY --from=composer:latest /usr/bin/composer /usr/bin/composer → RUN composer install --no-dev。兼容性更强，适合遗留扩展依赖场景。
【Dockerfile中绝对禁止写WORKDIR C:\app或混合使用\和/作路径分隔符】。Linux容器不识别Windows路径，构建直接失败。
日志与监控接入
第一步：将Worker::log()输出重定向到文件而非stdout，避免docker logs淹没关键信息：
ini_set('error_log', '/var/log/workerman/error.log');
Worker::$logFile = '/var/log/workerman/stdout.log';
第二步：用tail -F实时采集日志文件，通过filebeat发送至ELK或Loki。不要依赖docker logs命令——容器重启后日志丢失，且无法按level过滤。
第三步：暴露Prometheus指标端点。在BusinessWorker中埋点记录在线连接数、消息吞吐量、Redis响应延迟，用curl http://localhost:2345/metrics验证是否可采集。
