curl_init

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

curl_initInicializar 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 fornecida, a opção CURLOPT_URL será definida com seu valor.Você pode definir isso manualmente usando a função curl_setopt().

Nota:

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

Valor Retornado

Retorna um identificador cURL em caso de sucesso, false sobre erros.

Registro de Alterações

VersãoDescrição
8.0.0 No caso de sucesso, a função retorna uma instância de CurlHandle; anteriormente era retornado um resource.
8.0.0url agora permite null.

Exemplos

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

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

// Configura a URL e 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 recurso cURL e libera recursos interos
curl_close($ch);
?>

Veja Também

To Top