CURL_SETOPT |
cURL : Fixe l'option |
|---|---|
| PHP 4.0.2+ | Extension CURL |
Syntaxe
| function curl_setopt($ch, $option , $value); |
Paramètres
| Nom | Description | |
|---|---|---|
| $ch | Ce paramètre permet d'indiquer l'identificateur de session cURL. | |
| $option | Ce paramètre permet d'indiquer l'option a attribué à cURL : | |
| Constante | Description | |
| CURLOPT_AUTOREFERER | Cette constante permet d'indiquer s'il faut automatiquement spécifié le champ référé dans une redirection (TRUE) ou non (FALSE). | |
| CURLOPT_BINARYTRANSFER | Cette constante permet d'indiquer s'il faut retourner les données brutes lorsque l'option CURLOPT_RETURNTRANSFER est utilisé (TRUE) ou non (FALSE). | |
| CURLOPT_COOKIESESSION | Cette constante permet d'indiquer s'il faut marquer les nouveaux «COOKIE» de session (TRUE) ou non (FALSE). | |
| CURLOPT_CERTINFO | Cette constante permet d'indiquer s'il faut envoyer les informations de certification SSL vers le STDERR pour les transaction sécurisé (TRUE) ou non (FALSE). | |
| CURLOPT_CONNECT_ONLY | Cette constante permet d'indiquer s'il faut uniquement envoyer les informations d'authentification et de connexion au proxy sans aucune autres données. | |
| CURLOPT_CRLF | Cette constante permet de convertir les saut de ligne de style UNIX en saut de ligne CRLF. | |
| CURLOPT_DNS_USE_GLOBAL_CACHE | Cette constante permet d'indiquer qu'il faut utiliser le cache du DNS global. ATTENTION ! Cette option n'est pas supporté par les processus léger. | |
| CURLOPT_FAILONERROR | Cette constante permet d'indiquer qu'il faut ajouter des traces lorsque les codes HTTP sont supérieur ou égale à 400. | |
| CURLOPT_FILETIME | Cette constante permet d'indiquer qu'il faut demander la date de modification du document à distance. | |
| CURLOPT_FOLLOWLOCATION | Cette constante permet d'indiquer qu'il faut tenir compte des «Location:» envoyer dans les entêtes HTTP ou HTTPS afin d'effectuer les redirections si nécessaires. | |
| CURLOPT_FORBID_REUSE | Cette constante permet de terminer la connexion immédiatement après que le processus soit terminé et aucun mise mise en cache ne peut être possible. | |
| CURLOPT_FRESH_CONNECT | Cette constante permet d'indiquer qu'il faut utiliser une nouvelle connexion et une étant gérer par un système de cache. | |
| CURLOPT_FTP_USE_EPRT | Cette constante permet d'employer l'EPRT et LPRT pendant l'activation des téléchargements par FTP (TRUE) ou sinon (FALSE) pour la désactivation de l'EPRT et LPRT de façon à n'utiliser que le PORT. | |
| ... | ... | |
| $value | Ce paramètre permet d'indiquer la valeur de l'option a attribué à cURL. | |
Retour
| Valeur | Description |
|---|---|
| FALSE | Cette valeur permet d'indiquer qu'une erreur s'est produite. |
| TRUE | Cette valeur permet d'indiquer que l'opération s'est correctement effectué. |
Description
Cette fonction permet de fixer les options de transmission d'une session CURL.
Remarque
- Si vous êtes sur le même serveur, il est beaucoup plus efficace d'utiliser les fonctions include, include_once, require ou require_once plutôt que «cURL». Ainsi, si le code de votre page HTML est situé sur plusieurs serveurs différents, faites attentions de ne pas tomber dans une architecture en spaghetti, aussi surnommé «Architecture GOTO».
Exemple
Voici un exemple montrant comment lire la page «http://www.gladir.com/a» :
- <?php
- function curl_getfilecontents($URL) {
- $curl = curl_init();
- curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
- curl_setopt($curl, CURLOPT_FOLLOWLOCATION, 1);
- curl_setopt($curl, CURLOPT_URL, $URL);
- curl_setopt($curl, CURLOPT_CONNECTTIMEOUT, 10);
- curl_setopt($curl, CURLOPT_TIMEOUT, 20);
- $contents = curl_exec($curl);
- $Result = curl_getinfo($curl,CURLINFO_HTTP_CODE);
- curl_close($curl);
- if(($contents) && ($Result == 200)) return $contents;
- else return false;
- }
-
- echo curl_getfilecontents("http://www.gladir.com/a");
- ?>
on obtiendra le résultat suivant :
Voir également
Système d'exploitation - Linux - Références de commandes et de programmes - curl
Dernière mise à jour : Mercredi, le 25 mars 2015