phpEnv 安装的 PHP 默认不支持 pcntl，必须重编译并添加 --enable-pcntl 参数；Windows 下完全不可用；Web 环境（如 PHP-FPM）中 pcntl 函数被禁用，仅 CLI 有效。
phpEnv 是一个面向 PHP 开发者的本地环境管理工具（类似 XAMPP/MAMP，但更轻量），默认不启用 pcntl 扩展——哪怕你用它安装的是 CLI 模式 PHP。这不是配置开关能打开的，必须重编译 PHP 二进制并显式带上 --enable-pcntl，否则 pcntl_fork() 等函数根本不存在。
phpEnv 安装的 PHP 是否支持 pcntl？先验证再动手
别假设“装了就能用”。phpEnv 底层仍是调用源码编译，但它默认跳过了 --enable-pcntl。执行以下命令确认：
-
php -m | grep pcntl—— 无输出即未启用 -
php --ri pcntl—— 报错“Extension 'pcntl' not present”说明彻底缺失 -
php -r "var_dump(function_exists('pcntl_fork'));"—— 返回bool(false)就是没编译进去
Windows 下直接放弃：phpEnv 的 Windows 版本即使能跑，pcntl 也注定不可用，因为扩展本身不兼容 Win32 API。
在 phpEnv 中启用 pcntl 的唯一可靠方式：重编译 PHP
phpEnv 的核心机制是通过 phpenv install 触发源码编译。你不能靠改 php.ini 或 pecl install 加载 pcntl —— 它不是独立 so 扩展，而是 SAPI 级内置模块，必须在 configure 阶段绑定。
立即学习“PHP免费学习笔记（深入）”；
- 先查清当前 PHP 版本和已用参数：
phpenv version-name（如8.2.12），再运行php-config --configure-options复制完整参数串 - 编辑 phpEnv 的构建脚本（通常在
~/.phpenv/plugins/php-build/share/php-build/definitions/下对应版本文件），在configure_options行末尾追加--enable-pcntl - 执行
phpenv install --reinstall 8.2.12（替换为你实际版本）—— 注意加--reinstall强制覆盖，否则跳过已存在版本 - 完成后切到该版本：
phpenv global 8.2.12，再验证php -m | grep pcntl
漏掉原有 configure 参数（比如 --with-openssl、--enable-fpm）会导致其他功能丢失，比如 HTTPS 请求失败或无法启动 FPM。
pcntl 多进程并发在 phpEnv 环境下的典型陷阱
即使编译成功，CLI 脚本里用 pcntl_fork() 仍可能出问题：
-
Web 服务器下完全无效：phpEnv 启动的 Apache/Nginx + PHP-FPM 模式中，
pcntl函数被禁用（PHP 内部检查sapi_module.name !== "cli"），调用直接报Warning: pcntl_fork(): fork() failed -
子进程不自动退出 = 僵尸进程：每个
pcntl_fork()后，子进程逻辑末尾必须调用exit()或die()，否则会继续执行父进程后续代码，造成进程数指数级增长 -
信号处理需显式启用 ticks：想用
pcntl_signal(SIGCHLD, ...)捕获子进程退出，必须在脚本开头加declare(ticks = 1);，否则信号会被忽略 - 资源隔离是默认行为：数据库连接、Redis 实例、文件句柄等不会跨进程共享——子进程里得重新 connect，别指望复用父进程的 PDO 对象
真正要跑多进程任务，就老实用 phpenv shell 8.2.12 切到 CLI 环境，然后执行脚本；别试图在 phpEnv 自带的 Web 界面或浏览器请求里调用 pcntl_fork()。
