Workerman安装需要什么环境

秋墨同学_5847

秋墨同学_5847

2026-09-01

328人浏览

原创

Workerman能否运行取决于PHP CLI版本≥5.3.3(推荐≥7.4)、pcntl扩展和posix扩展三者必须同时满足;缺一则启动失败或reload失效,Linux/macOS尤其依赖后两者,Windows除外。

workerman安装需要什么环境

Workerman 能否跑起来,不取决于你装了多少包,而取决于三个硬性条件是否全部满足:PHP CLI 版本、pcntl 扩展、posix 扩展。缺一不可,少一个就启动失败或 reload 失效。

PHP CLI 版本必须 ≥5.3.3(推荐 ≥7.4)

Workerman 运行在 PHP 命令行模式下,php -v 显示的版本必须 ≥5.3.3。但注意:

  • Windows 用户可用 php -v 直接查,只要 ≥5.3.3 就行(Windows 版不依赖 pcntl/posix)
  • Linux/macOS 用户必须用 php -v 查 CLI 版本,不是 phpinfo() 里的 Web 版本 —— 两者可能不同
  • 生产环境强烈建议 ≥7.4(2026 年主流),PHP 8.1+ 更稳;低于 7.4 的版本已无安全更新

Linux/macOS 必须启用 pcntl 和 posix 扩展

这两个扩展是 Linux 下 fork 子进程、信号处理、进程控制的基础。缺失任一,会出现:

  • PHP Warning: pcntl_fork() has been disabled for security reasons
  • 服务启动后立刻退出,或 php start.php restart 无响应
  • 日志里反复出现 kill failed 或 signal handler not installed

验证方式:php -m | grep -E '^(pcntl|posix)$' —— 必须同时输出两行。若缺失:

Convai Technologies Inc.
Convai Technologies Inc.

Convai是一款为游戏和 XR 世界创建可对话 AI 角色的虚拟角色平台。

下载
  • CentOS/RHEL:yum install php-process(多数情况够用)
  • Debian/Ubuntu:apt-get install php-cli php-dev php-pear,再手动编译安装(官方未提供现成包)
  • 源码编译 PHP 的用户:configure 时需加 --enable-pcntl --enable-posix

并发高时建议补 event 扩展(非必需但关键)

当连接数经常 >1024,原生 PHP 的 select 模型会严重拖慢性能,event 扩展可切换到更高效的 libevent 后端。

  • 安装前确认:pecl install event 要求 PHP ≥5.4,且需先装系统级依赖(如 libevent-dev)
  • 安装后在 php.ini 加 extension=event.so,然后 php -m | grep event 验证
  • 注意:event 不是 libevent —— 后者是 C 库,前者才是 PHP 扩展;别混淆 extension=libevent.so(错误)
  • Workerman 官方检测脚本 curl -Ss http://www.workerman.net/check.php | php 不检查 event,得自己补测

最容易被忽略的是:即使所有扩展都装了,ulimit -n 默认值若仍是 1024,连接数一过千就会报 Too many open files —— 这个限制不在 PHP 层,而在系统 shell 级别,必须单独调高。

相关文章

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

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

下载

相关标签:

workerman安装 workerman

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系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

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

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

2026.11.12

140

15

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

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

2026.11.12

100

15

Go-Zero零基础入门教程
Go-Zero零基础入门教程

本专题整理Go-Zero的入门知识,从框架定位、环境准备到跑通第一个API服务,讲清目录分层、配置加载、日志与中间件的基本用法,并对比Gin、Kratos的差异,帮助Go开发者建立整体认知,判断它是否适合当前项目。

2026.11.12

80

15

Postman身份认证怎么配置
Postman身份认证怎么配置

本专题从实际API接口调试场景出发,讲解Postman身份认证的完整配置流程,包括常见认证协议介绍、授权参数设置、访问令牌填写、OAuth 2.0授权及认证失败排查,帮助用户正确完成接口授权与访问验证。

2026.11.06

160

12

Postman请求头Headers怎么设置
Postman请求头Headers怎么设置

围绕Postman HTTP请求头配置展开,讲解Headers选项的具体使用方式,包括Key和Value参数填写、请求头信息添加、常见Header字段设置及请求头修改方法,帮助用户解决接口调试过程中遇到的请求头配置问题。

2026.11.06

140

13

Postman接口请求发送教程
Postman接口请求发送教程

详细介绍Postman接口请求的创建与发送方法,涵盖GET和POST请求、URL配置、请求参数、Headers请求头、Body请求体设置以及响应结果查看,帮助用户掌握Postman接口请求的完整操作流程。

2026.11.06

120

10

热门下载

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

精品课程

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

共0课时 | 0人学习

Workerman官方手册
Workerman官方手册

共0课时 | 0人学习

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

共0课时 | 0人学习