workerman官方未发布v5.2.3版本，截至2026年10月最新稳定版为v4.1.7；所谓“v5”多为混淆webman框架版本、非官方分支或误传，正确安装应使用composer require workerman/workerman:^4.1或create-project workerman/webman。
直接运行 composer require workerman/workerman:5.2.3 通常无法成功，因为 Workerman 官方 **未发布 v5.2.3 版本** —— 截至 2026 年 10 月，Workerman 最新稳定版是 v4.1.7（v4 系列长期维护），而所谓“v5”目前仅存在于非官方分支、误传或混淆（例如把 Webman 框架版本当成 Workerman 版本）。
为什么找不到 v5.2.3？
Workerman 项目在 Packagist 和 GitHub 官方仓库中从未发布过任何 5.x 版本。其版本演进路径为：v3.x → v4.x（当前主力）。所有标称“v5”的安装尝试，实际会触发 Composer 报错：Could not find package workerman/workerman in a version matching "5.2.3" 或回退到最近兼容版本（如 v4.x），甚至静默失败。
正确安装当前可用的 Workerman
请使用以下任一可靠方式，确保获取官方支持的稳定版（v4.x）：
Workflow Decomposer
下载
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
-
推荐方式（完整骨架 + 开箱即用）：运行
composer create-project workerman/webman—— 这是官方主推的现代启动方式，内置 Webman 框架（基于 Workerman v4），含路由、HTTP 服务、命令行工具等，适合绝大多数 Web/长连接场景 -
纯 Workerman 核心（轻量集成）：在已有项目中执行
composer require workerman/workerman:^4.1，明确锁定 v4 主线，避免意外升级到未发布的测试分支 -
验证安装结果：执行
composer show workerman/workerman，输出应类似versions : * v4.1.7，而非 5.x
特别注意 Windows 用户
若你在 Windows 上执行上述命令后仍报错（如卡住、pcntl 扩展缺失、autoload.php 找不到）：
- 确认使用的是 Git Bash 或 PowerShell，而非 CMD；CMD 对信号和进程控制支持极差
- 检查 PHP CLI 模式是否启用
pcntl和posix：运行php -m | findstr "pcntl posix"（Windows PowerShell） - PHP 8.1+ 在 Windows 上需通过
pecl install pcntl手动编译安装（官方不提供 DLL），否则即使 Composer 安装成功，php start.php start -d也会报undefined function pcntl_fork()
别被“v5”误导的常见情况
以下情形常被误认为 “Workerman v5”：
- 将 Webman 框架版本（如 webman/console v5.2.3） 当作 Workerman 内核版本 —— Webman 是上层框架，底层仍依赖 workerman/workerman v4.x
- 看到第三方 fork 仓库或私人包（如
xxx/workerman5）—— 非官方、无维护、不兼容、存在安全风险 - 文档或视频教程口误/过时 —— 请以 workerman.net 和 Packagist 页面为准
