PHP 7.0.6 Released

    curl_multi_remove_handle

    (PHP 5, PHP 7)

    curl_multi_remove_handle — Remove a multi handle from a set of cURL handles

    Description

    int curl_multi_remove_handle ( resource $mh , resource $ch )

    Removes a given ch handle from the given mh handle. When the ch handle has been removed, it is again perfectly legal to run curl_exec() on this handle. Removing the ch handle while being used, will effectively halt the transfer in progress involving that handle.

    Parameters

    mh

    A cURL multi handle returned by curl_multi_init().

    ch

    A cURL handle returned by curl_init().

    Return Values

    Returns 0 on success, or one of the CURLM_XXX error codes.

    See Also

    User Contributed Notes

    mercury at caucasus dot net
    5 years ago
    It is always a good idea to use curl_close() on all individual curl handles after executing curl_multi_remove_handle(). This will free up additional memory resources. So, a typical code would look like:

    <?php
    $ch1     = curl_init();
    curl_setopt($ch1, CURLOPT_URL, 'http://www.example.com/');
    curl_setopt($ch1, CURLOPT_RETURNTRANSFER, true);

    $ch2 = curl_init();
    curl_setopt($ch2, CURLOPT_URL, 'http://www.example.net/');
    curl_setopt($ch2, CURLOPT_RETURNTRANSFER, true);

    $mh = curl_multi_init();

    curl_multi_add_handle($mh, $ch1);
    curl_multi_add_handle($mh, $ch2);

    $active = null;

    do {
    curl_multi_exec($mh, $active);
    }
    while(    $active);

    $res1 = curl_multi_getcontent($ch1);
    $res2 = curl_multi_getcontent($ch2);

    curl_multi_remove_handle($mh, $ch1);
    curl_multi_remove_handle($mh, $ch2);

    curl_multi_close($mh);

    curl_close($ch1);
    curl_close($ch2);
    ?>
    To Top