workerman 5.2.3 安装需三步:先确保php≥7.4(推荐8.0–8.2)并启用pcntl、posix扩展;再安装libevent-dev及event扩展提升并发性能;最后用composer require workerman/workerman:^5.2.3引入。

Workerman 5.2.3 是纯 PHP 实现的常驻进程框架,不依赖 Web 服务器即可运行,安装核心是确保 PHP 环境合规、扩展就位、再通过 Composer 引入。Debian 系统(如 Debian 11/12)下安装需分三步走:环境准备 → 扩展安装 → Workerman 集成。
确认并安装基础 PHP 环境
Workerman 5.2.3 要求 PHP ≥ 7.4(推荐 8.0–8.2),且必须启用 pcntl 和 posix 扩展——这是多进程模型的底层支撑,缺一不可。 - 检查当前 PHP 版本和扩展: `php -v` 和 `php -m | grep -E "pcntl|posix"` - 若未安装或版本过低:- 更新系统源并安装 PHP 8.1(Debian 12 默认支持):
`sudo apt update && sudo apt install php8.1-cli php8.1-mysql php8.1-curl php8.1-json` - pcntl 和 posix 是 PHP 核心扩展,通常随 CLI 包自动启用;若缺失,检查 php.ini 是否禁用,或重装 php8.1-cli
建议安装 event 扩展提升并发能力
虽然非强制,但 event 扩展能显著提升高连接场景下的 I/O 性能(尤其在线客服、设备通信等长连接应用)。Debian 下安装步骤如下: - 安装依赖库:`sudo apt install libevent-dev` - 用 pecl 安装扩展:
`sudo pecl install event` - 启用扩展(找到正确 php.ini 路径,可用 `php --ini` 查看):
`echo "extension=event.so" | sudo tee /etc/php/8.1/cli/conf.d/20-event.ini` - 验证:
`php -m | grep event`
通过 Composer 安装 Workerman 5.2.3
Workerman 5.2.3 已发布于 Packagist,直接指定版本号安装即可,无需手动下载 ZIP 或 Git 克隆。 - 确保已安装 Composer(如无,执行:`curl -sS https://getcomposer.org/installer | php && sudo mv composer.phar /usr/local/bin/composer`) - 在你的项目根目录执行:
`composer require workerman/workerman:^5.2.3` - 安装完成后,vendor/autoload.php 即可引入使用。最小启动示例:
<?php require_once __DIR__ . '/vendor/autoload.php';
use Workerman\Worker;
$worker = new Worker('text://0.0.0.0:2346');
$worker->onMessage = function($connection, $data) {
$connection->send('Hello ' . $data);
};
Worker::runAll();
验证与启动
运行测试脚本后,用 telnet 或 netcat 验证端口是否监听成功:`telnet 127.0.0.1 2346` → 输入任意内容,应收到响应 - 如遇 “Permission denied” 错误,检查是否以 root 运行(绑定低端口需权限)或改用 >1024 端口 - 如报 “pcntl_fork() is disabled”,检查 php.ini 中 `disable_functions` 是否禁用了 pcntl_* 函数,需移除不复杂但容易忽略。











