Swoole通过Reactor模式结合I/O多路复用实现事件驱动，其事件循环利用epoll/kqueue监听文件描述符事件，Reactor线程负责监听并分发就绪事件至回调函数，Worker进程处理业务逻辑，从而实现高并发；开发者通过on()方法注册onConnect、onReceive等网络事件回调，同时支持定时器、Task任务投递、协程调度等非I/O事件，形成完整的事件驱动体系。
Swoole实现事件驱动的核心在于其异步非阻塞I/O模型与Reactor模式的结合，它通过监听文件描述符上的各种I/O事件，并在事件就绪时触发预设的回调函数来响应。使用上，这主要体现在对连接、数据收发、定时器等事件的注册与处理。
Swoole的事件驱动并非魔法，它扎根于操作系统提供的I/O多路复用技术，比如Linux下的epoll，macOS/FreeBSD的kqueue。Swoole自己封装了一个高性能的事件循环（Event Loop），这个循环持续不断地监听着成千上万个文件描述符（fd）上的可读、可写、错误等事件。当一个fd上的某个事件准备好时，比如有新连接到来，或者客户端发送了数据，Swoole的Reactor线程（或者进程，取决于配置）就会立即收到通知，然后它不会阻塞等待，而是将这个事件分发给对应的处理逻辑——也就是我们预先定义好的回调函数。
具体到使用，Swoole提供了一系列事件回调方法，这些方法是你在启动服务器前必须设置的。例如，一个基本的TCP服务器，你至少会关注
onStart（服务器启动时）、
onConnect（新连接建立时）、
onReceive（收到数据时）、
onClose（连接关闭时）等事件。这些回调函数就是你的业务逻辑入口。你把处理连接、解析数据、响应请求的代码写在这些回调里，Swoole会在合适的时机自动调用它们。这种模式下，你的程序不会因为等待某个I/O操作完成而停滞，从而能够同时处理大量的并发请求。
除了这些基础的网络事件，Swoole还提供了定时器（
swoole_timer_tick,
swoole_timer_after）和自定义事件（通过Channel、Task等实现进程间通信，或者直接在Worker进程内通过协程调度）的机制，这些也都是事件驱动模型的一部分，让你可以更灵活地安排任务执行。
Swoole的事件循环（Event Loop）是如何工作的？
Swoole的事件循环，可以想象成一个永不疲惫的“调度员”。它不是简单地轮询每个连接有没有数据，那种效率太低。它利用的是操作系统底层的通知机制。当你在Swoole中启动一个服务，它会初始化一个或多个Reactor线程（或进程）。这些Reactor的核心职责就是维护一个事件监听器，比如epoll实例。每当你接受一个新连接，或者通过
swoole_client发起一个异步请求，这个对应的socket文件描述符就会被注册到Reactor的事件监听器中。
当某个socket上有数据可读、可写，或者连接状态发生变化时，操作系统会通知Reactor。Reactor收到通知后，它并不会立即处理业务逻辑，而是将这个“事件就绪”的信号，连同相关的fd信息，快速地投递给一个任务队列。然后，Worker进程（或协程）会从这个队列中取出事件，执行对应的用户回调函数。这种分离设计——Reactor只负责I/O事件的监听和分发，Worker才负责具体的业务逻辑处理——极大地提高了并发能力和系统吞吐量。它避免了业务逻辑处理的耗时操作阻塞I/O监听，使得整个系统能够高效地响应大量并发请求。有时候，你可能会遇到“协程挂起”的情况，这其实也是事件循环的一部分，当协程遇到一个阻塞的I/O操作时，它会主动让出CPU，等待I/O事件就绪后，事件循环会再次调度它继续执行。
在Swoole中，如何注册和处理常见的网络事件？
注册和处理网络事件是Swoole开发的基础。这通常通过在
Swoole\Http\Server、
Swoole\Server等服务器实例上调用
on()方法来完成。例如，创建一个HTTP服务器，你会这样设置：
$http = new Swoole\Http\Server("0.0.0.0", 9501);
// 服务器启动时触发
$http->on('start', function ($server) {
echo "Swoole http server is started at http://127.0.0.1:9501\n";
});
// 收到HTTP请求时触发
$http->on('request', function ($request, $response) {
// 获取请求路径
$path = $request->server['request_uri'];
// 简单的路由判断
if ($path === '/') {
$response->end("Hello Swoole.
");
} elseif ($path === '/info') {
$response->header('Content-Type', 'application/json');
$response->end(json_encode(['server' => 'Swoole', 'time' => date('Y-m-d H:i:s')]));
} else {
$response->status(404);
$response->end("404 Not Found");
}
});
// 连接关闭时触发（TCP/HTTP通用，但HTTP通常更关注request）
$http->on('close', function ($server, $fd) {
// 可以在这里做一些资源清理，但HTTP短连接场景下意义不大
// echo "Client {$fd} closed.\n";
});
$http->start();对于TCP服务器，事件会略有不同：
$server = new Swoole\Server("0.0.0.0", 9502);
// 新连接建立时触发
$server->on('connect', function ($server, $fd) {
echo "Client: Connect.\n";
});
// 收到客户端数据时触发
$server->on('receive', function ($server, $fd, $reactor_id, $data) {
$server->send($fd, "Server: " . $data); // 回复客户端
});
// 连接关闭时触发
$server->on('close', function ($server, $fd) {
echo "Client: Close.\n";
});
$server->start();这些回调函数就是Swoole事件机制的实际应用。当对应的事件发生时，Swoole会自动调用你注册的函数，并将相关的参数（如服务器实例、文件描述符、数据等）传递给你，你只需要在函数内部编写你的业务逻辑即可。这里面有个小细节，
onReceive里的
$reactor_id，它其实告诉你这个事件是由哪个Reactor线程分发过来的，在一些高级调试或特定场景下可能会用到，但日常开发中通常不会直接操作它。
除了网络I/O，Swoole的事件机制还能用于哪些场景？
Swoole的事件机制远不止于处理网络I/O，它渗透到了异步编程的方方面面。最直观的延伸就是定时器。通过
swoole_timer_tick和
swoole_timer_after，你可以注册周期性任务或一次性延迟任务。这在需要执行定时清理、数据同步、心跳检测等场景非常有用。比如，你可能需要每隔5秒检查一下某个服务的状态，或者在用户注册后10分钟发送一封欢迎邮件，这些都可以通过定时器事件来驱动。
另一个重要场景是任务投递与处理。Swoole的
Task机制，本质上也是一种事件驱动。当你在Worker进程中调用
$server->task()时，实际上是向Task进程投递了一个“任务事件”。Task进程收到这个事件后，会执行对应的回调函数（
onTask），处理完后再将结果通过
$server->finish()投递回Worker进程的
onFinish回调。这种设计非常适合处理耗时操作，比如发送邮件、处理图片、生成报表等，避免阻塞主Worker进程，从而保证了服务的高并发响应能力。
此外，进程间通信（IPC），比如通过
Swoole\Channel或者
Swoole\Process间的管道通信，也可以看作是事件驱动的体现。当一个进程向Channel写入数据，另一个进程在读取时，如果数据未就绪，读取操作会“挂起”等待，直到数据可用（一个事件），然后继续执行。这在构建微服务架构或需要不同进程协作完成复杂任务时显得尤为重要。
甚至，Swoole的协程本身，其调度机制也离不开事件驱动。当一个协程遇到阻塞I/O（如数据库查询、文件读写、网络请求）时，它会主动让出CPU，并注册一个“I/O就绪”事件。当I/O操作完成，对应的事件被触发时，事件循环会重新调度这个协程继续执行。这种“非阻塞”的体验，正是Swoole事件驱动模型在更高层面上的体现，让开发者能够以同步的思维编写异步代码，极大地提升了开发效率和代码可读性。可以说，Swoole的强大，很大程度上就是它对事件驱动理念的极致运用和封装。
