curl_copy_handle

(PHP 5, PHP 7, PHP 8)

curl_copy_handle — Copia um identificador cURL com todas as suas opções

Descrição

curl_copy_handle(CurlHandle $handle): CurlHandle|false

Copia um identificador cURL, mantendo as opções escolhidas.

Parâmetros

handle: Um manipulador cURL retornado por curl_init().

Valor Retornado

Retorna um novo identificador cURL, ou false em caso de falha.

Registro de Alterações

Versão	Descrição
8.0.0	O parâmetro `handle` agora espera uma instância de CurlHandle; anteriormente, um resource era esperado.
8.0.0	Em caso de sucesso, esta função agora retorna uma instância CurlHandle; anteriormente, um recurso do tipo resource era retornado.

Exemplos

Example #1 Copiando um identificador cURL

<?php
// Cria uma nova sessão cURL
$ch = curl_init();

// Configura uma URL e outras opções apropriadas
curl_setopt($ch, CURLOPT_URL, 'http://www.exemplo.com.br/');
curl_setopt($ch, CURLOPT_HEADER, 0);

// Copia o identificador
$ch2 = curl_copy_handle($ch);

// Executa a sessão (abrindo a página exemplo.com.br)
curl_exec($ch2);

// Fecha os recursos cURL
curl_close($ch2);
curl_close($ch);
?>