EventBufferEvent::getDnsErrorString()函数—用法及示例

函数名：EventBufferEvent::getDnsErrorString()

函数描述：该函数用于获取最近一次 DNS 错误的错误消息。

适用版本：libevent 2.4.0 或以上版本

用法示例：

// 创建一个 EventBufferEvent 对象
$base = event_base_new();
$dns_base = event_dns_base_new($base, true);
$bev = EventBufferEvent::socketNew($base, -1, EventBufferEvent::OPT_CLOSE_ON_FREE);
$bev->setDnsBase($dns_base);

// 进行 DNS 解析
$address = "example.com";
if (!$bev->connectHost($dns_base, $address, 80, EventBufferEvent::OPT_CLOSE_ON_FREE)) {
    echo "DNS 解析失败：" . $bev->getDnsErrorString() . PHP_EOL;
}

// 获取最近一次 DNS 错误的错误消息
$errorString = $bev->getDnsErrorString();
if (!empty($errorString)) {
    echo "最近一次 DNS 错误的错误消息：" . $errorString . PHP_EOL;
} else {
    echo "没有 DNS 错误。" . PHP_EOL;
}

注意事项：

• 在使用该函数前，需先创建一个 EventBufferEvent 对象并与事件库关联。
• 本函数仅在 DNS 解析出错时才会有返回值，若最近一次 DNS 解析成功，则返回为空字符串。
• EventBufferEvent 类的相关操作需要 libevent 扩展库的支持，确保已正确安装和启用相关扩展。