curl_multi_setopt
Set an option for the cURL multi handle
&reftitle.description;
boolcurl_multi_setopt
resourcemh
intoption
mixedvalue
&warn.undocumented.func;
&reftitle.parameters;
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.
By default the size will be enlarged to fit four times the number
of handles added via curl_multi_add_handle.
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.
&reftitle.returnvalues;
&return.success;
&reftitle.changelog;
&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.