Liste de param�tres

ch

Un gestionnaire cURL retourn� par la fonction curl_init().

option

L'option CURLOPT_XXX � d�finir.

value

La valeur � d�finir pour option .

value doit �tre un bool�en pour les valeurs suivantes du param�tre option :

Option	D�finissez le param�tre value �	Notes
CURLOPT_AUTOREFERER	TRUE pour sp�cifier automatiquement le champ Referer: dans les requ�tes o� une redirection Location: suit.
CURLOPT_BINARYTRANSFER	TRUE pour retourner les donn�es brutes (donn�es binaires) lorsque CURLOPT_RETURNTRANSFER est utilis�.
CURLOPT_COOKIESESSION	TRUE pour marquer ceci comme un nouveau cookie "session". Cela forcera libcurl � ignorer tous les cookies qui sont pr�ts � �tre charg�s qui sont des "cookies de session" provenant des sessions ant�rieures. Par d�faut, libcurl enregistre et charge toujours tous les cookies, ind�pendamment s'ils sont des cookies de session ou pas. Les cookies de session sont des cookies sans date d'expiration et existeront que pour cette "session" seulement.
CURLOPT_CRLF	TRUE pour convertir les nouvelles lignes Unix en nouvelles lignes CRLF pendant le transfert.
CURLOPT_DNS_USE_GLOBAL_CACHE	TRUE pour utiliser un cache DNS global. Cette option n'est pas compatible avec les threads et est activ�e par d�faut.
CURLOPT_FAILONERROR	TRUE pour que PHP traite silencieusement les codes HTTP sup�rieurs ou �gaux � 400. Le comportement par d�faut est de retourner la page normalement, en ignorant ce code.
CURLOPT_FILETIME	TRUE pour tenter de r�cup�rer la date de modification du document distant. Vous pouvez �galement retrouver cette valeur en utilisant l'option CURLINFO_FILETIME avec curl_getinfo().
CURLOPT_FOLLOWLOCATION	TRUE 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 � moins que CURLOPT_MAXREDIRS ne soit d�finie).
CURLOPT_FORBID_REUSE	TRUE pour forcer la connexion � se fermer explicitement lorsque le processus est termin� et ne sera pas mise en cache pour �tre r�utilis�e.
CURLOPT_FRESH_CONNECT	TRUE pour forcer � utiliser une nouvelle connexion au lieu de celle en cache.
CURLOPT_FTP_USE_EPRT	TRUE pour utiliser EPRT (et LPRT) lors de l'activation des t�l�chargements FTP. Utilisez FALSE pour d�sactiver EPRT et LPRT et ainsi, n'utiliser que PORT.
CURLOPT_FTP_USE_EPSV	TRUE pour tenter tout d'abord une commande EPSV pour les transferts FTP avant de revenir � une commande PASV. D�finissez cette option � FALSE pour d�sactiver EPSV.
CURLOPT_FTPAPPEND	TRUE pour que PHP ajoute les informations au fichier distant, plut�t que de l'�craser.
CURLOPT_FTPASCII	Un alias de CURLOPT_TRANSFERTEXT. Utilisez celui-l� � la place.
CURLOPT_FTPLISTONLY	TRUE pour ne lister que les noms d'un dossier FTP.
CURLOPT_HEADER	TRUE pour inclure l'en-t�te dans la valeur de retour.
CURLOPT_HTTPGET	TRUE pour r�initialiser la m�thode de requ�te HTTP � GET. Sachant que GET est la valeur par d�faut, cela n'est uniquement n�cessaire que si la m�thode de requ�te a �t� chang�e.
CURLOPT_HTTPPROXYTUNNEL	TRUE pour effectuer un tunnel � travers un proxy HTTP.
CURLOPT_MUTE	TRUE pour que PHP soit totalement silencieux concernant toutes les fonctions cURL.
CURLOPT_NETRC	TRUE 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_NOBODY	TRUE pour que le corps du transfert ne soit pas inclus dans la valeur de retour. La m�thode de demande est d�finie � HEAD. Le fait de modifier cette option � la valeur FALSE ne modifie pas la m�thode GET.
CURLOPT_NOPROGRESS	TRUE pour d�sactiver la barre de progression des transferts cURL. Note: PHP d�finit automatiquement cette option � TRUE. Ne changez cette valeur que le temps du d�boguage.
CURLOPT_NOSIGNAL	TRUE pour ignorer toutes les fonctions cURL qui cause l'envoi d'un signal au processus PHP. Activ�e par d�faut dans les SAPI multithread�s, les options d'expiration peut toujours �tre utilis�es.	Ajout� dans cURL 7.10.
CURLOPT_POST	TRUE pour que PHP fasse un HTTP POST. Un POST est un encodage normal application/x-www-from-urlencoded, utilis� couramment par les formulaires HTML.
CURLOPT_PUT	TRUE pour que le chargement se fasse par HTTP PUT. Le fichier � charger doit �tre fix� avec les options CURLOPT_INFILE et CURLOPT_INFILESIZE.
CURLOPT_RETURNTRANSFER	TRUE retourne directement le transfert sous forme de cha�ne de la valeur retourn�e par curl_exec() au lieu de l'afficher directement.
CURLOPT_SSL_VERIFYPEER	FALSE pour arr�ter CURL de v�rifier le certificat. 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).	TRUE par d�faut depuis cURL 7.10. Paquet install� par d�faut depuis cURL 7.10.
CURLOPT_TRANSFERTEXT	TRUE pour utiliser le mode ASCII pour les transferts FTP. Pour LDAP, il r�cup�re les donn�es en texte plein au lieu d'HTML. Sur les syst�mes Windows, STDOUT ne sera pas d�finie en mode binaire.
CURLOPT_UNRESTRICTED_AUTH	TRUE pour garder l'envoi du nom de l'utilisateur ainsi que le mot de passe lorsque l'on suit les chemins (en utilisant CURLOPT_FOLLOWLOCATION), m�me si le nom d'h�te change.
CURLOPT_UPLOAD	TRUE pour que PHP pr�pare un chargement.
CURLOPT_VERBOSE	TRUE pour afficher tous les �v�nements. �crit la sortie sur STDERR ou dans le fichier sp�cifi� en utilisant CURLOPT_STDERR.

value doit �tre un entier pour les valeurs suivantes du param�tres option :

Option	D�finissez le param�tre value �	Notes
CURLOPT_BUFFERSIZE	La taille du buffer � utiliser pour chaque lecture. Cependant, il n'y a aucune garantie que cette requ�te soit accomplie.	Ajout� en cURL 7.10.
CURLOPT_CLOSEPOLICY	Soit CURLCLOSEPOLICY_LEAST_RECENTLY_USED , soit CURLCLOSEPOLICY_OLDEST . Il y a trois autres constantes CURLCLOSEPOLICY_ mais CURL ne les supporte pas encore.
CURLOPT_CONNECTTIMEOUT	Le nombre de secondes � attendre durant la tentative de connexion. Utilisez 0 pour attendre ind�finiment.
CURLOPT_CONNECTTIMEOUT_MS	Le nombre de millisecondes � entendre durant la tentative de connexion. Utilisez 0 pour attendre ind�finiment.	Ajout� en cURL 7.16.2. Disponible depuis PHP 5.2.3.
CURLOPT_DNS_CACHE_TIMEOUT	Le temps en seconde que CURL doit conserver les entr�es DNS en m�moire. Cette option est d�finie � 120 secondes (2 minutes) par d�faut.
CURLOPT_FTPSSLAUTH	La m�thode d'identification FTP, lorsqu'elle est activ�e : CURLFTPAUTH_SSL (tente SSL en premier), CURLFTPAUTH_TLS (tente TLS en premier) ou CURLFTPAUTH_DEFAULT (laisse cURL d�cider).	Ajout� en cURL 7.12.2.
CURLOPT_HTTP_VERSION	CURL_HTTP_VERSION_NONE (d�faut, laisse cURL d�cider la version � utiliser), CURL_HTTP_VERSION_1_0 (force HTTP/1.0), ou CURL_HTTP_VERSION_1_1 (force HTTP/1.1).
CURLOPT_HTTPAUTH	La m�thode d'identification HTTP � utiliser. Ces options sont : CURLAUTH_BASIC , CURLAUTH_DIGEST , CURLAUTH_GSSNEGOTIATE , CURLAUTH_NTLM , CURLAUTH_ANY et CURLAUTH_ANYSAFE . Vous pouvez utiliser le s�parateur | ou un op�rateur pour combiner plus d'une m�thode. Si vous faites cela, CURL interrogera le serveur pour voir quelles sont les m�thodes support�es et prendra la meilleur. CURLAUTH_ANY est un alias pour CURLAUTH_BASIC | CURLAUTH_DIGEST | CURLAUTH_GSSNEGOTIATE | CURLAUTH_NTLM. CURLAUTH_ANYSAFE est un alias pour CURLAUTH_DIGEST | CURLAUTH_GSSNEGOTIATE | CURLAUTH_NTLM.
CURLOPT_INFILESIZE	La taille attendue, en octets, du fichier lors du t�l�chargement d'un fichier depuis un site distant.
CURLOPT_LOW_SPEED_LIMIT	La vitesse de transfert 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	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_MAXCONNECTS	Le nombre maximal de connexions persistantes autoris�es. Lorsque la limite est atteinte, l'option CURLOPT_CLOSEPOLICY est utilis� pour afficher les connexions ferm�es.
CURLOPT_MAXREDIRS	Le nombre maximal de redirections HTTP � suivre. Utilisez cette option avec l'option CURLOPT_FOLLOWLOCATION.
CURLOPT_PORT	Le num�ro du port de connexion, � la place de la valeur par d�faut utilis�e par le protocole.
CURLOPT_PROTOCOLS	Champ de bits de valeurs CURLPROTO_*. S'il est utilis�, ce champ limite les protocoles qui peuvent �tre utilis�s durant un transfert. Cela vous permet de limiter le nombre de protocoles utilis�s par la libcurl, tout en la compilant avec un grand nombre d'entre eux. Par d�faut, libcurl va accepter tous les protocoles qu'elle supporte. Voyez aussi CURLOPT_REDIR_PROTOCOLS. Les options valides de protocoles sont : CURLPROTO_HTTP , CURLPROTO_HTTPS , CURLPROTO_FTP , CURLPROTO_FTPS , CURLPROTO_SCP , CURLPROTO_SFTP , CURLPROTO_TELNET , CURLPROTO_LDAP , CURLPROTO_LDAPS , CURLPROTO_DICT , CURLPROTO_FILE , CURLPROTO_TFTP , CURLPROTO_ALL	Ajout� en cURL 7.19.4.
CURLOPT_PROXYAUTH	La m�thode d'identification HTTP � utiliser pour la connexion � un proxy. Utilisez la m�me m�thode que celle d�crite dans CURLOPT_HTTPAUTH. Pour une identification avec un proxy, seuls CURLAUTH_BASIC et CURLAUTH_NTLM sont actuellement support�s.	Ajout� en CURL 7.10.7.
CURLOPT_PROXYPORT	Le num�ro du port du proxy � utiliser pour la connexion. Ce num�ro de port peut �galement �tre d�fini dans l'option CURLOPT_PROXY.
CURLOPT_PROXYTYPE	Soit CURLPROXY_HTTP (par d�faut), soit CURLPROXY_SOCKS5 .	Ajout� en cURL 7.10.
CURLOPT_REDIR_PROTOCOLS	Champ de bits de constantes CURLPROTO_*. S'il est utilis�, ce champ limite les protocoles que libcurl peut utiliser pour un transfert, apr�s une redirection lorsque CURLOPT_FOLLOWLOCATION est actif. Cela permet de sp�cifier une sous-partie des protocoles compil�s avec libcurl. Par d�faut, libcurl va autoriser tous les protocoles, hormis FILE et SCP. C'est une diff�rence importante avec les versions pr�c�dents la 7.19.4, qui suivaient inconditionnellement tous les protocoles support�s. Voyez aussi CURLOPT_PROTOCOLS pour conna�tre la liste des valeurs des constantes.	Ajout�s en cURL 7.19.4.
CURLOPT_RESUME_FROM	L'offset, en octets, � partir duquel vous voulez commencer le transfert.
CURLOPT_SSL_VERIFYHOST	1 pour v�rifier l'existence d'un nom commun dans le certificat SSL. 2 pour v�rifier l'existence d'un nom commun et v�rifier qu'il correspond avec le nom d'h�te fourni.
CURLOPT_SSLVERSION	La version de SSL (2 ou 3) � utiliser. Par d�faut, PHP essayera de le d�terminer lui-m�me, bien que dans certains cas, il vous faudra le faire manuellement.
CURLOPT_TIMECONDITION	Comment CURLOPT_TIMEVALUE est trait�. Utilisez CURL_TIMECOND_IFMODSINCE pour retourner la page uniquement si elle a �t� modifi�e depuis le temps sp�cifi� par CURLOPT_TIMEVALUE. Si elle n'a pas �t� modifi�e, un en-t�te HTTP "304 Not Modified" sera retourn� en supposant que CURLOPT_HEADER vaut TRUE. Utilisez CURL_TIMECOND_IFUNMODSINCE pour faire l'inverse. CURL_TIMECOND_IFMODSINCE est par d�faut.
CURLOPT_TIMEOUT	Le temps maximum d'ex�cution de la fonction cURL.
CURLOPT_TIMEOUT_MS	Le nombre maximal de millisecondes autoris� aux fonctions cURL pour l'ex�cution.	Ajout� en cURL 7.16.2. Disponible depuis PHP 5.2.3.
CURLOPT_TIMEVALUE	Le temps en secondes depuis le 1er janvier 1970. Cette valeur sera utilis�e comme sp�cifi� dans l'option CURLOPT_TIMECONDITION. Par d�faut, CURL_TIMECOND_IFMODSINCE sera utilis�e.

value doit �tre une cha�ne pour les valeurs suivantes du param�tres option :

Option	D�finissez le param�tre value �	Notes
CURLOPT_CAINFO	Le nom d'un fichier contenant un ou plusieurs certificats pour v�rifier la concordance. Cela n'a de sens que si vous l'utilisez en combinaison de l'option CURLOPT_SSL_VERIFYPEER.
CURLOPT_CAPATH	Un dossier qui contient les certificats. Utilisez cette option avec l'option CURLOPT_SSL_VERIFYPEER.
CURLOPT_COOKIE	Le contenu de l'en-t�te "Set-Cookie: ", � transmettre dans l'en-t�te HTTP. Notez que les cookies sont s�par�es par des points-virgule, suivi d'un d'espace (e.g., "fruit=pomme; couleur=rouge")
CURLOPT_COOKIEFILE	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_COOKIEJAR	Le nom de fichier pour y sauvegarder tous les cookies internes lorsque la connexion se ferme.
CURLOPT_CUSTOMREQUEST	Une m�thode de requ�te 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", "CONNECT" et plus ; i.e. n'entrez pas une requ�te HTTP ici. Pour le moment, entrez "GET /index.php HTTP/1.0\r\n\r\n" serait incorrect. Note: N'utilisez pas cette commande sans vous assurer que le serveur l'accepte.
CURLOPT_EGDSOCKET	Comme CURLOPT_RANDOM_FILE except� que vous passez une cha�ne qui contient un nom de fichier vers le socket Entropy Gathering Daemon.
CURLOPT_ENCODING	Le contenu des en-t�tes "Accept-Encoding: " et active le d�codage de la r�ponse. Les encodages support�s sont "identity", "deflate" et "gzip". Si une cha�ne vide "" est utilis�, un en-t�te contenant tous les types d'encodage support�s est envoy�.	Ajout� en cURL 7.10.
CURLOPT_FTPPORT	La valeur qui sera utilis�e pour r�cup�rer 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_INTERFACE	Le nom de l'interface � utiliser. Cela peut �tre le nom d'une interface, une adresse IP ou encore le nom de l'h�te.
CURLOPT_KRB4LEVEL	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 fonctionne uniquement avec les transaction FTP.
CURLOPT_POSTFIELDS	Toutes les donn�es � passer lors d'une op�ration de HTTP POST. Pour envoyer un fichier, pr�fixez le nom du fichier avec un @ et utilisez le chemin complet. Peut �tre pass� sous la forme d'une cha�ne encod�e URL, comme 'para1=val1&para2=val2&...' ou sous la forme d'un tableau dont le nom du champ est la cl�, et les donn�es du champ la valeur. Si le param�tre value est un tableau, l'en-t�te Content-Type sera d�finie � multipart/form-data.
CURLOPT_PROXY	Le nom du proxy HTTP au tunnel qui le demande.
CURLOPT_PROXYUSERPWD	Un nom d'utilisateur et un mot de passe format�s sous la forme "[username]:[password]" � utiliser pour la connexion avec le proxy.
CURLOPT_RANDOM_FILE	Un nom de fichier � utiliser pour interroger le g�n�rateur de nombre al�atoire pour SSL.
CURLOPT_RANGE	La plage de valeurs � r�cup�rer sous la forme "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_REFERER	Le contenu de l'en-t�te "Referer: " � utiliser dans une requ�te HTTP.
CURLOPT_SSL_CIPHER_LIST	Une liste de chiffrements � utiliser avec SSL. Par exemple, RC4-SHA et TLSv1 sont des listes valides de chiffrements.
CURLOPT_SSLCERT	Le nom de fichier du certificat, au format PEM.
CURLOPT_SSLCERTPASSWD	Le mot de passe n�cessaire pour utiliser le certificat CURLOPT_SSLCERT.
CURLOPT_SSLCERTTYPE	Le format de votre certificat. Les formats support�s sont "PEM" (par d�faut), "DER", et "ENG".	Ajout� en cURL 7.9.3.
CURLOPT_SSLENGINE	L'identifiant pour le moteur de chiffrement de votre cl� priv�e sp�cifi� dans CURLOPT_SSLKEY.
CURLOPT_SSLENGINE_DEFAULT	L'identifiant pour le moteur de chiffrement utilis� pour les op�rations de chiffrement asym�trique.
CURLOPT_SSLKEY	Un nom de fichier contenant votre cl� priv�e SSL.
CURLOPT_SSLKEYPASSWD	Le mot de passe secret utilis� par votre cl� SSL priv�e sp�cifi� dans CURLOPT_SSLKEY. Note: Du fait que cette option contient un mot de passe sensible, souvenez-vous de conserver le script PHP qui le contient en toute s�curit�.
CURLOPT_SSLKEYTYPE	Le type de votre cl� SSL priv�e sp�cifi� dans CURLOPT_SSLKEY. Les types de cl� support�s sont "PEM" (par d�faut), "DER", et "ENG".
CURLOPT_URL	L'URL � r�cup�rer. Vous pouvez aussi choisir cette valeur lors de l'appel � curl_init().
CURLOPT_USERAGENT	Le contenu de l'en-t�te "User-Agent: " � utiliser dans une requ�te HTTP.
CURLOPT_USERPWD	Un nom d'utilisateur et un mot de passe format�s sous la forme "[username]:[password]" � utiliser pour la connexion.

value doit �tre un tableau pour les valeurs suivantes du param�tres option :

Option	D�finissez le param�tre value �	Notes
CURLOPT_HTTP200ALIASES	Un tableau de r�ponses HTTP 200 qui sera trait� comme r�ponses valides et non comme des erreurs.	Ajout� en CURL 7.10.3.
CURLOPT_HTTPHEADER	Un tableau de champs d'en-t�tes HTTP � d�finir.
CURLOPT_POSTQUOTE	Un tableau de commandes FTP � ex�cuter sur le serveur apr�s que la requ�te FTP se soit ex�cut�e.
CURLOPT_QUOTE	Un tableau de commandes FTP � ex�cuter sur le serveur avant la requ�te FTP.

value doit �tre une ressource (utilisant fopen(), par exemple) pour les valeurs suivantes du param�tre option :

Option	D�finissez le param�tre value �	Notes
CURLOPT_FILE	Le fichier o� sera �crit le transfert. Par d�faut, STDOUT (la fen�tre du navigateur).
CURLOPT_INFILE	Le fichier lu par le transfert lors du chargement.
CURLOPT_STDERR	Un chemin alternatif � utiliser pour afficher les erreurs au lieu de STDERR.
CURLOPT_WRITEHEADER	Le fichier o� sera �crit les parties d'en-t�te du transfert.

value doit �tre une cha�ne de caract�res qui sera un nom valide de fonction de rappel pour les valeurs suivantes du param�tre option :

Option	D�finissez le param�tre value �	Notes
CURLOPT_HEADERFUNCTION	Le nom d'une fonction de rappel qui prend deux param�tres. Le premier est la ressource CURL, le second, une cha�ne contenant les donn�es de l'en-t�te � �crire. En utilisant cette fonction de rappel, il est de votre responsabilit� de l'�criture des donn�es de l'en-t�te. Retourne le nombre d'octets �crits.
CURLOPT_PASSWDFUNCTION	Le nom d'une fonction de rappel qui prend trois param�tres. Le premier est la ressource CURL, le second, une cha�ne contenant un mot de passe de prompt et le troisi�me, est la longueur maximale du mot de passe. Retourne une cha�ne contenant le mot de passe.
CURLOPT_READFUNCTION	Le nom d'une fonction de rappel o� la fonction de rappel prend deux param�tres. Le premier est la ressource CURL et le second, une cha�ne contenant les donn�es � lire. En utilisant cette fonction de rappel, il devient de votre responsabilit� de lire les donn�es. Retourne le nombre d'octets lus. Retourne 0 � un signal EOF.
CURLOPT_WRITEFUNCTION	Le nom d'une fonction de rappel o� la fonction de rappel prend deux param�tres. Le premier est la ressource CURL et le second, une cha�ne contenant les donn�es � �crire. En utilisant cette fonction de rappel, il devient de votre responsabilit� d'�crire les donn�es. Doit retourner le nombre exact d'octets �crits ou il �chouera.