(PHP 5 >= 5.1.3, PHP 7, PHP 8)
curl_setopt_array — Fixe plusieurs options pour un transfert cURL
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().
handle
Un gestionnaire cURL retourné par curl_init().
optionsUn tableau spécifiant quelles options à fixer avec leurs valeurs. Les clés devraient être des constantes valides de curl_setopt() ou leur entier équivalent.
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.
| Version | Description |
|---|---|
| 8.0.0 |
handle attend désormais une instance de CurlHandle;
auparavant; une resource était attendue.
|
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);
?>
Note:
Avec la fonction curl_setopt(), le fait de passer un tableau comme valeur de la constante
CURLOPT_POSTfera 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.