curl_multi_setopt
(PHP 5 >= 5.5.0, PHP 7)
curl_multi_setopt — Set an option for the cURL multi handle
Description
This function is currently not documented; only its argument list is available.
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 theoption
parameter:Option Set value
toCURLMOPT_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, the value is a bitmask, and you can also pass 2 to try to multiplex the new transfer over an existing HTTP/2 connection if possible. Passing 3 instructs cURL to ask for pipelining and multiplexing independently of each other. As of cURL 7.62.0, setting the pipelining bit has no effect. 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. CURLMOPT_PUSHFUNCTION
Pass a callable that will be registered to handle server pushes and should have the following signature: pushfunction ( resource$parent_ch
, resource$pushed_ch
, array$headers
) : int-
parent_ch
-
The parent cURL handle (the request the client made).
-
pushed_ch
-
A new cURL handle for the pushed request.
-
headers
-
The push promise headers.
CURL_PUSH_OK
if it can handle the push, orCURL_PUSH_DENY
to reject it. -
English translation
You have asked to visit this site in English. For now, only the interface is translated, but not all the content yet.If you want to help me in translations, your contribution is welcome. All you need to do is register on the site, and send me a message asking me to add you to the group of translators, which will give you the opportunity to translate the pages you want. A link at the bottom of each translated page indicates that you are the translator, and has a link to your profile.
Thank you in advance.
Document created the 30/01/2003, last modified the 26/10/2018
Source of the printed document:https://www.gaudry.be/en/php-rf-curl-multi-setopt.html
The infobrol is a personal site whose content is my sole responsibility. The text is available under CreativeCommons license (BY-NC-SA). More info on the terms of use and the author.
References
These references and links indicate documents consulted during the writing of this page, or which may provide additional information, but the authors of these sources can not be held responsible for the content of this page.
The author This site is solely responsible for the way in which the various concepts, and the freedoms that are taken with the reference works, are presented here. Remember that you must cross multiple source information to reduce the risk of errors.