(PHP 5 >= 5.5.0, PHP 7)
curl_multi_setopt — Set an option for the cURL multi handle
This function is currently not documented; only its argument list is available.
mh
option
One of the CURLMOPT_*
constants.
value
The value to be set on option
.
value
should be an int for the
following values of the option
parameter:
Option | Set value to |
---|---|
CURLMOPT_PIPELINING |
Pass 1 to enable or 0 to disable. Enabling pipelining on a multi handle will make it attempt to perform HTTP Pipelining as far as possible for transfers using this handle. This means that if you add a second request that can use an already existing connection, the second request will be "piped" on the same connection. As of cURL 7.43.0 you can also pass 2 to try to multiplex the new transfer over an existing HTTP/2 connection if possible. Instead of integer literals, you can also use the CURLPIPE_* constants if available. |
CURLMOPT_MAXCONNECTS |
Pass a number that will be used as the maximum amount of simultaneously open connections that libcurl may cache. Default is 10. When the cache is full, curl closes the oldest one in the cache to prevent the number of open connections from increasing. |
CURLMOPT_CHUNK_LENGTH_PENALTY_SIZE |
Pass a number that specifies the chunk length threshold for pipelining in bytes. |
CURLMOPT_CONTENT_LENGTH_PENALTY_SIZE |
Pass a number that specifies the size threshold for pipelining penalty in bytes. |
CURLMOPT_MAX_HOST_CONNECTIONS |
Pass a number that specifies the maximum number of connections to a single host. |
CURLMOPT_MAX_PIPELINE_LENGTH |
Pass a number that specifies the maximum number of requests in a pipeline. |
CURLMOPT_MAX_TOTAL_CONNECTIONS |
Pass a number that specifies the maximum number of simultaneously open connections. |
Returns TRUE
on success or FALSE
on failure.
Version | Description |
---|---|
7.0.7 |
Introduced CURLMOPT_CHUNK_LENGTH_PENALTY_SIZE ,
CURLMOPT_CONTENT_LENGTH_PENALTY_SIZE ,
CURLMOPT_MAX_HOST_CONNECTIONS ,
CURLMOPT_MAX_PIPELINE_LENGTH and
CURLMOPT_MAX_TOTAL_CONNECTIONS .
|