# onConnect ## 说明: ~~~ callback Worker::$onConnect ~~~ 当客户端与Workerman建立连接时(TCP三次握手完成后)触发的回调函数。每个连接只会触发一次`onConnect`回调。 注意：onConnect事件仅仅代表客户端与Workerman完成了TCP三次握手，这时客户端还没有发来任何数据，此时除了通过`$connection->getRemoteIp()`获得对方ip，没有其他可以鉴别客户端的数据或者信息，所以在onConnect事件里无法确认对方是谁。要想知道对方是谁，需要客户端发送鉴权数据，例如某个token或者用户名密码之类，在[onMessage回调](http://doc.workerman.net/worker/on-message.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->onConnect = function($connection) { echo "new connection from ip " . $connection->getRemoteIp() . "\n"; }; // 运行worker Worker::runAll(); ~~~ 提示：除了使用匿名函数作为回调，还可以[参考这里](http://doc.workerman.net/faq/callback_methods.html)使用其它回调写法。