curl_multi_setopt
(PHP 5 >= 5.5.0, PHP 7, PHP 8)
curl_multi_setopt — Setz eine Option für das cURL multi-Handle
Beschreibung
Diese Funktion ist bis jetzt nicht dokumentiert. Es steht nur die Liste der Argumente zur Verfügung.
Parameter-Liste
-
multi_handle -
-
option -
Eine der
CURLMOPT_*Konstanten. -
value -
Der zu
optionzu setzende Wert.valuesollte ein int sein für die folgenden Werte deroptionParameter:Option Set valuetoCURLMOPT_PIPELININGÜbergib 1 zum aktivieren oder 0 zum deaktivieren. Das Aktivieren von multi-Handles wird zu dem Versuch führen, PHP Pipelining so weit wie es für Transfers, die dieses Handle verwenden, möglich ist. Das bedeutet, dass wenn Sie eine zweite Anfrage hinzufügen, die eine bereits existierende Verbindung verwendet, wird diese auf der selben Verbindung "gepiped". Von cURL 7.43.0 an ist der Wert eine Bitmaske, und es kann ebenfalls 2 übergeben werden, um zu versuchen, den neuen Transfer über eine bestehende HTTP/2 Verbindung zu multiplexen, falls möglich. Das Übergeben von 3 weist cURL an, Pipelining und Multiplexing unabhängig voneinander zu versuchen. Von cURL 7.62.0 an hat das Setzen des Pipelining-Bit keine Wirkung. Anstelle der Interger-Literale können ebenfalls die CURLPIPE_* Konstanten verwendet werden, falls verfügbar. CURLMOPT_MAXCONNECTSÜbergeben Sie eine Zahl, die als die maximale Menge an gleichzeitig geöffneten Verbindungen verwendet wird, die libcurl zwischenspeichern kann. Standardmäßig wird die Anzahl erhöht, so dass viermal soviele Verbindungen zwischengespeichert werden können, wie Handles mit curl_multi_add_handle() hinzugefügt wurden. Wenn der Cache gefüllt ist, schließt cURL die älteste Verbindung im Cache, um das Anwachsen der offenen Verbindungen zu vermeiden. CURLMOPT_CHUNK_LENGTH_PENALTY_SIZEEine Zahl, die den Chunklängenschwellenwert für das Pipelining in Bytes angibt, ist zu übergeben. CURLMOPT_CONTENT_LENGTH_PENALTY_SIZEEine Zahl, die den Größenschwellenwert für das Pipelining in Bytes angibt, ist zu übergeben. CURLMOPT_MAX_HOST_CONNECTIONSEine Zahl, die die Höchstanzahl von Verbindungen zu einem einzelnen Host angibt, ist zu übergeben. CURLMOPT_MAX_PIPELINE_LENGTHEine Zahl, die die Höchstanzahl von Requests in einer Pipeline angibt, ist zu übergeben. CURLMOPT_MAX_TOTAL_CONNECTIONSEinze Zahl, die die Höchstanzahl von gleichzeitig offenen Verbindungen angibt, ist zu übergeben. CURLMOPT_PUSHFUNCTIONEin callable, das registriert wird, um Server-Pushs zu behandeln, ist zu übergeben; es sollte folgende Signatur haben: pushfunction(resource$parent_ch, resource$pushed_ch, array$headers): int-
parent_ch -
Das Eltern-cURL-Handle (der vom Client durchgeführte Request).
-
pushed_ch -
Ein neues cURL-Handle für den gepushten Request.
-
headers -
Die Push-Promise-Header.
CURL_PUSH_OK, falls es den Push behandeln kann, oderCURL_PUSH_DENY, um diesen zurückzuweisen, zurückgeben. -
Rückgabewerte
Gibt bei Erfolg true zurück. Bei einem Fehler wird false zurückgegeben.
Changelog
| Version | Beschreibung |
|---|---|
| 8.0.0 |
multi_handle erwartet nun eine
CurlMultiHandle-Instanz; vorher wurde eine
Ressource erwartet.
|
| 7.1.0 |
CURLMOPT_PUSHFUNCTION wurde eingeführt.
|
| 7.0.7 |
CURLMOPT_CHUNK_LENGTH_PENALTY_SIZE,
CURLMOPT_CONTENT_LENGTH_PENALTY_SIZE,
CURLMOPT_MAX_HOST_CONNECTIONS,
CURLMOPT_MAX_PIPELINE_LENGTH und
CURLMOPT_MAX_TOTAL_CONNECTIONS wurden eingeführt.
|

