大网数据广告活动
PHP 语言与运行手册

curl_upkeep · 执行连接保活检查

· 52CE 我爱测

某些协议具有"连接保活"机制。 这些机制通常会在现有连接上发送少量流量以保持连接活跃; 例如,这可以防止连接被过于严格的防火墙关闭。

curl_upkeep

(PHP 8 >= 8.2.0)

curl_upkeep — 执行连接保活检查

说明

function curl_upkeep(CurlHandle $handle): bool

需要使用 libcurl >= 7.62.0 构建才可用。

某些协议具有"连接保活"机制。 这些机制通常会在现有连接上发送少量流量以保持连接活跃; 例如,这可以防止连接被过于严格的防火墙关闭。

连接保活目前仅适用于 HTTP/2 连接。 通常会发送少量流量来保持连接活跃。 HTTP/2 通过发送 HTTP/2 PING 帧来维持其连接。

参数

handle

由 curl_init() 返回的 cURL 句柄。

返回值

成功时返回 true, 或者在失败时返回 false。

示例

示例 #1 curl_upkeep() 示例

<?php
$url = "https://example.com";

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTP_VERSION,CURL_HTTP_VERSION_2_0);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
curl_setopt($ch, CURLOPT_UPKEEP_INTERVAL_MS, 200);
if (curl_exec($ch)) {
    usleep(300);
    var_dump(curl_upkeep($ch));
}
?>

参见

来源:PHP Documentation Group · 作者与贡献记录 · CC BY 3.0。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
PHP Documentation Group
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY 3.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。