Workerman 4.0.41 完整入门到精通实战教程-php教程-PHP中文网

workerman 4.0.41 是纯 php 实现的跨平台异步框架，支持 php 8.1+ 和 pcntl，无需编译扩展；安装后可快速搭建 http/websocket 服务，提供单进程调试、gatewayworker 分布式部署及轻量级进程通信方案，并需配置守护模式、日志路径、运行用户等生产项。

workerman 4.0.41 完整入门到精通实战教程

你想用 PHP 写一个能扛住千人并发的聊天室、实时通知系统或 IoT 设备网关，又不想折腾 Swoole 编译和 C 扩展兼容问题——Workerman 4.0.41 就是那个纯 PHP 实现、开箱即用、Linux/macOS/Windows 全平台跑得稳的异步服务框架。它不依赖外部扩展，只要 PHP 8.1+ 和 pcntl 支持，就能启动高性能长连接服务。

环境准备与基础安装

先确认你的 PHP 版本不低于 8.1：php -v。若低于此版本，请升级后再继续，否则 Worker::runAll() 会直接报错退出。

执行 composer require workerman/workerman 安装最新稳定版（当前为 4.0.41）。Composer 会自动下载到 vendor/workerman/workerman 目录下，并生成 autoload.php。

【必须解除禁用的函数】：检查 php.ini 中是否禁用了 pcntl_fork、pcntl_wait、pcntl_signal、pcntl_alarm、pcntl_signal_dispatch 这 5 个函数。任一缺失都会导致 Workerman 启动失败且无明确报错，只显示 “PHP Warning: pcntl_fork() has been disabled for security reasons”。

5 分钟跑通第一个 HTTP 服务

创建 server.php 文件，内容如下：

```php
require_once __DIR__ . '/vendor/autoload.php';
use Workerman\Worker;
$http = new Worker('http://0.0.0.0:2345');
$http->count = 2;
$http->onMessage = fn($conn, $req) => $conn->send("Hello from Workerman 4.0.41!");
Worker::runAll();
```

终端执行 php server.php start，看到 WORKERS STATUS 表格中 tcp 行显示 [OK]，即表示服务已就绪。

浏览器访问 http://localhost:2345，页面显示 Hello from Workerman 4.0.41! ——这说明事件循环、HTTP 解析、响应发送全部走通。

WebSocket 聊天室：从单机广播到多进程协同

WebSocket 是 Workerman 最典型的应用场景。但注意：4.0.41 默认不共享内存，多个进程之间无法直接访问彼此的 $connections 数组。

方法一：单进程模式（开发调试首选）
把 $ws_worker->count = 1; 即可绕过进程隔离问题，所有连接都在同一进程内，foreach($ws_worker->connections as $conn) 广播消息完全可靠。

行者AI

一款面向AI绘画创作的视觉生成工具，帮助用户根据创意描述制作图片和艺术作品，用于灵感探索和内容创作。

下载

方法二：使用 GatewayWorker（生产推荐）
这不是“额外插件”，而是 Workerman 官方配套的分布式架构组件。它拆分为 Gateway（负责 WebSocket 连接接入）、BusinessWorker（业务逻辑）、Register（注册中心）三类进程。GatewayWorker 通过文本协议或 Redis 实现跨进程通信，彻底解决广播一致性问题。

方法三：手动实现进程间通信（轻量级替代）
在 onMessage 回调中，用 Worker::$pid 获取当前进程 ID，再遍历 Worker::$pidArray 获取所有 worker 进程 PID；通过 posix_kill 发送 SIGUSR1 信号触发其他进程 reload 连接列表——但该方式易丢消息、难维护，仅适合极简原型验证。

守护进程与日志管理

第一步：启用守护模式
在 server.php 开头添加 Worker::$daemonize = true;，然后运行 php server.php start -d。

第二步：指定日志路径
加一行 Worker::$logFile = __DIR__ . '/storage/logs/workerman.log';。不设此项时，日志默认写入 /tmp/workerman.log，容易被系统清理。

第三步：查看实时日志
用 tail -f storage/logs/workerman.log 监控错误。特别注意：当出现 “Fatal error: Uncaught RuntimeException: Event extension not installed” 时，说明你误启用了 event 扩展但未安装，此时应删掉 php.ini 中的 extension=event.so 行，Workerman 4.0.41 在无 event/Swoole/Swow 时自动回退到 stream_select，性能略低但 100% 兼容。