workerman 5.2.3 启动报“please install pcntl extension”是因为 php cli 缺少强制依赖的 pcntl 扩展；需通过系统包管理器安装（如 dnf install php-process 或 apt install php-process）、macos 用 brew reinstall --with-pcntl 或 pecl install、docker 用 docker-php-ext-install、源码编译则进入 ext/pcntl 目录执行 phpize 配置安装，并确保修改的是 cli 对应的 php.ini，最后用 php -m 验证 pcntl 和 posix 存在且运行官方检测脚本全通过。
Workerman 5.2.3 启动时报“Please install pcntl extension”或类似提示，说明当前 PHP CLI 环境缺少 pcntl 扩展——这是 Workerman 强制依赖的核心扩展，不可跳过。
✅ 确认是否真的缺失
在终端运行：
php -m | grep pcntl
若无输出，说明未启用；再检查是否被禁用：
php -i | grep "disable_functions"
确保 pcntl_fork, pcntl_signal, pcntl_alarm 等未出现在禁用列表中。
? Linux（CentOS/AlmaLinux/RHEL）
如果 PHP 是 yum 或 dnf 安装的（如系统自带或 Remi 源）：
sudo dnf install php-process -y # 或旧版 CentOS： sudo yum install php-process -y
该包通常同时提供 pcntl 和 posix 扩展，并自动写入 php.ini。
安装后重启命令行环境（或重载配置），再执行：
php --ini # 查看加载的 php.ini 路径 php -m | grep pcntl # 验证是否出现
? Linux（Debian/Ubuntu）
sudo apt update && sudo apt install php-cli php-dev php-pear -y sudo apt install php-process -y # 包含 pcntl + posix
部分版本需手动启用（尤其 PHP 8+）：
echo "extension=pcntl.so" | sudo tee /etc/php/*/cli/conf.d/20-pcntl.ini
注意：
*会匹配8.1、8.2等实际版本号，可用ls /etc/php/确认。
? macOS（Homebrew PHP）
Homebrew 安装的 PHP（如 php@8.2）默认不编译 pcntl，需手动启用：
# 先确认 phpize 和 php-config 路径 which phpize which php-config # 进入 PHP 源码扩展目录（若你有源码） # 若没有，可重新编译安装（推荐用 brew reinstall --with-pcntl） brew reinstall php@8.2 --with-pcntl # ✅ 此参数仅适用于较新 brew tap（如 shivammathur/php） # 或更通用方式：用 pecl（需先装 autoconf） brew install autoconf yes '' | pecl install pcntl echo "extension=pcntl.so" >> $(php --ini | grep "Loaded Configuration File" | cut -d':' -f2 | tr -d ' ')
⚠️ 注意：macOS 上 pcntl 在某些 M1/M2 + Rosetta 组合下可能不稳定，生产环境建议用 Linux 容器替代。
? Docker（常见于 Laradock / 自建镜像）
进入容器后直接使用内置工具：
docker exec -it your-php-container bash # 然后执行： docker-php-ext-install pcntl docker-php-ext-enable pcntl
Alpine 镜像需额外装构建依赖：
RUN apk add --no-cache $PHPIZE_DEPS \
&& docker-php-ext-install pcntl \
&& docker-php-ext-enable pcntl
? 源码编译 PHP（自定义安装路径）
适用场景：PHP 是自己 ./configure && make && make install 编译的。
- 进入原始 PHP 源码的
ext/pcntl/目录 - 执行：
/usr/local/php/bin/phpize ./configure --with-php-config=/usr/local/php/bin/php-config make && sudo make install
- 编辑
php.ini（用php --ini找到路径），添加：extension=pcntl.so
✅
pcntl.so的实际路径一般形如/usr/local/php/lib/php/extensions/no-debug-zts-20220829/pcntl.so，make install输出中会明确提示。
? 最后验证
无论哪种方式，完成安装后务必：
- 重启终端或重新登录 shell（避免缓存）
- 运行
php -m | grep -E "pcntl|posix"确认两者都存在 - 执行官方检测脚本：
curl -Ss http://www.workerman.net/check.php | php
应显示 ✅ 全部通过
不复杂但容易忽略。关键是确认你操作的是 CLI 版本的 PHP（不是 fpm 或 apache mod），且修改的是它真正加载的 php.ini。
