PHP Conference Japan 2024

curl_pause

(PHP 5 >= 5.5.0, PHP 7, PHP 8)

curl_pause暂停和恢复连接

描述

curl_pause(CurlHandle $handle, int $flags): int

暂停或恢复 cURL 会话。可以通过从使用 curl_setopt() 注册的回调函数中调用此函数,在传输进行中暂停读取、写入或同时暂停读取和写入方向的会话。

参数

handle

curl_init() 返回的 cURL 句柄。

flags

CURLPAUSE_* 常量之一。

返回值

返回错误代码(无错误时为 CURLE_OK)。

变更日志

版本 描述
8.0.0 handle 现在期望一个 CurlHandle 实例;以前,期望一个 resource
添加注释

用户贡献的注释 1 条注释

Alex Autrey
11 年前
http://curl.haxx.se/libcurl/c/curl_easy_pause.html

使用此函数,您可以明确标记正在运行的连接以使其暂停,并且您可以恢复先前暂停的连接。

可以通过使用此函数或让读取或写入回调函数返回正确的魔术返回值(CURL_READFUNC_PAUSE 和 CURL_WRITEFUNC_PAUSE)来暂停连接。返回暂停的写入回调会向库发出信号,表明它根本无法处理任何数据,并且当稍后恢复写入时,这些数据将再次传递给回调函数。

注意:虽然可能看起来很诱人,但请注意,您不能从另一个线程调用此函数。

当调用此函数以恢复读取时,很可能在该函数返回之前会调用您的写入回调函数。

句柄参数当然是在识别对要暂停或恢复的连接进行操作的句柄。

位掩码参数是一组位,用于设置连接的新状态。可以使用以下位
To Top