pcntl扩展必须在PHP编译时通过--enable-pcntl显式启用，仅限Linux/macOS，Windows不支持；phpenv仅管理版本，不控制扩展开关，需用PHP_BUILD_CONFIGURE_OPTS指定参数重新编译。
phpenv 本身不控制扩展开关，pcntl 必须在编译 PHP 时启用
phpenv 是个版本管理工具，它不负责开启或关闭扩展，只负责切换已编译好的 PHP 二进制。pcntl 是 PHP 源码内置的 SAPI 级扩展，--enable-pcntl 必须在 ./configure 阶段显式传入，否则生成的 php 二进制里压根没有这个功能。
你用 phpenv install 8.3.13 装出来的默认版本，几乎肯定不含 pcntl —— 因为 php-build（phpenv 默认使用的构建插件）默认不加这个 flag。
- 检查是否已启用：
php -m | grep pcntl，无输出即未启用 - 确认编译参数：
php-config --configure-options | grep pcntl，没结果或出现--disable-pcntl就得重编 - 不要指望
pecl install pcntl：会报ERROR: could not find package.xml，这条路根本走不通
用 phpenv + php-build 编译带 pcntl 的 PHP
核心是让 php-build 在 configure 时带上 --enable-pcntl，同时保留其他必要选项（比如 --enable-fpm、--with-openssl 等），否则可能丢掉常用功能。
- 先设环境变量（推荐方式）：
export PHP_BUILD_CONFIGURE_OPTS="--enable-pcntl --enable-fpm --with-openssl" - 再执行安装：
phpenv install 8.3.13（或你指定的版本） - 装完切到该版本：
phpenv global 8.3.13 - 验证：
php -r "echo pcntl_fork() ?: 'in child';"—— 若返回数字（PID）或输出in child，说明可用
注意：PHP_BUILD_CONFIGURE_OPTS 会覆盖默认 configure 参数，所以务必把你要的功能全写进去，漏了 --enable-fpm 就没法跑 PHP-FPM。
立即学习“PHP免费学习笔记（深入）”；
多进程模型下必须处理子进程生命周期
pcntl 不是“开个扩展就能并发”，父进程若不主动回收，子进程会变孤儿进程（ppid=1），长期运行会堆积僵尸进程。
-
pcntl_fork()后，子进程逻辑末尾必须调用exit()，不能让它继续跑后续父进程代码 - 父进程要用
pcntl_waitpid(0, $status, WNOHANG)非阻塞轮询，或pcntl_wait()阻塞等待 —— 否则主脚本退出后子进程还在跑 - 别在 Web SAPI（如 Apache/Nginx+PHP-FPM）里用 pcntl：FPM worker 进程被复用，fork 出来的子进程可能被意外继承或干扰请求生命周期
典型错误现象：ps aux | grep php 看到一堆状态为 Z（zombie）的进程，就是没 wait 导致的。
容器或 CI 环境中容易忽略的点
用 phpenv 构建的 PHP 如果要放进 Docker 镜像，得确保构建阶段就完成编译 —— runtime 镜像里没有 gcc、make，无法补装。
- Dockerfile 中不要写
pecl install pcntl，它一定失败 - 如果 base 镜像用的是
php:8.3-cli，它默认没 pcntl；得自己基于源码 FROMphp:8.3-cli并重编译 - GitHub Actions 或 GitLab CI 中，缓存 php-build 编译产物能提速，但要记得 cache key 包含
PHP_BUILD_CONFIGURE_OPTS值，否则缓存会误用不含 pcntl 的旧二进制
最易被忽略的细节：macOS 上用 phpenv 编译的 PHP，pcntl_fork() 可用，但某些信号行为（如 pcntl_signal()）和 Linux 有差异，生产环境务必在目标部署系统上验证。
