curl_init

(PHP 4 >= 4.0.2, PHP 5, PHP 7, PHP 8)

curl_init — Inicializa uma sessão cURL

Descrição

curl_init(?string $url = null): CurlHandle|false

Inicializa uma nova sessão e retorna um identificador cURL para uso com as funções curl_setopt(), curl_exec(), e curl_close().

Parâmetros

url

Se fornecido, a opção CURLOPT_URL será definida com este valor. Esta opção pode ser definida manualmente usando a função curl_setopt().

Note:

O protocolo file é desativado no cURL se open_basedir estiver definido.

Valor Retornado

Retorna um identificador cURL em caso de sucesso, false em caso de erro.

Registro de Alterações

Versão Descrição
8.0.0 No caso de sucesso, a função retorna uma instância de CurlHandle; anteriormente retornava um resource.
8.0.0 url agora pode ser nulo.

Exemplos

Example #1 Inicializando uma nova sessão cURL e buscando uma página da web 

<?php
// Cria um novo identificador cURL
$ch = curl_init();

// Configura o URL e as opções
curl_setopt($ch, CURLOPT_URL, "http://www.example.com/");
curl_setopt($ch, CURLOPT_HEADER, 0);

// Obtém os dados
curl_exec($ch);

// Fecha o identificador cURL e libera recursos interos
curl_close($ch);
?>

Veja Também