array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ja', ), 'this' => array ( 0 => 'function.curl-multi-select.php', 1 => 'curl_multi_select', 2 => '任意の cURL マルチハンドル接続で読み取りまたは書き込みが可能になるまで待機する', ), 'up' => array ( 0 => 'ref.curl.php', 1 => 'cURL 関数', ), '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' => 'ja', '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 — 任意の cURL マルチハンドル接続で読み取りまたは書き込みが可能になるまで待機する

説明

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

スクリプトの実行をブロックし、次の curl_multi_exec() の呼び出しで cURL マルチハンドルに関連付けられた cURL ハンドルが処理を進められるようになるか、 タイムアウトになるまで待機します（どちらか早い方が適用されます）。

パラメータ

multi_handle

curl_multi_init() が返す cURL マルチハンドル。

timeout

アクティブな cURL マルチハンドル接続からのレスポンスを待機する時間（秒単位）。

戻り値

成功した場合は、記述子セットに含まれるアクティブな記述子の数を返します。 どの記述子上にもアクティビティがなかった場合は、結果が 0 になることもあります。 (select() システムコールから) select に失敗した場合は -1 を返します。

エラー / 例外

timeout が 0 未満または PHP_INT_MAX を超える場合、ValueError をスローします。

変更履歴

バージョン 説明
8.4.0 timeout が 0 未満または PHP_INT_MAX を超える場合、ValueError をスローするようになりました。
8.0.0 multi_handle は CurlMultiHandle クラスのインスタンスを期待するようになりました。 これより前のバージョンでは、resource を期待していました。

参考