× 警告!旧版文档已经暂停维护,请查看新版文档。点击前往新版文档

Event::write

用于PHP自带stream/sockets扩展创建的socket,使用fwrite/socket_send等函数向对端发送数据。当发送的数据量较大,socket写缓存区已满,就会发送阻塞等待或者返回EAGAIN错误。

Event::write函数可以将stream/sockets资源的数据发送变成异步的,当缓冲区满了或者返回EAGAIN,swoole底层会将数据加入到发送队列,并监听可写。socket可写时swoole底层会自动写入。

use Swoole\Event;
$fp = stream_socket_client('tcp://127.0.0.1:9501');
$data = str_repeat('A', 1024 * 1024*2);

Event::add($fp, function($fp) {
     echo fread($fp);
});

Event::write($fp, $data);
  • Event::write不能用于SSL/TLS等有隧道加密的stream/sockets资源
  • Event::write操作成功后,会自动将该$socket设置为非阻塞模式
  • $data 发送数据的长度不得超过Socket缓存区尺寸

SOCKET缓存区已满后,Swoole的底层逻辑

持续写入SOCKET如果对端读取不够快,那SOCKET缓存区会塞满。swoole底层会将数据存到内存缓存区中,直到可写事件触发再写入SOCKET。

  • 可使用 Swoole\Async::set(或 swoole_async_set)方法动态设置 socket_buffer_size 值,更多参数见 Async
  • swoole老版本内存缓存区尺寸可以在通过修改php.ini 中的 swoole.socket_buffer_size 项进行配置,默认为8M

如果内存缓存区也被写满了,此时swoole底层会抛出pipe buffer overflow, reactor will block. 错误,并进入阻塞等待。

如果调用端希望不要阻塞,直接返回错误,可以使用swoole_async_set设置socket_dontwaittrue,write将不会阻塞而是直接返回false

缓存塞满返回false是原子操作,只会出现全部写入成功或者全部失败