curl_setopt_array

(PHP 5 >= 5.1.3, PHP 7, PHP 8)

curl_setopt_array — Define múltiplas opções para uma transferência cURL

Descrição

curl_setopt_array(CurlHandle $handle, array $options): bool

Define múltiplas opções para uma sessão cURL. Esta função é útil para definir um alto número de opções cURL sem chamar repetidas vezes a função curl_setopt().

Parâmetros

handle: Um manipulador cURL retornado por curl_init().
options: Um array especificando que opções serão definidas e seus valores. As chaves devem ser constantes válidas da função curl_setopt() ou suas equivalentes em número inteiro.

Valor Retornado

Retorna true se todas as opções forem definidas com sucesso. Se uma opção não puder ser definida com sucesso, false é retornado imediatamente, ignorando quaisquer opções posteriores do array options.

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.

Exemplos

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

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

// define URL e outras opções apropriadas
$options = array(CURLOPT_URL => 'http://www.example.com/',
                 CURLOPT_HEADER => false
                );

curl_setopt_array($ch, $options);

// captura a URL e passa ao navegador
curl_exec($ch);

// fecha o identificador cURL, liberando recursos do sistema
curl_close($ch);
?>

Notas

Note:
Assim como a função curl_setopt(), passar um array em CURLOPT_POST irá codificar os dados como multipart/form-data, enquanto que passar uma string codificada como URL irá codificar os dados como application/x-www-form-urlencoded.

Veja Também

curl_setopt() - Define uma opção para uma transferência cURL