如何源码方式编译安装Workerman5.2.3-php教程-PHP中文网

workerman 5.2.3 支持纯 php 源码方式安装，无需 c 扩展或编译：一、确保 php ≥7.4 并启用 pcntl、posix（event 推荐）；二、从 github release 下载或克隆 v5.2.3 源码包并解压；三、显式引入 autoloader.php 后即可使用，路径错误是“class not found”的主因。

如何源码方式编译安装workerman5.2.3

Workerman 本身是纯 PHP 编写的框架，**不提供 C 扩展、也不需要源码编译安装**。所谓“源码方式安装 Workerman 5.2.3”，实际是指：**手动下载其 PHP 源码包（非 Composer 安装），解压后直接引入使用**——这是官方明确支持的部署方式，尤其适合离线环境、定制化部署或与 ThinkPHP/Laravel 等框架深度集成的场景。下面分三步说清怎么做，重点讲清关键动作和易错点：

一、确认 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 等核心文件，无须任何编译步骤。

FD Studio

一款AI视频创作工具，主要用于一站式AI辅助影视创意工作台，适合需要提升相关任务效率的用户。

下载

三、在项目中引入并运行

把解压后的 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。