Workerman Mac系统安装pcntl扩展失败怎么搞定

云枫君_5397

云枫君_5397

2026-08-09

810人浏览

原创

Mac安装Workerman提示pcntl缺失,本质是PHP CLI未加载该内置扩展,需确认并编辑CLI实际读取的php.ini文件,解注释extension=pcntl和extension=posix两行,再验证php -m输出是否包含二者;原生/usr/bin/php自macOS 10.15起已移除pcntl支持,必须改用Homebrew安装的PHP。

workerman mac系统安装pcntl扩展失败怎么搞定

Mac系统安装Workerman时提示pcntl扩展缺失,本质是PHP CLI模式未加载该内置扩展,不是下载安装包的问题——macOS自带PHP或Homebrew安装的PHP默认都注释掉了pcntl和posix两行,必须手动解注释并确认CLI实际读取的是哪个php.ini文件。

确认当前CLI用的php.ini路径

终端执行 php --ini,重点看Loaded Configuration File这一行输出的完整路径。常见情况有:
• Homebrew PHP 8.1:/usr/local/etc/php/8.1/php.ini
• macOS原生PHP:/etc/php.ini(可能不存在,需先复制模板)
• MAMP或XAMPP:路径在应用安装目录内,不能直接改系统级配置

如果输出显示“Loaded Configuration File: (none)”,说明PHP CLI根本没加载任何ini文件,后续所有修改都无效。

解注释pcntl和posix扩展

用文本编辑器打开上一步确认的php.ini文件,搜索extension=pcntl和extension=posix两行。

把这两行开头的分号;删掉,保存文件。

【注意】不要只改Web服务器(如Apache/Nginx)用的php.ini,CLI模式用的是另一份!比如MAMP用户常误改了htdocs下的php.ini,而CLI仍读取/usr/local/bin/php对应的配置。

验证扩展是否真实启用

终端运行:php -m | grep -E "pcntl|posix"

Ribbi
Ribbi

一款AI视频创作工具,主要用于全能型AI视频创作与运营平台,适合需要提升相关任务效率的用户。

下载

如果输出包含pcntl和posix,说明成功;若为空,继续排查:

① 检查php.ini路径是否真被CLI加载:执行/usr/bin/php --ini(或Homebrew路径如/opt/homebrew/bin/php --ini),对比输出的Loaded Configuration File是否与你修改的文件一致;
② 若路径对但仍未生效,检查该php.ini里是否有disable_functions禁用了pcntl_fork等函数;
③ macOS原生PHP(如/usr/bin/php)从10.15起已移除pcntl支持,必须换用Homebrew安装的PHP版本。

Homebrew PHP用户补装pcntl(极少数情况)

方法一:重装带pcntl的PHP
执行brew uninstall php@8.1 && brew install php@8.1,Homebrew默认启用pcntl,重装后无需手动改ini。

方法二:手动编译pcntl(仅当php -v显示版本但php -m不显示pcntl时)
① 进入PHP源码ext/pcntl目录(需提前下载对应版本源码)→
② 执行/opt/homebrew/bin/phpize →
③ ./configure --with-php-config=/opt/homebrew/bin/php-config →
④ make && sudo make install
⑤ 在php.ini中写入绝对路径:extension=/opt/homebrew/lib/php/20210902/pcntl.so(路径以make install输出为准)

【关键】macOS原生/usr/bin/php无法启用pcntl,强行编译会失败,必须切换到Homebrew PHP。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
Workerman安装配置教程
Workerman安装配置教程

Workerman安装配置教程专题提供Workerman安装配置、WebSocket开发、TCP通信、异步编程、高并发服务搭建与PHP实时通信开发教程。

2026.05.20

226

15

Workerman实时通信与长连接开发教程
Workerman实时通信与长连接开发教程

WWorkerman实时通信与长连接开发教程聚合实时通信、聊天室、长连接、消息推送、AI流式输出等Workerman高并发开发内容。

2026.05.20

222

12

Workerman异步通信与TCP服务器开发
Workerman异步通信与TCP服务器开发

Workerman异步通信与TCP服务器开发专题整理Workerman异步通信、TCP服务、HTTP服务、WebSocket开发与高并发PHP服务器教程。

2026.05.20

247

13

GoFrame框架零基础入门
GoFrame框架零基础入门

本专题整理GoFrame框架的入门知识,从模块化设计理念、环境准备到跑通第一个Web服务,讲清目录分层、配置加载、日志与中间件的用法,并对比Gin、Go-Zero的差异,帮助Go开发者建立整体认知。

2026.11.17

0

15

SQLAlchemy 一对多关系怎么建立
SQLAlchemy 一对多关系怎么建立

SQLAlchemy 一对多关系怎么建立?本专题整理父子表外键、relationship 双向映射、关联查询、级联删除和加载优化等相关文章,帮助你理解并实现常见的 ORM 关系建模。

2026.11.17

0

10

SQLAlchemy 如何增删改查
SQLAlchemy 如何增删改查

SQLAlchemy 如何增删改查?本专题整理 ORM 新增记录、条件查询、更新和删除、Session 事务提交与批量处理等实用文章,帮助你掌握 Python 数据库操作流程。

2026.11.17

0

11

SQLAlchemy ORM 模型怎么写
SQLAlchemy ORM 模型怎么写

SQLAlchemy ORM 模型怎么写?本专题整理模型类定义、Mapped 字段映射、主键与约束、表结构创建和常见报错的相关文章,帮助你从基础配置到实际建模逐步掌握 SQLAlchemy。

2026.11.17

0

16

Go-Zero API开发使用教程
Go-Zero API开发使用教程

本专题聚焦Go-Zero的API开发,拆解.api描述文件的语法结构、路由与分组定义、参数绑定与校验规则,说明统一响应体、JWT鉴权、跨域与接口文档生成的落地方式,并给出网关聚合与接口测试的实践建议。

2026.11.12

160

15

Go-Zero安装与goctl环境配置教程
Go-Zero安装与goctl环境配置教程

本专题围绕Go-Zero的安装与工具链配置展开,讲清Go版本要求、goctl安装方式、代理镜像、protoc依赖与环境变量设置,说明多版本共存、升级回退与CI流水线安装的做法,并整理安装阶段的常见报错与验证步骤。

2026.11.12

120

15

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Webman中文手册
Webman中文手册

共0课时 | 0人学习

Workerman官方手册
Workerman官方手册

共0课时 | 0人学习

ThinkPHP5.1完全开发手册
ThinkPHP5.1完全开发手册

共0课时 | 0人学习