Workerman 5.2.3 支持纯 PHP 源码方式安装，无需 C 扩展或编译：一、确保 PHP ≥7.4 并启用 pcntl、posix（event 推荐）；二、从 GitHub Release 下载或克隆 v5.2.3 源码包并解压；三、显式引入 Autoloader.php 后即可使用，路径错误是“Class not found”的主因。
一、确认 PHP 环境已就绪（不是 Workerman 的，但必须先过）
Workerman 5.2.3 要求：
- PHP ≥ 7.4（推荐 8.0+）
- 必须启用 pcntl 和 posix 扩展（多进程基础）
- 高并发（>1000 连接）建议安装 event 扩展（非必需但强烈推荐）
验证命令：php -m | grep -E "pcntl|posix|event"。若缺任一，需先补装（Linux 下常用 yum install php-process 或源码编译，Windows 用户注意：pcntl 在 Windows 不可用，仅限开发测试）。
二、下载并解压 Workerman 5.2.3 源码包
官方不托管 tar.gz 源码发布页，但可通过以下任一方式获取纯净 PHP 源码：
-
GitHub Release 页面：访问 https://www.php.cn/link/2ce1ec32abcc09b95e64b14a9f0450c1，下载
Workerman-5.2.3.zip -
Git 克隆指定 tag：
git clone --branch v5.2.3 --depth 1 https://github.com/walkor/Workerman.git -
curl 直接拉 zip：
curl -L https://github.com/walkor/Workerman/archive/refs/tags/v5.2.3.zip -o workerman-5.2.3.zip
解压后你会看到 Workerman/ 目录，内含 Worker.php、Autoloader.php 等核心文件，无须任何编译步骤。
三、在项目中引入并运行
把解压后的 Workerman/ 目录放到你的项目合适位置（如 vendor/workerman/ 或 server/workerman/），然后在启动脚本（如 start.php）中引入：
require_once __DIR__ . '/Workerman/Autoloader.php';
use Workerman\Worker;
$worker = new Worker('websocket://0.0.0.0:2346');
$worker->count = 4;
$worker->onMessage = function($connection, $data) {
$connection->send('Hello from Workerman 5.2.3!');
};
Worker::runAll();
执行：php start.php start -d（加 -d 后台运行）。没有 composer.json、没有 make、没有 ./configure —— 就是纯 PHP 文件加载。
注意：如果你看到 “Class 'Workerman\Worker' not found”，99% 是路径写错或 Autoloader.php 没被正确 require；Workerman 5.x 已移除自动注册 autoload 的逻辑，必须显式引入 Autoloader。
