当前位置: 首页 > 文档资料 > WorkerMan 3.x 手册 >

回调属性 - onBufferFull

优质
小牛编辑
124浏览
2023-12-01

说明:

  1. callback Worker::$onBufferFull

每个连接都有一个单独的应用层发送缓冲区,缓冲区大小由TcpConnection::$maxSendBufferSize决定,默认值为1MB,可以手动设置更改大小,更改后会对所有连接生效。

该回调可能会在调用Connection::send后立刻被触发,比如发送大数据或者连续快速的向对端发送数据,由于网络等原因数据被大量积压在对应连接的发送缓冲区,当超过TcpConnection::$maxSendBufferSize上限时触发。

当发生onBufferFull事件时,开发者一般需要采取措施,例如停止向对端发送数据,等待发送缓冲区的数据被发送完毕(onBufferDrain事件)等。

当调用Connection::send($A)后导致触发onBufferFull时,不管本次send的数据$A多大,即使大于TcpConnection::$maxSendBufferSize,本次要发送的数据仍然会被放入发送缓冲区。也就是说发送缓冲区实际放入的数据可能远远大于TcpConnection::$maxSendBufferSize,当发送缓冲区的数据已经大于TcpConnection::$maxSendBufferSize时,仍然继续Connection::send($B)数据,则这次send的$B数据不会放入发送缓冲区,而是被丢弃掉,并触发onError回调。

总结来说,只要发送缓冲区还没满,哪怕只有一个字节的空间,调用Connection::send($A)肯定会把$A放入发送缓冲区,如果放入发送缓冲区后,发送缓冲区大小超过了TcpConnection::$maxSendBufferSize限制,则会触发onBufferFull回调。

回调函数的参数

$connection

连接对象

范例

  1. use WorkermanWorker;
  2. require_once __DIR__ . '/Workerman/Autoloader.php';
  3. $worker = new Worker('websocket://0.0.0.0:8484');
  4. $worker->onBufferFull = function($connection)
  5. {
  6. echo "bufferFull and do not send againn";
  7. };
  8. // 运行worker
  9. Worker::runAll();

参见

onBufferDrain 当连接的应用层发送缓冲区数据全部发送完毕时触发