curl_multi_add_handle
(PHP 5, PHP 7)
curl_multi_add_handle — cURL マルチハンドルに、通常の cURL ハンドルを追加する
説明
curl_multi_add_handle
( CurlMultiHandle $multi_handle
, CurlHandle $handle
) : int
handle ハンドルを、マルチハンドル
multi_handle に追加します。
返り値
成功した場合に 0、あるいはエラーコード
CURLM_XXX のいずれかを返します。
変更履歴
| バージョン | 説明 |
|---|---|
| 8.0.0 | multi_handle は CurlMultiHandle クラスのインスタンスを期待するようになりました。
これより前のバージョンでは、resource を期待していました。 |
| 8.0.0 | handle は CurlHandle クラスのインスタンスを期待するようになりました。
これより前のバージョンでは、resource を期待していました。 |
例
例1 curl_multi_add_handle() の例
この例は、ふたつの cURL ハンドルを作成し、それをマルチハンドルに追加して非同期で実行します。
<?php// cURL リソースを作成します$ch1 = curl_init();$ch2 = curl_init();// URL およびその他適切なオプションを設定します。curl_setopt($ch1, CURLOPT_URL, "http://www.example.com/%22);curl_setopt($ch1, CURLOPT_HEADER, 0);curl_setopt($ch2, CURLOPT_URL, "http://www.php.net/%22);curl_setopt($ch2, CURLOPT_HEADER, 0);// マルチ cURL ハンドルを作成します$mh = curl_multi_init();// ふたつのハンドルを追加しますcurl_multi_add_handle($mh,$ch1);curl_multi_add_handle($mh,$ch2);// ハンドルを実行しますdo { $status = curl_multi_exec($mh, $active); if ($active) { curl_multi_select($mh); }} while ($active && $status == CURLM_OK);// すべてのハンドルを閉じますcurl_multi_remove_handle($mh, $ch1);curl_multi_remove_handle($mh, $ch2);curl_multi_close($mh);?>
参考
- curl_multi_remove_handle() - cURL ハンドルのセットからマルチハンドルを削除する
- curl_multi_init() - 新規 cURL マルチハンドルを返す
- curl_init() - cURL セッションを初期化する
