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

# 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

function 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

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

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open