Workerman 5.2.3 在 CentOS 上安装需先确保 PHP ≥ 8.0 并启用 pcntl、posix、sockets 扩展，推荐安装 libevent 扩展提升并发性能，再通过 Composer 精确引入 workerman/workerman:5.2.3，最后编写启动脚本以 PHP CLI 方式运行。
Workerman 5.2.3 在 CentOS 上安装，核心是确保 PHP 环境满足最低要求，并补全必需扩展，再引入 Workerman 代码本身。它不是传统意义上的“软件包安装”，而是一个基于 PHP CLI 的运行时框架，所以重点在环境适配和代码部署。
确认 PHP 版本与基础扩展
Workerman 5.x 要求 PHP ≥ 8.0。先验证：
- php -v：确认版本不低于 8.0（如 8.1、8.2、8.3）
- php -m | grep -E 'pcntl|posix|sockets'：必须看到 pcntl、posix、sockets 三个扩展已启用
- 若缺失 pcntl 或 posix（常见于 yum 安装的 php-common 包不含这些），运行：
yum install php-process（CentOS 7/8）或 dnf install php-process（CentOS 8+/Stream）
安装可选但推荐的高性能扩展
libevent 或 event 扩展能显著提升高并发 I/O 性能（非强制，但生产环境强烈建议）：
CentOS Linux 7.9.2009
下载
CentOS Linux 7.9.2009是传统CentOS Linux 7的最后主要版本，也是很多企业历史服务器中仍可能遇到的系统版本。它以稳定、兼容RHEL 7生态、文档丰富和软件支持广泛著称，曾长期用于Web服务、数据库、虚拟化节点和企业内部业务系统。不过CentOS Linux 7已于2024年6月30日停止维护，现在继续使用会面临安全补丁缺失风险。该版本更适合旧业务迁移、历史环境恢复或离
- 安装依赖：yum install libevent-devel -y
- 安装 PHP 扩展：pecl install libevent（兼容 PHP 8.x）
- 启用扩展：echo "extension=libevent.so" > /etc/php.d/libevent.ini
- 验证：php -m | grep libevent 应输出 libevent
获取 Workerman 5.2.3 代码（推荐 Composer 方式）
不建议直接下载 GitHub ZIP（缺 vendor 和依赖锁定），应使用 Composer 精确安装指定版本：
- 确保已安装 Composer（≥ 2.5）：composer --version
- 在项目目录执行：composer require workerman/workerman:5.2.3
- Composer 会自动下载、解析依赖、生成 autoload，并写入 composer.lock
- 验证安装：ls vendor/workerman/workerman/src/Worker.php 存在即成功
快速验证与启动
新建一个 start.php 测试文件：
use Workerman\Worker;
require_once __DIR__ . '/vendor/autoload.php';
$worker = new Worker('text://0.0.0.0:2346');
$worker->onMessage = function($connection, $data) {
$connection->send("Hello " . $data);
};
Worker::$pidFile = __DIR__ . '/workerman.pid';
Worker::$logFile = __DIR__ . '/workerman.log';
Worker::runAll();
- 命令行运行：php start.php start -d（守护模式）
- 检查进程：ps aux | grep start.php
- 测试连接：telnet 127.0.0.1 2346，输入任意内容应收到响应
整个过程不依赖系统服务管理器，也不修改全局 PHP 配置（除扩展外），部署轻量、隔离性强。只要 PHP CLI 可用、扩展就位、代码路径正确，就能稳定运行。
