Workerman 5.2.3 不支持 Composer “一键启动”或生成全局命令，必须手动编写入口文件（如 start.php）并以 php start.php start -d 启动；推荐用 composer create-project workerman/webman 获取含路由、HTTP/WebSocket 模板的完整骨架，而非仅 require workerman/workerman。
Workerman 5.2.3 不能通过 Composer “一键启动”或生成可执行命令，它始终是一个需手动编写入口文件的常驻进程基础库。所谓“快速安装”，核心是两步：正确引入代码 + 正确启动运行。下面直接说清楚怎么做。
确认环境满足硬性要求
Workerman 5.2.3（2026年主流版本）依赖 PHP 8.0+、pcntl 和 posix 扩展，且必须在 CLI 模式下运行：
- 执行 php -v 确认 PHP 版本 ≥ 8.0
- 执行 php -m | grep -E "pcntl|posix"，两个扩展必须同时存在；Windows 用户需使用 WSL2 或确保已编译安装 pcntl（PHP 8.1+ 支持）
- Linux/WSL2 环境优先；不推荐在 Windows CMD 中直接运行生产服务
用 create-project 快速获得完整骨架
这是最稳妥的“快速安装”方式，它自带 start.php、配置目录和基础结构，避免手写入口出错：
Workflow Decomposer
下载
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
- 在空目录中运行：composer create-project workerman/webman
- 注意：不是
workerman/workerman，webman是官方推荐的现代化 Web 应用骨架（基于 Workerman 5.x），含路由、中间件、HTTP/WebSocket 服务模板 - 安装完成后，项目根目录下已有
start.php，无需额外配置 autoload —— 它已自动引入vendor/autoload.php
若坚持只装核心库（workerman/workerman）
适用于自定义极强的底层网络服务（如 TCP 网关、UDP 协议解析等），但需你完全掌控启动逻辑：
- 运行：composer require workerman/workerman:^5.2.3
- 手动创建
start.php，内容必须包含：
require_once __DIR__ . '/vendor/autoload.php';
use Workerman\Worker;
$worker = new Worker('text://0.0.0.0:2345');
$worker->onMessage = function($connection, $data) { $connection->send("Hello"); };
Worker::runAll(); - 启动命令固定为：php start.php start -d（-d 表示守护进程模式）
常见卡点与绕过方法
安装过程看似成功但后续无法运行？大概率是以下原因：
-
报错 undefined function pcntl_fork() → 不是 Composer 安装失败，而是 PHP CLI 未启用 pcntl；检查 php.ini 中
extension=pcntl是否开启，并确认用的是php命令而非php-cgi -
composer require 卡住或超时 → 执行
composer config -g --unset repos.packagist清除镜像源，再重试；国内用户可临时切阿里云镜像：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ -
找不到 workerman 命令 → Workerman 从不提供全局
workerman命令，所有操作都基于你写的 PHP 文件，例如php start.php restart
