workerman 5.2.3 推荐通过 composer 安装，需 php ≥ 7.4（建议 8.0/8.1）、启用 pcntl/posix（windows 仅支持单进程调试）、composer 已安装；执行 composer require workerman/workerman:5.2.3 后，用 test-worker.php 验证，telnet 测试成功即正常。
Workerman 5.2.3 可以直接通过 Composer 安装，无需手动下载 ZIP 或 Git 克隆，这是最稳定、最推荐的本地开发方式。
确认 PHP 环境与扩展
安装前请确保本地满足以下硬性要求：
- PHP 版本 ≥ 7.4（强烈建议 8.0 或 8.1，5.2.3 对 PHP 8+ 兼容性更完善）
- 已启用 pcntl 和 posix 扩展（Linux/macOS 必需；Windows 不支持 pcntl，只能单进程调试，不可用于生产）
- Composer 已全局安装并可用（运行 composer --version 可验证）
执行 Composer 安装命令
在你的项目根目录下运行：
composer require workerman/workerman:5.2.3
注意：不要加 ^ 或 ~ 符号，明确锁定版本可避免自动升级到非预期版本。执行后会在 vendor/workerman/workerman 下生成完整源码。
验证是否安装成功
新建一个测试文件 test-worker.php：
内容示例：
require_once __DIR__.'/vendor/autoload.php';
use Workerman\Worker;
$worker = new Worker('text://0.0.0.0:1234');
$worker->onMessage = function($connection, $data) {
$connection->send('Hello Workerman 5.2.3!');
};
Worker::runAll();
终端执行：php test-worker.php start（Linux/macOS）或 php test-worker.php start -d（后台启动）
再用 telnet 127.0.0.1 1234 测试连接，能收到欢迎消息即表示安装与运行正常。
常见问题处理
若报错 Class 'Workerman\Worker' not found，检查是否漏掉 require_once vendor/autoload.php；
若提示 pcntl_fork() is disabled，需在 php.ini 中取消 disable_functions 对 pcntl_* 的限制；
Windows 用户如遇启动失败，可改用 WSL2 环境，保证多进程能力完整可用。
