# onClose
## 说明:
~~~
callback Worker::$onClose
~~~
当客户端连接与Workerman断开时触发的回调函数。不管连接是如何断开的,只要断开就会触发`onClose`。每个连接只会触发一次`onClose`。
注意:如果对端是由于断网或者断电等极端情况断开的连接,这时由于无法及时发送tcp的fin包给workerman,workerman就无法得知连接已经断开,也就无法及时触发`onClose`。这种情况需要通过应用层心跳来解决。workerman中连接的心跳实现参见[这里](http://doc.workerman.net/faq/heartbeat.html)。
由于udp是无连接的,所以当使用udp时不会触发onConnect回调,也不会触发onClose回调。
## 回调函数的参数
`$connection`
连接对象,即[TcpConnection实例](http://doc.workerman.net/tcp-connection.html),用于操作客户端连接,如[发送数据](http://doc.workerman.net/tcp-connection/send.html),[关闭连接](http://doc.workerman.net/tcp-connection/close.html)等
## 范例
~~~
$worker = new Worker('tcp://0.0.0.0:8484');
$worker->onClose = function($connection)
{
echo "connection closed\n";
};
// 运行worker
Worker::runAll();
~~~
提示:除了使用匿名函数作为回调,还可以[参考这里](http://doc.workerman.net/faq/callback_methods.html)使用其它回调写法。
- 序言
- 启动停止
- 简单的开发示例
- 性能测试
- 性能测试-数据库
- 通讯协议
- Coroutine类
- create
- getCid
- yield
- resume
- sleep
- wait
- getTotalNum
- isExist
- defer
- Runtime类
- Worker类
- 构造函数
- 属性
- workerId
- id
- name
- protocol
- transport
- reusePort
- backlog
- connections
- stdoutFile
- pidFile
- logFile
- user
- reloadable
- daemonize
- globalEvent
- 回调属性
- onWorkerStart
- onWorkerReload
- onConnect
- onMessage
- onClose
- onBufferFull
- onBufferDrain
- onError
- 方法
- rename
- runAll
- stopAll
- listen
- TcpConnection类
- 属性
- id
- protocol
- worker
- maxSendBufferSize
- defaultMaxSendBufferSize
- defaultMaxPackageSize
- 方法
- set
- send
- getRemoteIp
- getRemotePort
- close
- destroy
- pauseRecv
- resumeRecv
- pipe
- Timer定时器类
- add
- del
- 定时器注意事项
- Channel类
- 构造方法
- push
- pop
- length
- isEmpty()