EventUtil::setSocketOption()函数—用法及示例

函数名：EventUtil::setSocketOption()

适用版本：PHP 5 >= 5.4.0, PECL libevent >= 0.0.1

用法：EventUtil::setSocketOption(resource $socket, int $level, int $optname, mixed $optval)

该函数用于设置套接字选项。它可以用于设置与套接字相关的不同选项，例如调整接收和发送缓冲区大小，启用非阻塞模式，设置超时等。

参数：

• $socket：套接字资源，使用 event_buffer_socket_new() 或 event_buffer_ssl_socket_new() 创建。
• $level：选项所在的协议级别。通常是 SOL_SOCKET。
• $optname：选项的名称，如 SO_RCVBUF、SO_RCVTIMEO 等。
• $optval：选项的值。根据选项不同，可以是 int、bool 或 string 类型。

返回值：设置成功返回 TRUE，设置失败返回 FALSE。

示例：

$base = new EventBase();
$socket = stream_socket_server('tcp://localhost:8000', $errno, $errstr);
stream_set_blocking($socket, 0);

$event = new Event($base, $socket, Event::READ | Event::PERSIST, function($socket, $flag, $base) {
    // 读取客户端发送的数据
    $clientSocket = stream_socket_accept($socket);
    $data = fread($clientSocket, 1024);
    echo "Received data: " . $data . PHP_EOL;
    
    // 设置 SO_RCVTIMEO 选项，接收超时时间为 5 秒
    EventUtil::setSocketOption($clientSocket, SOL_SOCKET, SO_RCVTIMEO, 5);
    
    // 继续监听客户端数据
    Event::add($base, $socket, Event::READ | Event::PERSIST, $base->func, $base);
});

// 开始事件循环
$base->loop();

上述示例创建了一个 TCP 服务器，并使用 EventUtil::setSocketOption() 设置了 SO_RCVTIMEO 选项，将接收超时时间设置为 5 秒。这样，在调用 fread() 函数时，如果 5 秒内没有接收到数据，将会超时返回。通过使用该函数，可以根据实际需求调整套接字的不同选项，并对网络通信进行更加灵活的控制。