GitHub 严选周刊 2025-W51 期：workerman

异步PHP的破局者：Workerman，重塑你的服务范式

---

编辑推荐语 (Editor’s Verdict)

在PHP的世界里，异步编程一度被视为“异端”，而持久化连接的低效更是传统FPM模式的阿喀琉斯之踵。然而，今天我们要深入剖析的Workerman，正是那把打破僵局的利刃。我们的编辑团队经过深入测试与代码审查，认为Workerman不仅是PHP异步生态中的一颗璀璨明星，更是将PHP带入高性能、实时应用领域的核心驱动力之一。

评分：4.5/5.0

推荐理由：

Workerman以其纯PHP的实现、简洁的API、对多种协议的强大支持（HTTP、WebSocket、SSL等），以及出色的性能表现，为PHP开发者开启了一扇通往高性能、高并发服务端应用的大门。它降低了PHP开发者进入异步I/O世界的门槛，使得我们能够用熟悉的语言构建以前难以想象的实时服务。尽管存在一定的学习曲线和传统PHP思维模式的转变，但其带来的生产力提升和架构灵活性是毋庸置疑的。对于寻求在PHP生态中构建实时通信、微服务、IoT网关等场景的团队，Workerman绝对是值得我们投入时间和精力去掌握的利器。

---

它是什么？重塑PHP的服务心跳

长久以来，PHP在Web开发领域占据主导地位，其“请求-响应”的短生命周期模型简单高效。然而，面对实时通信、物联网、推送服务等需要长连接、高并发的场景时，传统PHP-FPM模式的局限性就显露无遗了。每个请求独立启动、销毁，资源无法复用，内存反复初始化，效率低下。正是在这样的背景下，Workerman应运而生，它彻底改变了PHP服务的运行范式。

Workerman，正如其在GitHub上简洁有力的描述所言：“一个异步事件驱动的PHP Socket框架。支持HTTP、Websocket、SSL及其他自定义协议。”这短短一句话，概括了它的核心价值。

1. 异步事件驱动：告别阻塞，拥抱并发

传统的PHP脚本是同步阻塞的，即一个任务未完成，下一个任务就无法开始。Workerman通过引入“事件循环”（Event Loop）机制，将I/O操作从阻塞变为非阻塞。这意味着当一个I/O任务（如数据库查询、文件读写、网络请求）正在等待时，Workerman不会傻傻地原地等待，而是可以去处理其他请求或执行其他任务。当I/O任务完成后，Workerman会通过事件回调机制通知对应的处理逻辑。这种“多任务并行”的能力，极大地提升了PHP应用程序的处理效率和并发能力。

2. 纯PHP的Socket框架：性能与熟悉的平衡

Workerman最让我们眼前一亮的是其纯PHP实现。相较于一些需要C扩展的异步框架，Workerman无需额外编译安装C扩展，这无疑降低了部署和维护的复杂度，对于广大PHP开发者来说更加亲切。它直接在PHP层面封装了底层的Socket操作，提供了统一、简洁的API接口。通过Worker进程模型和事件循环，Workerman使得PHP应用能够长时间运行在内存中，复用资源，避免了传统模式下每次请求都重新加载框架和业务代码的开销。

3. 多协议支持：构建无所不能的服务

Workerman不仅仅是一个HTTP服务器。它强大的协议支持是其通用性的体现：

• HTTP: 可以高性能地构建RESTful API服务，或者作为轻量级的Web服务器。
• WebSocket: 这是Workerman最常被提及的应用场景之一，轻松构建实时聊天、弹幕、在线游戏等互动应用。
• SSL/TLS: 内置对加密传输的支持，保障数据安全。
• 自定义协议: 这是Workerman设计哲学中非常重要的一环。开发者可以根据自己的业务需求，定义并实现任何二进制或文本协议，这使得Workerman能够轻松应对各种IoT设备通信、游戏服务器等特定场景。

Workerman工作流可视化

为了更好地理解Workerman如何处理请求，我们绘制了一个简化的HTTP服务处理流程图：

上图展示了Workerman服务如何接收请求、分配给子进程、利用事件循环处理异步I/O，并最终返回响应。核心在于Worker子进程内部的事件循环，它使得在等待某个I/O操作时，该进程可以继续处理其他已就绪的任务。

Workerman核心功能代码示例

让我们通过一些简单的代码片段，看看Workerman如何快速启动一个HTTP服务和WebSocket服务。

1. 启动一个简单的HTTP服务

<?php
require_once __DIR__ . '/vendor/autoload.php';

use Workerman\Worker;
use Workerman\Connection\TcpConnection;

// 创建一个Worker，监听2345端口，使用http协议
$http_worker = new Worker('http://0.0.0.0:2345');

// 启动4个进程对外提供服务
$http_worker->count = 4;

// 当收到客户端请求时，执行此回调函数
$http_worker->onMessage = function(TcpConnection $connection, $data)
{
    // data 是一个包含了请求信息的数组
    // 我们可以根据请求路径返回不同的内容
    if ($data->path === '/') {
        $connection->send('<h1>Hello Workerman!</h1>');
    } elseif ($data->path === '/time') {
        $connection->send('Current time: ' . date('Y-m-d H:i:s'));
    } else {
        $connection->send('404 Not Found', [], 404);
    }
};

// 运行所有的Worker
Worker::runAll();

这段代码展示了如何创建一个监听HTTP协议的Worker。$http_worker->onMessage回调函数在每次接收到HTTP请求时被调用，$data对象包含了请求的所有信息，我们可以根据$data->path等来处理不同的路由。$connection->send()则用于发送HTTP响应。

2. 启动一个简单的WebSocket服务

<?php
require_once __DIR__ . '/vendor/autoload.php';

use Workerman\Worker;
use Workerman\Connection\TcpConnection;

// 创建一个Worker，监听2346端口，使用websocket协议
$ws_worker = new Worker('websocket://0.0.0.0:2346');

// 启动一个进程对外提供服务
$ws_worker->count = 1;

// 当客户端连接时
$ws_worker->onConnect = function(TcpConnection $connection) {
    echo "New connection from " . $connection->remoteAddress . "\n";
};

// 当客户端发送消息时
$ws_worker->onMessage = function(TcpConnection $connection, $data) {
    // 收到消息，原样返回给客户端
    $connection->send("Echo: " . $data);
};

// 当客户端断开时
$ws_worker->onClose = function(TcpConnection $connection) {
    echo "Connection closed " . $connection->remoteAddress . "\n";
};

// 运行所有的Worker
Worker::runAll();

这个WebSocket示例则展示了onConnect, onMessage, onClose等事件回调。通过这些回调，我们可以轻松构建实时通信应用。当客户端连接时，onConnect被触发；当客户端发送消息时，onMessage被触发，我们可以在这里处理业务逻辑并发送响应；当客户端断开时，onClose被触发。

这些代码片段直观地展现了Workerman简洁而强大的API设计，让PHP开发者能够以一种全新的方式构建服务。

---

群雄逐鹿：Workerman在异步PHP生态中的定位

在PHP的异步世界里，Workerman并非孤军奋战。它与一系列优秀的项目共同构筑了PHP高性能、高并发服务的未来。理解Workerman的定位，就必须将其置于整个生态中进行比较。

1. Workerman vs Swoole：瑜亮之争，各擅胜场

提及PHP异步，Swoole是一个绕不开的名字。Swoole与Workerman是PHP异步领域最受关注的两个框架，它们目标相似，但实现路径和哲学却有所不同。

• Swoole: 作为PHP的C语言扩展，Swoole通过在底层实现强大的异步I/O、协程（Coroutine）、毫秒级定时器等功能，赋予PHP近乎Go语言的并发能力。它的性能极限更高，能够处理更大规模的并发连接。但代价是：它是一个C扩展，需要编译安装，对PHP版本和环境有一定要求；其协程化的编程范式虽然强大，但对于习惯传统PHP阻塞编程的开发者来说，需要更陡峭的学习曲线来适应。
• Workerman: 坚持纯PHP实现。这意味着它不依赖额外的C扩展，部署更简单，兼容性更好。它的性能虽然在极端情况下可能略逊于Swoole，但在多数应用场景下，其纯PHP的性能表现已经非常出色，足以满足高并发需求。对于习惯事件驱动编程模型（如Node.js）的开发者来说，Workerman的onMessage、onConnect等回调函数会让他们感到熟悉。

我们的观点：

选择Swoole还是Workerman，更多取决于项目需求和团队背景。

• 选择Swoole: 如果你的项目对性能有极致要求，需要处理超大规模并发（数百万级），且团队有能力驾驭协程编程，Swoole无疑是更强大的选择。它更像一个“PHP运行时”。
• 选择Workerman: 如果你希望用纯PHP构建高性能服务，更看重部署的简易性和对现有PHP代码的兼容性，或者团队更熟悉事件回调模式，Workerman会是更平滑、更快速的上手方案。它更像一个“PHP框架”。

2. Workerman vs ReactPHP/Amp：框架与工具集

ReactPHP和Amp是PHP异步生态中的另外两位重要玩家。它们都提供了事件循环、Promise/Deffered等异步编程的基础设施。

• ReactPHP/Amp: 更倾向于提供一系列异步编程的“组件”或“工具集”，它们相对底层，让开发者能够自由组合，构建自己的异步应用。这为开发者提供了极高的灵活性，但同时也意味着你需要投入更多精力去整合和构建一个完整的服务框架。
• Workerman: 则是一个完整的“框架”。它不仅提供了事件循环，还封装了Worker进程管理、协议解析等上层功能，开箱即用，让开发者能够更专注于业务逻辑的实现。

我们的观点：

• 如果你需要高度定制化的异步组件，或者只是想将异步能力集成到现有项目中的某个特定模块，ReactPHP或Amp提供的底层库会是很好的选择。
• 如果你想快速搭建一个完整的、高性能的独立服务，Workerman作为框架的优势就非常明显了，它提供了更全面的解决方案。

3. Workerman vs 传统PHP-FPM：适用场景的分野

Workerman与传统PHP-FPM的对比，是两种服务模型的选择。

• 传统PHP-FPM (Nginx + PHP-FPM): 简单、稳定、易于部署，非常适合处理无状态的短连接HTTP请求，例如大部分传统的Web网站和RESTful API。它每次请求都重新初始化环境，隔离性好，一个请求失败不会影响其他请求。
• Workerman: 专注于长连接、实时通信、高并发的场景。它通过进程常驻内存、资源复用、事件循环等机制，弥补了PHP-FPM在这些场景下的不足。

我们的观点：

这并非“谁取代谁”的问题，而是“谁更适合特定场景”的问题。

• 对于绝大多数传统的Web网站或API服务，我们仍然推荐使用PHP-FPM，因为它足够成熟，生态丰富。
• 但当你需要构建WebSocket聊天室、实时数据推送、IoT设备连接、高性能游戏服务器或常驻内存的微服务时，Workerman是更自然、更高效的选择。它允许你用PHP语言，实现以前需要Node.js或Go才能轻松实现的功能。

Workerman的潜在坑点与适用局限

尽管Workerman拥有诸多优点，我们在实践中也发现了一些需要注意的方面：

• 传统PHP思维惯性: 最常见的“坑”就是开发者习惯了PHP-FPM的短生命周期，在Workerman中仍然使用全局变量、静态变量存储请求相关数据，或者在回调中执行阻塞I/O操作（如sleep()）。这会导致内存泄漏、数据混淆或整个Worker进程阻塞。需要严格遵守事件驱动和非阻塞的编程范式。
• 内存管理: 长期运行的Workerman进程会持续占用内存。如果代码中存在内存泄漏，或者大量使用不释放的资源，进程内存会持续增长。我们需要在代码中注意资源释放，或者通过Workerman提供的max_requests等机制定期重启进程。
• 调试复杂度: 异步和多进程环境下的调试比传统同步代码更复杂。需要借助日志、Xdebug远程调试（配置相对复杂）或Workerman内置的posix_kill信号来辅助调试。
• 不适合复杂计算密集型任务: 尽管Workerman擅长I/O密集型任务，但对于需要长时间CPU计算的任务（如图片处理、视频编码），仍然建议通过消息队列异步处理，避免阻塞Workerman的事件循环。

结语

Workerman以其纯PHP的实现和强大的异步能力，为PHP开发者打开了新的篇章。它不是为了取代PHP-FPM，而是为PHP拓展了更广阔的应用场景。通过深入理解其工作原理、编程范式和适用边界，我们的团队相信，Workerman将成为你在构建高性能、实时PHP服务时不可或缺的利器。是时候让你的PHP，拥有一个跳动不止的服务心跳了。