La fonction la plus importante de la bibliothèque de fonctions CURL est curl_setopt(), qui permet de personnaliser la requête HTTP en définissant les options définies par la bibliothèque de fonctions CURL
Utilisation :
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.
CURLOPT_INFILESIZE : //Lorsque vous téléchargez un fichier sur 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 tout é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 savez pas comment afficher une barre de progression pour les transferts CURL en PHP, 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 ne s'affiche pas lorsqu'une erreur se produit (le code HTTP renvoie supérieur ou égal à 300), 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 un type application/x-www-from-urlencoded ordinaire, principalement utilisé par les formulaires HTML
CURLOPT_FTPLISTONLY : //Définissez cette option sur une valeur non nulle, PHP listera Liste FTP des noms de répertoires.
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 l'enverra comme 'Emplacement : ' en-tête).
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 envoyés.
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 : // Passe 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 : //Passez 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 de 1970-1-1 à maintenant. 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 : //Passez une plage que vous souhaitez spécifier. Il doit être au format « X-Y », X ou Y étant exclus. Les transferts HTTP prennent également en charge plusieurs intervalles, séparés par des virgules (X-Y, N-M).
CURLOPT_POSTFIELDS : //Transmettez une chaîne contenant toutes les données en tant qu'opération HTTP "POST".
CURLOPT_REFERER : //Contient une chaîne avec 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 : //Passez 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 : //Passer une connexion d'en-tête contenant un cookie HTTP.
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 : //Passez 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. Utile pour DELETE ou d'autres opérations
Remarque : Ne faites pas cela avant de vous être assuré que votre serveur prend en charge la commande.
Les options suivantes nécessitent une description de fichier (obtenue en utilisant la fonction fopen()) :
CURLOPT_FILE : //Ce fichier sera le fichier de sortie dans lequel vous placez 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 en-tête de votre sortie.
CURLOPT_STDERR:// Ce fichier contient une erreur écrite à la place de stderr.