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 (spécifié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 : Choisissez une valeur non nulle pour que CURL vous affiche tous les événements.
CURLOPT_HEADER : Choisissez une valeur non nulle pour que CURL inclut l'en-tête dans la valeur de retour.
CURLOPT_NOPROGRESS : Choisissez 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ébogage.
CURLOPT_NOBODY : Choisissez une valeur non nulle pour que le corps du transfert ne soit pas inclus dans la valeur de retour.
CURLOPT_FAILONERROR : Choisissez 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 : Choisissez une valeur non nulle pour que PHP prépare un chargement.
CURLOPT_POST : Choisissez 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 : Choisissez une valeur non nulle pour que PHP ne fasse que lister les noms d'un dossier FTP.
CURLOPT_FTPAPPEND : Choisissez une valeur non nulle pour que PHP concatène le fichier distant, plutôt que de l'écraser.
CURLOPT_NETRC : Choisissez une valeur non nulle pour que PHP analyse votre fichier ~./netrc et utilise votre nom de compte et mot de passe sur le site distant que vous souhaitez contacter.
CURLOPT_FOLLOWLOCATION : Choisissez une valeur non nulle pour suivre toutes les en-têtes "Location: " que le serveur envoie dans les en-têtes HTTP (notez que cette fonction est récursive et que PHP suivra toutes les en-têtes "Location: " qu'il trouvera).
CURLOPT_PUT : Choisissez 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 : Choisissez 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_TIME 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_CAINFO: Passez le nom d'un fichier contenant un ou plusieurs certificats pour vérifier la concordance. Celà n'a de sens que si vous l'utilisez en combinaison de l'option CURLOPT_SSL_VERIFYPEER.
CURLOPT_SSL_VERIFYPEER: Passez un entier long qui sera mis à 0 pour arrêter CURL de vérifier le certificat (CURL 7.10 démarre avec cette option à TRUE par défaut). Les certificats alternatifs peuvent être spécifiés avec l'option CURLOPT_CAINFO (ajouté dans CURL 7.9.8) ou un répertoire de certificat peut être spécifié avec l'option CURLOPT_CAPATH. Tout comme CURL 7.10, CURL installe un paquet par défaut. CURLOPT_SSL_VERIFYHOST doit aussi être positionnée à 1 ou 0 si CURLOPT_SSL_VERIFYPEER est désactivée (par défaut à 2).
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 lui-même, bien que dans certains cas, il vous faudra le faire manuellement.
CURLOPT_SSL_VERIFYHOST: Passez un entier "long" si CURL doit vérifier le nom "commun" du certificat dans une connexion SSL. Si vous spécifiez la valeur 1, nous vérifirons l'existence du nom commun, la valeur 2, nous nous assurerons qu'il correspond au nom d'hôte.
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ée.
CURLOPT_RETURNTRANSFER: Passez une valeur différente de zéro si vous voulez que CURL retourne directement le transfert au lieu de l'afficher.
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 valeur lors de l'appel à curl_init().
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 valeurs 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és 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'en-tête de "REFERER", utilisé lors d'une requête HTTP.
CURLOPT_USERAGENT : Passez une chaîne de caractères qui contient l'en-tê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'en-tê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 en-têtes HTTP écrits dans un fichier.
CURLOPT_CUSTOMREQUEST : Passez une chaîne de caractères qui sera utilisée à 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. Les valeurs valides sont GET, POST, et plus ; i.e. n'entrez pas une requête HTTP ici. Pour le moment, entrez 'GET /index.html HTTP/1.0\r\n\r\n' serait incorrect.
Note : N'utilisez pas cette commande sans vous assurer que le serveur l'accepte.
CURLOPT_PROXY: Donnez le nom du proxy HTTP au tunnel qui le demande.
CURLOPT_INTERFACE: Passez le nom de l'interface à utiliser. Celà peut être le nom d'une interface, une adresse IP ou encore le nom de l'hôte.
CURLOPT_KRB4LEVEL: Passez le degré de sécurité KRB4 (Kerberos 4). Chacune des valeurs (dans l'ordre du plus petit au plus grand) suivantes sont valides : 'clear', 'safe', 'confidential', 'private'. Si la chaîne passée ne correspond pas à une de ces valeurs, la valeur 'private' sera définie. Positionner cette valeur à NULL revient à désactiver la sécurité KRB4. Actuellement, la sécurité KRB4 se fonctionne uniquement avec les transaction FTP.
CURLOPT_HTTPHEADER: Passez un tableau d'en-têtes HTTP à positionner.
CURLOPT_QUOTE: Passez un tableau de commandes FTP à passer au serveur pour les requêtes FTP.
CURLOPT_POSTQUOTE: Passez un tableau de commandes FTP à exécuter sur le serveur, après que les requêtes FTP ne soient effectuées.
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'en-tête de la sortie du transfert.
CURLOPT_STDERR : Le fichier d'erreurs.
Précédent | Sommaire | Suivant |
curl_multi_select | Niveau supérieur | curl_version |