curl_multi_select

(PHP 5, PHP 7, PHP 8)

curl_multi_selectWartet, bis Lesen oder Schreiben auf einer der cURL-Mehrfach-Handle-Verbindungen möglich ist

Beschreibung

curl_multi_select(CurlMultiHandle $multi_handle, float $timeout = 1.0): int

Blockiert die Ausführung des Skripts, bis ein cURL-Handle, das an das cURL-Mehrfach-Handle angehängt ist, in der Lage ist, beim nächsten Aufruf von curl_multi_exec() fortzufahren oder bis das Zeitlimit erreicht ist (je nachdem, was zuerst eintritt).

Parameter-Liste

multi_handle

Ein von curl_multi_init() zurückgegebenes cURL-Multihandle.

timeout

Zeit in Sekunden, die auf eine Antwort vom den aktiven cURL-Mehrfach-Handle-Verbindungen gewartet wird.

Rückgabewerte

Gibt bei erfolgreicher Ausführung die Anzahl der aktiven Bezeichner in der Bezeichner-Sammlung zurück. Dies kann 0 sein, wenn es bei keinem der Bezeichner eine Aktivität gab. Tritt ein Fehler auf, gibt diese Funktion -1 zurück, wenn die Auswahl (durch den zugrundeliegenden Systemaufrufs select()) fehlgeschlagen ist.

Fehler/Exceptions

Wenn timeout kleiner als 0 oder größer als PHP_INT_MAX ist, wird ein ValueError geworfen.

Changelog

Version Beschreibung
8.4.0 Wirft nun einen ValueError, wenn timeout kleiner als 0 oder größer als PHP_INT_MAX ist.
8.0.0 multi_handle erwartet nun eine CurlMultiHandle-Instanz; vorher wurde eine Ressource erwartet.

Siehe auch