curl_setopt() fixe les options de transfert de la session CURL identifiée par ch. option est le nom de l'option à fixer, et value est sa valeur.
value doit être de type "long" pour les options suivantes (specifiée par option) :
CURLOPT_INFILESIZE: Lorsque vous téléchargez un fichier sur un site distant, cette option sert à indiquer à PHP la taille maximale du fichier attendu.
CURLOPT_VERBOSE: Choississez une valeur non nulle pour que CURL vous affiche tous les événements.
CURLOPT_HEADER: Choississez une valeur non nulle pour que CURL inclus l'entête dans la valeur de retour.
CURLOPT_NOPROGRESS: Choississez une valeur non nulle pour que PHP n'affiche pas l'état des transferts CURL.
Note : PHP choisit automatiquement une valeur non nulle. Ne changez cette valeur que le temps du débuggage.
CURLOPT_NOBODY: Choississez une valeur non nulle pour que le corps du transfert ne soit pas inclus dans la valeur de retour.
CURLOPT_FAILONERROR: Choississez une valeur non nulle pour que PHP traite silencieusement les codes HTTP supérieurs à 300. Le comportement par défaut est de retourner la page normalement, en ignorant ce code.
CURLOPT_UPLOAD: Choississez une valeur non nulle pour que PHP prépare un chargement.
CURLOPT_POST: Choississez une valeur non nulle pour que PHP fasse un HTTP POST. Un POST est un encodage normal "application/x-www-from-url", utilisé couramment par les formulaires HTML.
CURLOPT_FTPLISTONLY: Choississez une valeur non nulle pour que PHP ne fasse que lister les noms d'un dossier FTP.
CURLOPT_FTPAPPEND: Choississez une valeur non nulle pour que PHP concatène le fichier distant, plutôt que de l'écraser.
CURLOPT_NETRC: Choississez une valeur non nulle pour que PHP scanne votre fichier ~./netrc et utilise votre nom de compte et mot de passe sur le site distant que vous souhaitez contacter.
CURLOPT_FOLLOWLOCATION: Choississez une valeur non nulle pour suivre toutes les entêtes "Location: " que le serveur envoie dans les entêtes HTTP (notez que cette fonction est récursive, et que PHP suivra toutes les entêtes "Location: " qu'il trouvera).
CURLOPT_PUT: Choississez une valeur non nulle pour que pour chargement se fasse par HTTP PUT. Le fichier à charger doit être fixé avec les options CURLOPT_INFILE et CURLOPT_INFILESIZE.
CURLOPT_MUTE: Choississez une valeur non nulle pour que PHP soit totalement silencieux concernant toutes les fonctions CURL.
CURLOPT_TIMEOUT: Passez un entier "long" comme paramètre qui représente le temps maximum d'exécution de la fonction CURL.
CURLOPT_LOW_SPEED_LIMIT: Passez un entier long qui représente la vitesse minimale en octets par secondes en dessous de laquelle, et pendant CURLOPT_LOW_SPEED secondes, PHP considèrera qu'elle est trop lente, et annulera le transfert.
CURLOPT_LOW_SPEED_TIME: Passez un entier "long" qui représente le temps en secondes, qui, si la vitesse de transfert reste en dessous de CURLOPT_LOW_SPEED_LIMIT, PHP considèrera que la connexion est trop lente, et l'annulera.
CURLOPT_RESUME_FROM: Passez un entier "long", qui représente l'offset, en octets, à partir duquel vous voulez commencer le transfert.
CURLOPT_SSLVERSION: Passez un entier "long" qui contient la version de SSL (2 ou 3) à utiliser. Par défaut, PHP essaiera de le déterminer par lui-même, bien que dans certains cas, il vous faudra le faire manuellement.
CURLOPT_TIMECONDITION: Passez un entier "long" qui définit comment CURLOPT_TIMEVALUE est utilisé. Vous pouvez choisir entre les valeurs TIMECOND_IFMODSINCE ou TIMECOND_ISUNMODSINCE. C'est une fonctionnalité HTTP.
CURLOPT_TIMEVALUE: Passez un entier "long" qui représente le temps en secondes depuis le 1er janvier 1970. Cette valeur sera utilisée comme spécifié dans l'option CURLOPT_TIMEVALUE. Par défaut, TIMECOND_IFMODSINCE sera utilisé.
value doit être une chaîne de caractères pour les valeurs suivantes de option
CURLOPT_URL: L'URL que PHP va récupérer. Vous pouvez aussi choisir cette v aleur lors de l'appel à curl_init(). function.
CURLOPT_USERPWD: Passez une chaîne de caractères au format [nom]:[mot de passe], pour que PHP l'utilise lors de la connexion.
CURLOPT_PROXYUSERPWD: Passez une chaîne de caractères au format [nom]:[mot de passe ], pour que PHP l'utilise lors de la connexion à un proxy HTTP.
CURLOPT_RANGE: Passez une chaîne de caractères qui représente la plage de valeur que vous désirez. Elle est au format "X-Y", où les valeurs de X ou Y peuvent être omises. Le transfert HTTP supporte aussi plusieurs intervalles, séparé par des virgules : X-Y,N-M.
CURLOPT_POSTFIELDS: Passez une chaîne de caractères qui contient toutes les données à passer lors d'une opération de HTTP POST.
CURLOPT_REFERER: Passez une chaîne de caractères qui contient l'entête de "REFERER", utilisé lors d'une requête HTTP.
CURLOPT_USERAGENT: Passez une chaîne de caractères qui contient l'entête "user-agent" utilisé dans une requête HTTP.
CURLOPT_FTPPORT: Passez une chaîne de caractères qui désignera l'adresse IP utilisée pour l'instruction FTP "PORT". L'instruction POST indique au serveur distant de se connecter cette adresse IP. La chaîne peut être une adresse IP, un nom d'hôte, un nom d'interface réseau (sous UNIX), ou juste '-', pour utiliser les IP par défaut du système.
CURLOPT_COOKIE: Passez une chaîne de caractères qui contiendra le contenu du cookie, à transmettre dans l'entête HTTP.
CURLOPT_SSLCERT: Passez une chaîne de caractères qui contiendra le nom de fichier du certificat, au format PEM.
CURLOPT_SSLCERTPASSWD: Passez une chaîne de caractères qui contient le mot de passe nécessaire pour utiliser le certificat CURLOPT_SSLCERT.
CURLOPT_COOKIEFILE: Passez une chaîne de caractères qui contiendra le nom du fichier contenant les données de cookie. Le fichier de cookie peut être au format Netscape, ou simplement des entêtes HTTP écrites dans un fichier.
CURLOPT_CUSTOMREQUEST: Passez une chaîne de caractères qui sera utilisé à la place de GET ou HEAD lors des requêtes HTTP. Cette commande est pratique pour effectuer un DELETE, ou une autre commande HTTP exotique.
Note : N'utilisez pas cette commande sans vous assurer que le serveur l'accepte.
Les options suivantes requièrent un pointeur de fichier, qui est obtenu avec la fonction fopen() :
CURLOPT_FILE: Le fichier de sortie de votre transfert. Par défaut, STDOUT.
CURLOPT_INFILE: Le fichier d'entrée de votre transfert.
CURLOPT_WRITEHEADER: Le fichier de destination de l'entête de la sortie du transfert.
CURLOPT_STDERR: Le fichier d'erreurs.
Précédent | Sommaire | Suivant |
curl_init | Niveau supérieur | curl_exec |