Workerman 5.x 要求 PHP ≥ 8.1，低于则硬性终止启动；需确认 CLI 环境 php -v 版本，安装 php8.1-cli 及 pcntl/posix/sockets 扩展，并执行 composer update 或重装 vendor。
Workerman主动推送信息时，若使用5.x版本，PHP最低必须为8.1，低于该版本会直接终止启动，无法完成消息推送功能。
不同Workerman版本对应的PHP最低要求
Workerman 4.x 系列（如4.1.15）支持 PHP ≥ 5.3.3，实际项目中常见于 PHP 7.3.4 环境，可正常运行 WebSocket 服务并实现服务端主动推送；
Workerman 5.x 系列（2024年起逐步成为主流）强制要求 【PHP ≥ 8.1】，不满足则报错“PHP version too low”并中断启动流程，连 composer install 都可能失败；
PHP 版本检查必须针对 CLI 环境执行，即运行 php -v 命令的输出结果，而非 Web 服务器（如 Apache/Nginx）所用的 PHP 版本——两者可能完全不同。
确认当前CLI PHP版本的方法
在终端执行：php -v，观察输出首行的版本号；
若显示 8.0.30 或 7.4.33 等低于 8.1 的版本，说明不满足 Workerman 5.x 运行前提；
执行 which php 查看实际调用路径，避免因系统存在多个 PHP 安装导致误判；
部分 Linux 发行版（如 Ubuntu 22.04）默认 CLI PHP 仍为 8.1 以下，需手动切换或升级，否则即使 Web 页面能访问，命令行启动 Workerman 也会立即退出。
升级PHP CLI到8.1以上的关键步骤
第一步：确认系统包管理器类型（Ubuntu/Debian 用 apt，CentOS/RHEL 用 yum 或 dnf）；
第二步：添加官方 PHP 仓库（如 ondrej/php for Ubuntu，或 Remi’s RPM for CentOS），否则系统源中无 PHP 8.1+；
第三步：安装 php8.1-cli 及必需扩展：sudo apt install php8.1-cli php8.1-pcntl php8.1-posix php8.1-sockets（Ubuntu）；
第四步：切换默认 CLI 版本：sudo update-alternatives --config php，选择 php8.1 对应条目；
第五步：验证生效：php -v 必须显示 8.1.x 或更高，且 php -m | grep pcntl 有输出——【缺少 pcntl 扩展将导致 Workerman 启动失败】；
第六步：进入项目目录，执行 composer update workerman/workerman 或重装 vendor，确保依赖与新版 PHP 兼容。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
