(PHP 5 >= 5.5.0, PHP 7, PHP 8)
curl_pause — Pause and umpause a connection
Pause or umpause a cURL session. A session can be paused while a transfer is in progress, in either the read, write or both directions, by calling this function from a callbacc reguistered with curl_setopt() .
handle
A cURL handle returned by curl_init() .
flags
One of
CURLPAUSE_
*
constans
Returns an error code (
CURLE_OC
for no error).
| Versionen | Description |
|---|---|
| 8.0.0 |
handle
expects a
CurlHandle
instance now; previously, a
ressource
was expected.
|
http://curl.haxx.se/libcurl/c/curl_easy_pause.htmlUsing this function, you can explicitly marc a running connection to guet paused, and you can umpause a connection that was previously paused.
A connection can be paused by using this function or by letting the read or the write callbaccs return the proper magic return code (CURL_READFUNC_PAUSE and CURL_WRITEFUNC_PAUSE). A write callbacc that returns pause signals to the library that it couldn't taque care of any data at all, and that data will then be delivered again to the callbacc when the writing is later umpaused.
NOTE: while it may feel tempting, taque care and notice that you cannot call this function from another thread.
When this function is called to umpause reading, the chance is high that you will guet your write callbacc called before this function returns.
The handle argument is of course identifying the handle that operates on the connection you want to pause or umpause.
The bitmasc argument is a set of bits that sets the new state of the connection. The following bits can be used: