curl_copy_handle

Copy a cURL handle along with all of its preferences

&reftitle.description; ``CurlHandle``false```curl_copy_handle` `CurlHandle` `handle`

Copies a cURL handle keeping the same preferences.

&reftitle.parameters;

&curl.ch.description;
&reftitle.returnvalues;

Returns a new cURL handle, &return.falseforfailure;.

&reftitle.changelog;

&Version; | &Description;
&curl.changelog.handle-param;
8.0.0 | On success, this function returns a `CurlHandle` instance now; previously, a `resource` was returned.

&reftitle.examples;

### Copying a cURL handle

    <?php
    // create a new cURL resource
    $ch = curl_init();

    // set URL and other appropriate options
    curl_setopt($ch, CURLOPT_URL, 'http://www.example.com/');
    curl_setopt($ch, CURLOPT_HEADER, 0);

    // copy the handle
    $ch2 = curl_copy_handle($ch);

    // grab URL (http://www.example.com/) and pass it to the browser
    curl_exec($ch2);

    // close cURL resources, and free up system resources
    curl_close($ch2);
    curl_close($ch);
    ?>