array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'en', ), 'this' => array ( 0 => 'function.curl-multi-select.php', 1 => 'curl_multi_select', 2 => 'Wait until reading or writing is possible for any cURL multi handle connection', ), 'up' => array ( 0 => 'ref.curl.php', 1 => 'cURL Functions', ), 'prev' => array ( 0 => 'function.curl-multi-remove-handle.php', 1 => 'curl_multi_remove_handle', ), 'next' => array ( 0 => 'function.curl-multi-setopt.php', 1 => 'curl_multi_setopt', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'en', 'path' => 'reference/curl/functions/curl-multi-select.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

curl_multi_select

(PHP 5, PHP 7, PHP 8)

curl_multi_select — Wait until reading or writing is possible for any cURL multi handle connection

Description

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

Blocks the execution of the script until a cURL handle attached to the cURL multi handle would be able to make progress on the next call to curl_multi_exec() or until the timeout strikes (whichever comes first).

Parameters

multi_handle

A cURL multi handle returned by curl_multi_init().

timeout

Time, in seconds, to wait for a response from the active cURL multi handle connections.

Return Values

On success, returns the number of active descriptors contained in the descriptor sets. This may be 0 if there was no activity on any of the descriptors. On failure, this function will return -1 on a select failure (from the underlying select() system call).

Errors/Exceptions

Throws a ValueError if timeout is less than 0 or greater than PHP_INT_MAX.

Changelog

Version Description
8.4.0 Now throws a ValueError if timeout is less than 0 or greater than PHP_INT_MAX.
8.0.0 multi_handle expects a CurlMultiHandle instance now; previously, a resource was expected.

See Also