PCNTL扩展仅在Linux/macOS下通过源码编译时启用--enable-pcntl才可用，Windows不支持；yum/apt安装或Docker官方镜像默认未启用，需检查php -m | grep pcntl，未输出则须重新编译并保留原有configure参数。
PCNTL（Process Control）扩展是 PHP 提供的一套用于进程控制的函数，比如 pcntl_fork()、pcntl_wait() 等，常用于编写多进程程序。但它仅在 Unix/Linux 系统下可用，Windows 不支持，且默认不随 PHP 编译安装，需要手动启用。
确认 PHP 是源码编译安装的
PCNTL 是 PHP 源码中的内置扩展，但不会自动编译进 PHP，必须在编译时显式启用。如果你用的是 yum/apt 安装的 PHP（如 `php` 包），通常不含 PCNTL；Docker 官方镜像或某些第三方仓库（如 ondrej/php）也默认禁用它。
检查方式：
- 运行
php -m | grep pcntl，无输出说明未启用 - 运行
php-config --configure-options，查看是否含--enable-pcntl - 若看到
--disable-pcntl或压根没这一项，就需要重新编译
编译时启用 PCNTL（推荐方式）
如果你有 PHP 源码并自己编译过，只需在 ./configure 阶段加上 --enable-pcntl 即可：
立即学习“PHP免费学习笔记（深入）”；
包装印刷厂网站源码适合印刷公司、图文门店、打印店进行区域业务拓展.通过网站展示业务，如特惠印刷楼书,纸杯,报纸书刊,画册,手提袋,信纸信封,海报,户型单,宣传单,等各种印刷品进行区域业务拓展，方便客户找到厂家。 易优cms包装印刷厂网站源码是基于易优cms开发，包含电脑端及移动端，如果需要小程序的话可以购买易优cms小程序插件，网站安装搭建简单，方便运营维护。
- 进入 PHP 源码目录（如
php-8.2.12/） - 执行：
./configure --enable-pcntl [其他已有选项] && make && sudo make install - 完成后重启 Web 服务（如 Apache/Nginx）或 PHP-FPM
- 验证：
php -m | grep pcntl应输出pcntl
⚠️ 注意：不要漏掉你原来已有的 configure 参数（比如 --with-mysqlnd、--enable-fpm 等），否则可能丢失其他功能。
已有 PHP 二进制，不想重编译？试试 pecl（不推荐）
PCNTL 无法通过 pecl install pcntl 安装，因为它是 SAPI 级内置扩展，不是独立的 PECL 包。强行运行会报错：ERROR: could not find package.xml
所以这条路走不通。网上有些“打补丁+编译 so”的方案，风险高、兼容性差，不建议生产环境尝试。
容器或一键环境（如 Laradock、XAMPP）怎么办？
这类环境底层仍是编译 PHP，你需要修改其构建逻辑：
- Laradock：编辑
php-fpm/Dockerfile，在./configure行末尾添加--enable-pcntl，然后docker-compose build php-fpm - 自定义 Dockerfile：在
./configure步骤确保带上该选项，并保留原有参数 - XAMPP/MAMP：它们基于预编译二进制，无法动态加 PCNTL，建议换用纯 CLI 环境或 Docker 自建
基本上就这些。PCNTL 不复杂但容易忽略编译开关，关键就是一句话：必须在 configure 阶段开启 --enable-pcntl，且仅限 Linux/macOS。
