Linux和macOS部署Workerman时核心扩展依赖完全相同,均必须启用pcntl和posix扩展;event扩展安装路径不同:macOS需先brew install libevent再pecl install event(OpenSSL选no),Linux则用yum/apt安装对应devel/dev包;守护进程和信号处理存在细微差异。

Workerman协程跨平台部署时,Linux和macOS在底层行为上几乎一致,但实际运行中因系统调用细节差异,可能导致进程管理、信号响应或高并发I/O表现不同。
核心扩展依赖完全相同
Linux和macOS都必须启用【pcntl】和【posix】扩展,缺一不可。这两个扩展是Workerman实现多进程模型的基石,Windows不支持,但Linux/macOS共用同一套POSIX兼容层,因此编译安装方式、ini配置路径、加载逻辑完全一致。
运行环境检测脚本可通用:curl -Ss http://www.workerman.net/check.php | php —— 该脚本在两者上输出结果含义相同,全部ok即代表基础可用。
event扩展安装路径略有不同
方法一:macOS(Homebrew环境)
1. 先执行 brew install libevent
2. 再运行 pecl install event,提示 Include libevent OpenSSL support [yes] 时务必输入 【no】,否则可能引发SSL握手阻塞
3. 将 extension=event.so 写入 php.ini 对应的 extensions 目录(通常为 /usr/local/etc/php/8.0/conf.d/ext-event.ini)
方法二:Linux(CentOS/Ubuntu)
CentOS用户直接 yum install libevent-devel && pecl install event;Ubuntu用户 apt-get install libevent-dev && pecl install event。注意:PHP版本低于5.4时必须改用 libevent 扩展而非 event。
⚠️ 不同点在于:macOS默认不带 libevent-devel 类似包,必须先用 brew 补齐,而Linux发行版仓库中该依赖通常已预置。
守护进程行为存在细微差别
使用 php start.php start -d 启动后:
• Linux会自动调用 setsid() 创建新会话,彻底脱离终端控制组,即使SSH断开仍稳定运行
• macOS虽也支持 setsid(),但部分较新版本(如macOS Sonoma 14.5+)对 session leader 的权限校验更严格,偶尔出现子进程被意外回收现象
• 解决方案:在macOS上建议额外加 nohup php start.php start -d &> /dev/null &,双重保险
这一步操作起来很简单,直接把命令粘贴进终端回车就行。
信号处理响应时间不一致
第一步:发送 SIGUSR1 重载配置
Linux下通常 100ms 内完成平滑重启,macOS可能延迟至 300–500ms,尤其当worker数量超过8个时更明显
第二步:发送 SIGINT 停止服务
Linux能保证所有子进程收到信号并优雅退出,macOS偶发某个worker残留僵尸进程,需手动 kill -9 确认清理
第三步:检查 ps aux | grep worker 输出
Linux显示完整进程树层级清晰,macOS有时只显示主进程,子进程在 ps 中短暂不可见——这不是bug,是 Darwin 内核对进程组展示的优化策略


















