array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'function.curl-setopt-array.php', 1 => 'curl_setopt_array', 2 => 'Define múltiplas opções para uma transferência cURL', ), 'up' => array ( 0 => 'ref.curl.php', 1 => 'Funções cURL', ), 'prev' => array ( 0 => 'function.curl-setopt.php', 1 => 'curl_setopt', ), 'next' => array ( 0 => 'function.curl-share-close.php', 1 => 'curl_share_close', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/curl/functions/curl-setopt-array.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

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

Exemplo #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);
?>

Notas

Nota:

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