# curl_setopt_array

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

curl_setopt_array — Fixe plusieurs options pour un transfert cURL

### Description

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

Fixe plusieurs options pour une session cURL. Cette fonction est utile pour configurer un grand nombre d'options cURL sans appeler à chaque fois curl_setopt().

### Liste de paramètres

`handle`

  Un gestionnaire cURL retourné par curl_init().

`options`

  Un tableau spécifiant quelles options à fixer avec leurs valeurs. Les clés devraient être des constantes valides de curl_setopt() ou leur entier équivalent.

### Valeurs de retour

Retourne `true` si toutes les options ont été fixées correctement. Si une option ne peut pas être fixée correctement, `false` est retourné immédiatement, en ignorant toutes les options futures dans le tableau `options`.

### Historique

Version | Description
--- | ---
8.0.0 | `handle` attend désormais une instance de CurlHandle; auparavant; une resource était attendue.

### Exemples

Exemple #1 Initialisation d'une nouvelle session cURL et récupération d'une page web

`<?php
// crée une nouvelle ressource cURL
$ch = curl_init();
// fixe l'URL et les autres options appropriées
$options = array(CURLOPT_URL => 'http://www.example.com/',
CURLOPT_HEADER => false
);
curl_setopt_array($ch, $options);
// attrape l'URL et la passe au navigateur
curl_exec($ch);
// ferme la ressource cURL et libère les ressources systèmes
curl_close($ch);
?>`

### Notes

> Note:

> Avec la fonction curl_setopt(), le fait de passer un tableau comme valeur de la constante `CURLOPT_POST` fera que les données seront encodées comme multipart/form-data, tandis que le fait de passer une chaîne encodée URL fera que les données seront encodées comme application/x-www-form-urlencoded.

### Voir aussi

- curl_setopt() - Définit une option de transmission cURL