curl_setopt — Définit une option pour un appel CURL Description
bool curl_setopt (int ch, option de chaîne, valeur mixte)
La fonction curl_setopt() définira les options pour une session CURL. Le paramètre option est le paramètre souhaité et value est la valeur donnée par cette option.
Les valeurs des options suivantes seront utilisées sous forme d'entiers longs (spécifiés dans le paramètre option) :
*CURLOPT_INFILESIZE : Lorsque vous téléchargez un fichier sur le site distant, cette option indique à PHP la taille du fichier que vous téléchargez.
*CURLOPT_VERBOSE : si vous souhaitez que CURL signale chaque événement inattendu, définissez cette option sur une valeur non nulle.
*CURLOPT_HEADER : si vous souhaitez inclure un en-tête dans la sortie, définissez cette option sur une valeur non nulle.
*CURLOPT_NOPROGRESS : Si vous ne souhaitez pas que PHP affiche une barre de progression pour les transferts CURL, définissez cette option sur une valeur non nulle.
Remarque : PHP définit automatiquement cette option sur une valeur non nulle, vous ne devez modifier cette option qu'à des fins de débogage.
*CURLOPT_NOBODY : si vous ne souhaitez pas inclure la partie du corps dans la sortie, définissez cette option sur une valeur non nulle.
*CURLOPT_FAILONERROR : Si vous souhaitez que PHP n'affiche pas d'erreur (retour de code HTTP supérieur ou égal à 300) lorsqu'une erreur se produit, définissez cette option sur une valeur non nulle. Le comportement par défaut consiste à renvoyer une page normale et à ignorer le code.
*CURLOPT_UPLOAD : Si vous souhaitez que PHP prépare le téléchargement, définissez cette option sur une valeur non nulle.
*CURLOPT_POST : Si vous souhaitez que PHP effectue un HTTP POST standard, définissez cette option sur une valeur non nulle. Ce POST est du type application/x-www-from-urlencoded ordinaire, qui est principalement utilisé par les formulaires HTML.
*CURLOPT_FTPLISTONLY : définissez cette option sur une valeur non nulle et PHP répertoriera les noms de répertoires pour FTP.
*CURLOPT_FTPAPPEND : définissez cette option sur une valeur non nulle et PHP appliquera le fichier distant au lieu de l'écraser.
*CURLOPT_NETRC : définissez cette option sur une valeur non nulle et PHP recherchera dans votre fichier ~./netrc le nom d'utilisateur et le mot de passe du site distant auquel vous souhaitez vous connecter.
*CURLOPT_FOLLOWLOCATION : définissez cette option sur un en-tête non nul (comme "Location: ") et le serveur l'enverra dans le cadre de l'en-tête HTTP (notez que ceci est récursif, PHP enverra un en-tête comme "Location: ").
*CURLOPT_PUT : définissez cette option sur une valeur non nulle pour télécharger un fichier via HTTP. Pour télécharger ce fichier, les options CURLOPT_INFILE et CURLOPT_INFILESIZE doivent être définies.
*CURLOPT_MUTE : définissez cette option sur une valeur non nulle et PHP sera complètement silencieux pour la fonction CURL.
*CURLOPT_TIMEOUT : définissez un entier long comme nombre maximum de secondes.
*CURLOPT_LOW_SPEED_LIMIT : définissez un entier long pour contrôler le nombre d'octets transmis.
*CURLOPT_LOW_SPEED_TIME : définissez un entier long pour contrôler le nombre de secondes de transmission du nombre d'octets spécifié par CURLOPT_LOW_SPEED_LIMIT.
*CURLOPT_RESUME_FROM : transmettez un paramètre long contenant l'adresse de décalage d'octet (le formulaire de démarrage vers lequel vous souhaitez transférer).
*CURLOPT_SSLVERSION : Passer un paramètre long contenant la version SSL. Par défaut, PHP fera son propre travail, pour plus de sécurité, vous devrez le configurer manuellement.
*CURLOPT_TIMECONDITION : transmettez un paramètre long pour spécifier comment gérer le paramètre CURLOPT_TIMEVALUE. Vous pouvez définir ce paramètre sur TIMECOND_IFMODSINCE ou TIMECOND_ISUNMODSINCE. Ceci est uniquement pour HTTP.
*CURLOPT_TIMEVALUE : passe un certain nombre de secondes du 1970-1-1 à nos jours. Cette heure sera utilisée comme valeur spécifiée par l'option CURLOPT_TIMEVALUE, ou par la valeur par défaut TIMECOND_IFMODSINCE.
Les valeurs des options suivantes seront traitées comme des chaînes :
*CURLOPT_URL : Il s'agit de l'adresse URL que vous souhaitez récupérer à l'aide de PHP. Vous pouvez également définir cette option lors de l'initialisation avec la fonction curl_init().
*CURLOPT_USERPWD : passez une chaîne sous la forme de [nom d'utilisateur] : [mot de passe] et utilisez PHP pour vous connecter.
*CURLOPT_PROXYUSERPWD : Passez une chaîne au format [nom d'utilisateur]:[mot de passe] pour vous connecter au proxy HTTP.
*CURLOPT_RANGE : transmettez une plage que vous souhaitez spécifier. Il doit être au format "XY", X ou Y étant exclus. Les transferts HTTP prennent également en charge plusieurs intervalles, séparés par des virgules (XY, NM).
*CURLOPT_POSTFIELDS : transmettez une chaîne contenant toutes les données en tant qu'opération HTTP "POST".
*CURLOPT_REFERER : Une chaîne contenant un en-tête "referer" dans la requête HTTP.
*CURLOPT_USERAGENT : Une chaîne contenant un en-tête "user-agent" dans la requête HTTP.
*CURLOPT_FTPPORT : Transmettez une adresse IP contenant l'adresse IP utilisée par la commande ftp "POST". Cette commande POST indique au serveur distant de se connecter à l'adresse IP que nous avons spécifiée. Cette chaîne peut être une adresse IP, un nom d'hôte, un nom d'interface réseau (sous UNIX) ou '-' (utilisez l'adresse IP par défaut du système).
*CURLOPT_COOKIE : Passe un en-tête contenant un cookie HTTP à la connexion.
*CURLOPT_SSLCERT : Passe une chaîne contenant le certificat au format PEM.
*CURLOPT_SSLCERTPASSWD : Passez un mot de passe contenant le mot de passe nécessaire pour utiliser le certificat CURLOPT_SSLCERT.
*CURLOPT_COOKIEFILE : Transmettez une chaîne contenant le nom du fichier contenant les données du cookie. Ce fichier cookie peut être au format Netscape ou il peut s'agir d'une pile d'en-têtes de style HTTP stockés dans le fichier.
*CURLOPT_CUSTOMREQUEST : lors d'une requête HTTP, transmettez un caractère à utiliser par GET ou HEAD. Transmettez une chaîne à utiliser à la place de GET ou HEAD lors de l'exécution d'une requête HTTP. Ceci est utile pour effectuer une autre requête HTTP plus obscure.
Remarque : assurez-vous que votre serveur prend en charge l'ordre de ne pas le faire encore.
Les options suivantes nécessitent une description de fichier (obtenue à l'aide de la fonction fopen()) :
*CURLOPT_FILE : ce fichier sera le fichier de sortie dans lequel vous effectuez le transfert. La valeur par défaut est STDOUT.
*CURLOPT_INFILE : Ce fichier est le fichier d'entrée que vous avez envoyé.
*CURLOPT_WRITEHEADER : ce fichier contient la partie d'en-tête de votre sortie.
*CURLOPT_STDERR : ce fichier contient des erreurs écrites à la place de stderr.