curl_multi_add_handle

(PHP 5)

curl_multi_add_handle — Add a normal cURL handle to a cURL multi handle

Description

int curl_multi_add_handle ( resource $mh , resource $ch )

Adds the ch handle to the multi handle mh

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 errors code.

Examples

Example #1 curl_multi_add_handle() example

This example will create two cURL handles, add them to a multi handle, and then run them in parallel.


<?php

// create both cURL resources

$ch1 = curl_init();

$ch2 = curl_init();



// set URL and other appropriate options

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);



//create the multiple cURL handle

$mh = curl_multi_init();



//add the two handles

curl_multi_add_handle($mh,$ch1);

curl_multi_add_handle($mh,$ch2);



$running=null;

//execute the handles

do {

    curl_multi_exec($mh,$running);

} while($running > 0);



//close all the handles

curl_multi_remove_handle($ch1);

curl_multi_remove_handle($ch2);

curl_multi_close($mh);

?>

curl_multi_add_handle

Description

Parameters

Return Values

Examples

See Also