onClose事件在Swoole中用于处理TCP或WebSocket连接关闭,客户端或服务端断开时均会触发。当客户端发送FIN包,Swoole检测到连接状态变化后立即通知Worker进程执行回调。自1.7.7版本起,可在回调内调用connection_info获取连接信息。Swoole保证onConnect、onReceive、onClose事件的顺序性,且回调执行完毕才真正释放socket。需避免在发送数据后立即close,防止数据丢失;onClose中若发生致命错误可能导致连接泄漏。该事件适用于清理会话、记录日志或更新在线状态。

onClose事件在Swoole中,当一个TCP或WebSocket连接被关闭时触发。无论是客户端主动断开连接,还是服务端调用了$server->close()方法,只要连接结束,就会执行这个回调。
触发时机
这个事件发生在连接关闭的过程中,但具体是在底层TCP四次挥手的某个阶段由Swoole内部机制捕获并通知Worker进程。
- 客户端发送FIN包请求关闭连接,服务端收到后,Swoole会检测到这一状态变化。
- 服务端应用层(即你的PHP代码)会立即收到通知,并进入onClose回调函数。
- 从1.7.7版本开始,在onClose函数内部仍然可以调用
connection_info等方法获取该连接的信息。
执行顺序与注意事项
Swoole保证了同一个连接的onConnect、onReceive、onClose事件是有序的。也就是说,连接建立后才能接收数据,数据接收完毕后才会触发关闭事件。
- onClose回调执行完毕后,Swoole才会真正从事件循环中移除该socket连接。
- 不要在发送完数据后立刻调用close,而应该确保客户端已接收到响应,否则可能导致数据丢失。
- 如果在onClose回调里发生致命错误,可能会导致连接资源无法正常释放,出现连接泄漏。
基本上就这些情况。这个事件很适合用来清理用户会话、记录下线日志或更新在线状态。










