Workerman 5.2.3 安装成功需三步验证:一、确认 PHP ≥7.4 且启用 pcntl/posix 扩展;二、运行 php start.php start(或 php webman start)看到 Workerman 启动日志;三、用 netstat/lsof 或 telnet 确认端口监听并可连接。

安装完 Workerman 5.2.3 后,验证是否成功不能只看“有没有报错”,关键要确认它能正常启动、监听端口,并响应基础行为。下面分三步直接验证,不绕弯:
一、检查基础依赖是否就绪
Workerman 对 PHP 环境有硬性要求,缺一不可:
- pcntl 和 posix 扩展必须启用(Windows 用户需确认已配置 PHP 环境变量,且使用 CLI 模式);
- PHP 版本 ≥ 7.4(推荐 8.0+),运行
php -v确认; - 执行
php -m | grep -E "pcntl|posix"(Linux/macOS)或php -m(Windows)查看列表中是否存在这两个扩展。
二、启动一个最小示例并观察输出
不用写完整项目,用官方最简 WebSocket 示例快速验证:
- 进入项目根目录(比如
webman或你自己创建的目录); - 运行命令:
php start.php start -d(守护进程模式)或php start.php start(调试模式,推荐首次验证用); - 若看到类似以下输出,说明 Worker 已成功启动:
Workerman[start.php] start
----------------------- WORKERMAN -----------------------------
Workerman version:5.2.3
Event-loop:libevent / select / epoll (取决于系统)
注意:如果提示 Command 'start' is not defined,说明你用的是 Webman 框架,应改用 php webman start;若提示 Class 'Workerman\Worker' not found,则是自动加载失败,需确认 vendor/autoload.php 被正确引入。
三、确认端口监听与连接可用
Workerman 默认监听 2346(WebSocket)或 1234(TCP)等端口,验证方式如下:
- Linux/macOS:运行
netstat -tuln | grep ':2346'或lsof -i :2346,看到LISTEN状态即表示端口已打开; - Windows:运行
netstat -ano | findstr :2346,确认状态为LISTENING; - 进一步验证:用浏览器访问
ws://127.0.0.1:2346(需前端简单连接脚本),或用telnet 127.0.0.1 2346测试 TCP 连通性(能连上即代表服务进程存活)。

















