Workerman提示pcntl扩展缺失怎么办？宝塔怎么安装pcntl？-php教程-PHP中文网

pcntl_fork()报错是因为pcntl扩展未启用，需在宝塔中找到对应php版本的php.ini取消extension=pcntl和extension=posix前的分号，保存后重载配置，并用php -m验证是否加载成功。

workerman提示pcntl扩展缺失怎么办？宝塔怎么安装pcntl？

pcntl_fork() 报错说明扩展根本没加载

看到 PHP Fatal error: Uncaught Error: Call to undefined function pcntl_fork()，不是版本低或路径错，就是 pcntl 这个扩展压根没启用。宝塔默认 PHP（7.4/8.0/8.1）安装完后，pcntl 和 posix 都是注释掉的，不会自动开——哪怕你装的是“完整版”PHP，也得手动解注释。

进宝塔 → 软件商店 → 找到你用的 PHP 版本（比如 PHP 8.0）→ 点“设置” → “配置文件”，打开 /www/server/php/80/etc/php.ini
搜索 extension=pcntl，把前面的分号去掉；同理处理 extension=posix
保存后，**必须点“重载配置”或“重启”**——只改文件不重启，PHP 进程根本不读新配置
验证：终端执行 /www/server/php/80/bin/php -m | grep pcntl，有输出才表示真启用了

宝塔里装 pcntl 不用编译，但路径和权限容易出错

pcntl 是 PHP 内置扩展，不需要下载源码、不用 phpize 编译。但很多人卡在两个地方：一是改错了 php.ini 文件（比如改了 Nginx 用的 php.ini，却用 CLI 的 PHP 启动 Workerman），二是权限没给对，导致 PHP 进程读不到扩展文件。

Workerman

最新主版本，继续强化高性能异步网络能力，适合 WebSocket、HTTP 服务、长连接、IM、IoT 等场景。本次版本主要围绕稳定性、协议兼容以及连接处理能力优化，依旧保持超轻量和纯 PHP 特性。适用于 PHP 8.x 环境，可配合 webman、GatewayWorker 等生态使用。

下载

确认你改的是 CLI 模式用的 php.ini：/www/server/php/80/bin/php --ini 查看 Loaded Configuration File 路径
扩展文件 pcntl.so 默认就在 /www/server/php/80/lib/php/extensions/no-debug-non-zts-20200930/ 下（后缀随 PHP 版本变）
如果 php -m 仍不显示 pcntl，检查该目录下是否有 pcntl.so，没有就说明 PHP 编译时没带 --enable-pcntl，这时得重装 PHP 或手动编译（见下一条）

已安装 PHP 却找不到 pcntl.so？可能需要手动编译

某些宝塔 PHP 版本（尤其是从旧版升级上来的）虽然带了 --enable-pcntl 参数，但没把 pcntl.so 编译进扩展目录。这时候就得自己动手补上，别指望“软件商店一键安装”能搞定。

先确认你有 PHP 源码（没的话去 https://www.php.net/distributions/ 下对应版本的 tar.gz）
解压后进 ext/pcntl/ 目录，运行：/www/server/php/80/bin/phpize → ./configure --with-php-config=/www/server/php/80/bin/php-config → make && make install
命令成功后会输出类似 Installing shared extensions: /www/server/php/80/lib/php/extensions/no-debug-non-zts-20200930/，记下这个路径
在 php.ini 里写全路径：extension=/www/server/php/80/lib/php/extensions/no-debug-non-zts-20200930/pcntl.so

posix 缺失会导致热重启失效，必须一起开

Workerman 平滑重启（kill -USR1）、连接池管理、信号捕获都依赖 posix。单独开了 pcntl 却没开 posix，启动时可能不报错，但一发 USR1 就崩，或者 start.php status 显示进程数为 0。

和 pcntl 一样，在同一份 php.ini 里取消 extension=posix 前的分号
验证命令：/www/server/php/80/bin/php -r "echo extension_loaded('posix') ? 'yes' : 'no';"，输出 yes 才算到位
别信宝塔界面上“已安装”的灰色按钮——那些只是状态标记，不代表 CLI 模式已加载

真正跑起来之前，先跑一遍 /www/server/php/80/bin/php start.php status。看到 Workerman[xxx] process status 且进程数 > 0，才算跨过了最硬的那道坎。很多问题表面是 pcntl 缺失，实际是 posix 没配、php.ini 改错文件、或者忘了重启 PHP —— 这些细节比编译本身更常绊倒人。