如何在Windows环境运行Workerman 5.2.3-php教程-PHP中文网

workerman 5.2.3 在 windows 下可运行但仅限开发调试，不可用于生产环境，根本原因是 windows 不支持 pcntl 扩展，导致其只能单进程、非守护模式运行，性能与稳定性严重受限。

如何在windows环境运行workerman 5.2.3

Workerman 5.2.3 在 Windows 环境下**可以运行，但仅限开发调试，不能用于生产环境**。根本原因是 Windows 不支持 pcntl 扩展（PHP 多进程控制扩展），而 Workerman 的多进程模型依赖它。没有 pcntl，Workerman 只能以单进程、非守护模式运行，性能、稳定性与容错能力大幅下降。

必须确认的前置条件

不是装上就能跑，这几项缺一不可：

PHP 版本为 7.2–8.1 区间（推荐 8.0），过高（如 8.2+）或过低（如 7.1 以下）易出现兼容警告或报错；
已禁用 PHP 的安全模式（safe_mode = Off），且未启用 open_basedir 限制关键路径；
php.ini 中已开启 posix 扩展（Windows 下可用，但 pcntl 无法启用，这点要明确区分）；
关闭所有杀毒软件实时监控，尤其对 vendor/workerman/workerman 目录的扫描，常导致文件锁死、启动失败。

启动方式：只能用 -d 参数强制单进程

直接执行 php start.php start 会报错或静默退出。正确做法是：

Windows-Android_SSH_Remote_Control

通过 SSH 隧道从 Android 设备在互联网上对 Windows PC 实现完整远程控制的设置与使用指南，适用于远程桌面访问、安全 RDP 等。

下载

进入项目根目录，运行：
php start.php start -d
-d 表示“daemonize=false + 单进程 + 控制台输出”，这是 Windows 下唯一稳定启动方式；
你会看到类似 Workerman[xxx] start in DEBUG mode 的提示，日志实时打印在终端里；
关闭窗口即停止服务——没有守护进程，也不生成 pid 文件。

常见报错及应对

遇到这些提示别慌，基本都有解：

“pcntl_fork() is not supported on this platform”：正常现象，不是错误，Workerman 已自动降级为单进程；
“Failed to bind socket: Address already in use”：端口被占用，改配置里的端口（如把 websocket://0.0.0.0:2346 换成 :2347）；
“Class 'Workerman\Worker' not found”：检查是否漏了 require_once __DIR__.'/vendor/autoload.php';，或 Composer 没成功安装；
WebSocket 连接后立即断开：大概率是 Nginx/Apache 反向代理没配好（若前端走代理），Windows 下建议前端直连 Workerman 端口测试，绕过 Web 服务器。

替代方案：更稳妥的本地开发体验

如果频繁卡在 Windows 兼容性上，推荐两条轻量路径：

WSL2（Windows Subsystem for Linux）：安装 Ubuntu 22.04，按 Linux 正常流程装 PHP + pcntl + posix + Workerman，性能和行为完全一致，且无需改代码；
Docker Desktop for Windows：用官方 PHP 镜像（如 php:8.0-cli）跑容器，挂载本地代码，docker run -p 2346:2346 -v $(pwd):/app -w /app php:8.0-cli php start.php start -d，隔离干净、复现性强。

不复杂但容易忽略：Windows 下 Workerman 就是“能跑通逻辑，别指望扛并发”。上线前务必迁移到 Linux 环境部署。