curl_multi_add_handle

    (PHP 5, PHP 7, PHP 8)

    curl_multi_add_handle — cURL マルチハンドルに、通常の cURL ハンドルを追加する

    説明

    curl_multi_add_handle(CurlMultiHandle$multi_handle, CurlHandle$handle): int

    handle ハンドルを、マルチハンドル multi_handle に追加します。

    パラメータ

    multi_handle

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

    handle

    curl_init() が返す cURL ハンドル。

    戻り値

    成功した場合に 0、あるいはエラーコード CURLM_XXX のいずれかを返します。

    変更履歴

    バージョン説明
    8.0.0multi_handle は CurlMultiHandle クラスのインスタンスを期待するようになりました。 これより前のバージョンでは、resource を期待していました。
    8.0.0handle は 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/");
    curl_setopt($ch1, CURLOPT_HEADER, 0);
    curl_setopt($ch2, CURLOPT_URL, "http://www.php.net/");
    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);
    ?>

    参考

    To Top