admin/doc-fr
1
0
Fork 0
mirror of https://github.com/macintoshplus/doc-fr.git synced 2026-03-25 17:32:07 +01:00
Code Issues Packages Projects Releases Wiki Activity
Files
6c8ac3d8347644cdf014da1da170fbd80553c5df
doc-fr/reference/curl/functions/curl-setopt.xml
Sergey Panteleev 1f958fb59b Sync various sections, ex #244 (#245) 
Co-authored-by: Pierrick Charron <pierrick@php.net>
Co-authored-by: George Peter Banyard <girgias@php.net>
2022-06-15 12:41:33 +01:00

2505 lines
109 KiB
XML
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 4c5d201d5f1a368c9ec6e81f53d16e8b2607d5c1 Maintainer: yannick Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.curl-setopt" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>curl_setopt</refname>
<refpurpose>Définit une option de transmission cURL</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>bool</type><methodname>curl_setopt</methodname>
<methodparam><type>CurlHandle</type><parameter>handle</parameter></methodparam>
<methodparam><type>int</type><parameter>option</parameter></methodparam>
<methodparam><type>mixed</type><parameter>value</parameter></methodparam>
</methodsynopsis>
<para>
Définit une option pour le gestionnaire de session cURL fournit.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
&curl.ch.description;
<varlistentry>
<term><parameter>option</parameter></term>
<listitem>
<para>
L'option <literal>CURLOPT_XXX</literal> à définir.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>value</parameter></term>
<listitem>
<para>
La valeur à définir pour <parameter>option</parameter>.
</para>
<para>
<parameter>value</parameter> doit être un &boolean; pour les
valeurs suivantes du paramètre <parameter>option</parameter> :
<informaltable>
<tgroup cols="3">
<thead>
<row>
<entry valign="top">Option</entry>
<entry valign="top">Définir <parameter>value</parameter> à</entry>
<entry valign="top">Notes</entry>
</row>
</thead>
<tbody>
<row>
<entry valign="top"><constant>CURLOPT_AUTOREFERER</constant></entry>
<entry valign="top">
&true; pour définir automatiquement le champ
<literal>Referer:</literal> dans les requêtes où une redirection
<literal>Location:</literal> suit.
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_COOKIESESSION</constant></entry>
<entry valign="top">
&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.
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_CERTINFO</constant></entry>
<entry valign="top">
&true; pour sortir les informations de certification SSL vers
<literal>STDERR</literal> pour les transferts sécurisés.
</entry>
<entry valign="top">
Ajouté en cURL version 7.19.1.
Nécessite <constant>CURLOPT_VERBOSE</constant> d'être activé.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_CONNECT_ONLY</constant></entry>
<entry valign="top">
&true; indique à la bibliothèque d'effectuer toutes les
configurations nécessaires à l'authentification et la connexion
au proxy, mais ne transfère aucune donnée.
Cette option est implémentée pour HTTP, SMTP et POP3.
</entry>
<entry valign="top">
Ajouté en cURL 7.15.2.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_CRLF</constant></entry>
<entry valign="top">
&true; pour convertir les nouvelles lignes Unix en nouvelles
lignes CRLF durant les transferts.
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_DISALLOW_USERNAME_IN_URL</constant></entry>
<entry valign="top">
&true; pour ne pas permettre les URLs qui incluent un nom
d'utilisateur. Les noms d'utilisateurs sont autorisé par défaut (0).
</entry>
<entry valign="top">
Ajouté en cURL 7.61.0. Disponible à partir de PHP 7.3.0.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_DNS_SHUFFLE_ADDRESSES</constant></entry>
<entry valign="top">
&true; pour mélanger l'ordre de toutes les addresses retournées
pour qu'elles soit utilisées dans un ordre aléatoire, quand un nom
est résolu et que plus d'une addresse IP est retournée.
Ceci peut causer d'utiliser IPv4 avant IPv6 ou vice versa.
</entry>
<entry valign="top">
Ajouté en cURL 7.60.0. Disponible à partir de PHP 7.3.0.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_HAPROXYPROTOCOL</constant></entry>
<entry valign="top">
&true; pour envoyer un en-tête HAProxy PROXY protocol v1 au
début de la connexion. L'action par défaut est de ne pas envoyer
cet en-tête.
</entry>
<entry valign="top">
Ajouté en cURL 7.60.0. Disponible à partir de PHP 7.3.0.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_SSH_COMPRESSION</constant></entry>
<entry valign="top">
&true; pour activer la compression SSH intégré. Ceci est une demande,
pas un ordre ; le serveur peut ou ne peut pas le faire.
</entry>
<entry valign="top">
Ajouté en cURL 7.56.0. Disponible à partir de PHP 7.3.0.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_DNS_USE_GLOBAL_CACHE</constant></entry>
<entry valign="top">
&true; pour utiliser un cache DNS global. Cette option n'est pas
compatible avec les threads. Elle est conditionellement activée par
défaut si PHP est compilé pour une utilisation non threadé
(CLI, FFCGI, Apache2-Prefork, etc.).
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_FAILONERROR</constant></entry>
<entry valign="top">
&true; pour échouer verbalement si le code HTTP retourné est
supérieur ou égal à 400. Le comportement par défaut est de retourner
la page normalement, en ignorant le code.
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_SSL_FALSESTART</constant></entry>
<entry valign="top">
&true; pour activer le faux départ TLS.
</entry>
<entry valign="top">
Ajouté en cURL 7.42.0. Disponible à partir de PHP 7.0.7.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_FILETIME</constant></entry>
<entry valign="top">
&true; pour tenter de récupérer la date de modification
du document distant. Cette valeur peut être récupérée en utilisant
l'option <constant>CURLINFO_FILETIME</constant> avec
<function>curl_getinfo</function>.
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_FOLLOWLOCATION</constant></entry>
<entry valign="top">
&true; pour suivre tous les en-têtes <literal>"Location: "</literal>
que le serveur envoie dans les en-têtes HTTP.
Voir aussi <constant>CURLOPT_MAXREDIRS</constant>.
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_FORBID_REUSE</constant></entry>
<entry valign="top">
&true; pour forcer à fermer explicitement la connexion lorsque
le processus est terminé. Elle ne sera donc pas mise en cache pour
réutilisation.
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_FRESH_CONNECT</constant></entry>
<entry valign="top">
&true; pour forcer l'utilisation d'une nouvelle connexion
au lieu d'une en cache.
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_FTP_USE_EPRT</constant></entry>
<entry valign="top">
&true; pour utiliser EPRT (et LPRT) lors des téléchargements FTP
actifs. Utilisez &false; pour désactiver EPRT et LPRT
et ainsi n'utiliser que PORT.
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_FTP_USE_EPSV</constant></entry>
<entry valign="top">
&true; pour tenter tout d'abord une commande EPSV pour les
transferts FTP avant de revenir à une commande PASV.
Définir à &false; pour désactiver EPSV.
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_FTP_CREATE_MISSING_DIRS</constant></entry>
<entry valign="top">
&true; pour créer les dossiers intermédiaires lorsqu'une opération
FTP est demandée sur un chemin qui n'existe pas.
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_FTPAPPEND</constant></entry>
<entry valign="top">
&true; pour que PHP ajoute les informations au fichier distant
plutôt que de l'écraser.
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_TCP_NODELAY</constant></entry>
<entry valign="top">
&true; pour désactiver l'algorithme Nagle de TCP, qui tente de
réduire le nombre de petits paquets sur le réseau.
</entry>
<entry valign="top">
Disponible pour les versions compilées avec libcurl 7.11.2 ou
supérieur.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_FTPASCII</constant></entry>
<entry valign="top">
Un alias de <constant>CURLOPT_TRANSFERTEXT</constant>.
Utilisez celui-là à la place.
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_FTPLISTONLY</constant></entry>
<entry valign="top">
&true; pour ne lister que les noms dans un dossier FTP.
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_HEADER</constant></entry>
<entry valign="top">
&true; pour inclure l'en-tête dans la valeur de retour.
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry><constant>CURLINFO_HEADER_OUT</constant></entry>
<entry valign="top">
&true; pour suivre la &string; du gestionnaire de requête.
</entry>
<entry valign="top">
Le préfixe <constant>CURLINFO_</constant> est intentionnel.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_HTTP09_ALLOWED </constant></entry>
<entry valign="top">
Si on doit ou non autoriser les réponses HTTP/0.9.
Par défaut, vaut &false; depuis libcurl 7.66.0;
Auparavant, vallait &true; par défaut.
</entry>
<entry valign="top">
Available since PHP 7.3.15 and 7.4.3, respectively, if built against libcurl &gt;= 7.64.0
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_HTTPGET</constant></entry>
<entry valign="top">
&true; pour réinitialiser la méthode de la requête HTTP à GET.
Sachant que GET est la valeur par défaut, cela est uniquement
nécessaire si la méthode de la requête a été modifiée.
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_HTTPPROXYTUNNEL</constant></entry>
<entry valign="top">
&true; pour passer par un proxy HTTP donné.
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_HTTP_CONTENT_DECODING</constant></entry>
<entry valign="top">
&false; pour récupérer le corps de la réponse HTTP brute.
</entry>
<entry valign="top">
Disponible si compilé contre libcurl &gt;= 7.16.2.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_KEEP_SENDING_ON_ERROR</constant></entry>
<entry valign="top">
&true; pour continuer d'envoyer le corps de la requête si le code
HTTP est supérieur ou égal à 300. La valeur par défaut est d'arrêter
l'envoie et de fermer le flux ou connexion. Adapté pour une
authentication NTLM manuelle. La plupart des applications n'ont pas
besoin de cette option.
</entry>
<entry valign="top">
Disponible à partir de PHP 7.3.0 si compilé contre libcurl &gt;= 7.51.0.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_MUTE</constant></entry>
<entry valign="top">
&true; pour que PHP soit totalement silencieux concernant
toutes les fonctions cURL.
</entry>
<entry valign="top">
Supprimé en cURL 7.15.5 (Utiliser CURLOPT_RETURNTRANSFER à la place)
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_NETRC</constant></entry>
<entry valign="top">
&true; pour analyser le fichier <filename>~./netrc</filename>
pour trouver un nom d'utilisateur et mot de passe pour le site
distant où une connexion est en train d'être établie.
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_NOBODY</constant></entry>
<entry valign="top">
&true; pour exclure le corps de la sortie.
La méthode de la requête est alors définie à HEAD.
Modifier ceci à &false; ne modifie pas la méthode en GET.
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_NOPROGRESS</constant></entry>
<entry valign="top"><para>
&true; pour désactiver la barre de progression des transferts cURL.
<note>
<para>
PHP définit automatiquement cette option à &true;, ceci devrait
être modifié uniquement pour des raisons de déboguage.
</para>
</note>
</para></entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_NOSIGNAL</constant></entry>
<entry valign="top">
&true; pour ignorer toutes les fonctions cURL qui causent l'envoi
d'un signal au processus PHP. Activée par défaut dans les SAPIs
multithreadés afin que les options d'expiration puissent toujours
être utilisées.
</entry>
<entry valign="top">
Ajouté dans cURL 7.10.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_PATH_AS_IS</constant></entry>
<entry valign="top">
&true; pour ne pas gérer les séquences point point.
</entry>
<entry valign="top">
Ajouté dans cURL 7.42.0. Disponible à partir de PHP 7.0.7.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_PIPEWAIT</constant></entry>
<entry valign="top">
&true; pour attendre pour le pipelining/multiplexing.
</entry>
<entry valign="top">
Ajouté dans cURL 7.43.0. Disponible à partir de PHP 7.0.7.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_POST</constant></entry>
<entry valign="top">
&true; pour que PHP fasse un HTTP POST régulier. Ce POST est le
type normal <literal>application/x-www-form-urlencoded</literal>,
utilisé couramment par les formulaires HTML.
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_PUT</constant></entry>
<entry valign="top">
&true; pour HTTP PUT un fichier. Le fichier à téléverser avec PUT
doit être définit avec <constant>CURLOPT_INFILE</constant> et
<constant>CURLOPT_INFILESIZE</constant>.
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_RETURNTRANSFER</constant></entry>
<entry valign="top">
&true; pour retourner le transfert en tant que &string; de la
valeur retournée par <function>curl_exec</function> au lieu
de l'afficher directement.
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_SASL_IR</constant></entry>
<entry valign="top">
&true; pour permettre d'envoyer la réponse initiale dans le premier paquet.
</entry>
<entry valign="top">
Ajouté dans cURL 7.31.10. Disponible à partir de PHP 7.0.7.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_SSL_ENABLE_ALPN</constant></entry>
<entry valign="top">
&false; pour désactiver ALPN dans la poignée de main SSL (si le
back-end SSL libcurl est compilé pour utiliser le supporte),
qui peut être utilisée pour négocier http2.
</entry>
<entry valign="top">
Ajouté dans cURL 7.36.0. Disponible à partir de PHP 7.0.7.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_SSL_ENABLE_NPN</constant></entry>
<entry valign="top">
&false; pour désactiver NPN dans la poignée de main SSL (si le
back-end SSL libcurl est compilé pour utiliser le supporte),
qui peut être utilisé pour négocier http2.
</entry>
<entry valign="top">
Ajouté dans cURL 7.36.0. Disponible à partir de PHP 7.0.7.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_SSL_VERIFYPEER</constant></entry>
<entry valign="top">
&false; pour arrêter cURL de vérifier le certificat du pair.
Les certificats alternatifs à vérifier contre peuvent être
spécifiés avec l'option <constant>CURLOPT_CAINFO</constant> ou
un répertoire de certificat peut être spécifié avec l'option
<constant>CURLOPT_CAPATH</constant>.
</entry>
<entry valign="top">
&true; par défaut à partir de cURL 7.10.
Paquet installé par défaut à partir de cURL 7.10.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_SSL_VERIFYSTATUS</constant></entry>
<entry valign="top">
&true; pour vérifier l'état du certificat.
</entry>
<entry valign="top">
Ajouté dans cURL 7.41.0. Disponible à partir de PHP 7.0.7.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_PROXY_SSL_VERIFYPEER</constant></entry>
<entry valign="top">
&false; pour arrêter cURL de vérifié le certificat du homologue.
Des certificats alternatifs à vérifier contre peuvent être définie
avec l'option <constant>CURLOPT_CAINFO</constant> ou un dossier de
certificat peut être définie avec l'option
<constant>CURLOPT_CAPATH</constant>. Quand définie à &false;, la
vérification du certificat homologue réussit malgré tout.
</entry>
<entry valign="top">
&true; par défaut. Disponible à partir de PHP 7.3.0 et libcurl &gt;= cURL 7.52.0.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_SAFE_UPLOAD</constant></entry>
<entry valign="top">
Toujours &true;, ce qui désactive la prise en charge du préfixe <literal>@</literal>
pour le téléversement de fichiers dans <constant>CURLOPT_POSTFIELDS</constant>,
ce qui signifie que les valeurs commençant par <literal>@</literal> peuvent être
transmises en tant que champs en toute sécurité.
<classname>CURLFile</classname> peut être utilisé pour les téléversements à la place.
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_SUPPRESS_CONNECT_HEADERS</constant></entry>
<entry valign="top">
&true; pour réprimer les en-têtes de réponse proxy CONNECT des
fonctions de rappels utilisateurs
<constant>CURLOPT_HEADERFUNCTION</constant> et <constant>CURLOPT_WRITEFUNCTION</constant>,
quand <constant>CURLOPT_HTTPPROXYTUNNEL</constant> est utilisé et
une requête CONNECT est faite.
</entry>
<entry valign="top">
Ajouté dans cURL 7.54.0. Disponible à partir de PHP 7.3.0.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_TCP_FASTOPEN</constant></entry>
<entry valign="top">
&true; pour activer TCP Fast Open.
</entry>
<entry valign="top">
Ajouté dans cURL 7.49.0. Disponible à partir de PHP 7.0.7.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_TFTP_NO_OPTIONS</constant></entry>
<entry valign="top">
&true; pour ne pas envoyer les requêtes d'options TFTP.
</entry>
<entry valign="top">
Ajouté dans cURL 7.48.0. Disponible à partir de PHP 7.0.7.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_TRANSFERTEXT</constant></entry>
<entry valign="top">
&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, <literal>STDOUT</literal> ne sera pas
définie en mode binaire.
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_UNRESTRICTED_AUTH</constant></entry>
<entry valign="top">
&true; pour continuer d'envoyer le nom d'utilisateur et le
mot de passe lorsque l'on suit les chemins (en utilisant
<constant>CURLOPT_FOLLOWLOCATION</constant>),
même si le nom d'hôte change.
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_UPLOAD</constant></entry>
<entry valign="top">
&true; pour préparer pour un téléversement.
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_VERBOSE</constant></entry>
<entry valign="top">
&true; pour afficher les informations de façon verbeuse.
Écrit la sortie sur <literal>STDERR</literal>, ou dans le fichier
spécifié en utilisant <constant>CURLOPT_STDERR</constant>.
</entry>
<entry valign="top">
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</para>
<para>
<parameter>value</parameter> devrait être un &integer; pour les valeurs
suivantes du paramètres <parameter>option</parameter> :
<informaltable>
<tgroup cols="3">
<thead>
<row>
<entry>Option</entry>
<entry>Définir <parameter>value</parameter> à</entry>
<entry>Notes</entry>
</row>
</thead>
<tbody>
<row>
<entry valign="top"><constant>CURLOPT_BUFFERSIZE</constant></entry>
<entry valign="top">
La taille du tampon à utiliser pour chaque lecture. Cependant,
il n'y a aucune garantie que cette requête soit accomplie.
</entry>
<entry valign="top">
Ajouté en cURL 7.10.
</entry>
</row>
<row>
<entry><constant>CURLOPT_CONNECTTIMEOUT</constant></entry>
<entry valign="top">
Le nombre de secondes à attendre durant la tentative de connexion.
Utiliser &zero; pour attendre indéfiniment.
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_CONNECTTIMEOUT_MS</constant></entry>
<entry valign="top">
Le nombre de millisecondes à attendre durant la tentative de
connexion. Utiliser &zero; pour attendre indéfiniment.
<!-- http://curl.haxx.se/libcurl/c/curl_easy_setopt.html -->
Si libcurl est compilé pour utiliser le système standard de résolution
de noms, cette partie de la connexion utilisera toujours la seconde
résolution pour le délai d'attente maximal avec un délai
d'attente maximal minimum autorisé d'une seconde.
</entry>
<entry valign="top">
Ajouté en cURL 7.16.2.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_DNS_CACHE_TIMEOUT</constant></entry>
<entry valign="top">
Le temps en seconde pour conserver les entrées DNS en mémoire.
Cette option est définie à 120 secondes (2 minutes) par défaut.
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_EXPECT_100_TIMEOUT_MS</constant></entry>
<entry valign="top">
Le délais d'attente pour les réponses Expect: 100-continue responses
en millisecondes. Par défaut 1000 millisecondes.
</entry>
<entry valign="top">
Ajouté dans cURL 7.36.0. Disponible à partir de PHP 7.0.7.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_HAPPY_EYEBALLS_TIMEOUT_MS</constant></entry>
<entry valign="top">
Une longueur d'avance pour ipv6 pour l'algorithme happy eyeballs.
Happy eyeballs tente se connecter à la fois aux adresses IPv4 et
IPv6 pour les hôtes à double pile, préférant IPv6 d'abord pour les
millisecondes d'expiration. Par défaut CURL_HET_DEFAULT,
qui est actuellement 200 millisecondes.
</entry>
<entry valign="top">
Ajouté en cURL 7.59.0. Disponible à partir de PHP 7.3.0.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_FTPSSLAUTH</constant></entry>
<entry valign="top">
La méthode d'identification FTP, lorsqu'elle est activée :
<literal>CURLFTPAUTH_SSL</literal> (tenter SSL en premier),
<literal>CURLFTPAUTH_TLS</literal> (tenter TLS en premier), ou
<literal>CURLFTPAUTH_DEFAULT</literal> (laisser cURL décider).
</entry>
<entry valign="top">
Ajouté en cURL 7.12.2.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_HEADEROPT</constant></entry>
<entry valign="top">
Comment gérer les en-têtes. Une des constantes suivantes :
<simpara>
<constant>CURLHEADER_UNIFIED</constant> : les en-têtes spécifié dans
<constant>CURLOPT_HTTPHEADER</constant> seront utilisés dans les
requêtes à la fois aux serveurs ainsi qu'aux proxies.
Avec cette option activé,
<constant>CURLOPT_PROXYHEADER</constant> n'aura pas d'effet.
</simpara>
<simpara>
<constant>CURLHEADER_SEPARATE</constant> : fait que les en-têtes
<constant>CURLOPT_HTTPHEADER</constant> sont uniquement envoyés aux
serveurs et pas à un proxy. Les en-têtes pour les proxies doivent
être définit avec <constant>CURLOPT_PROXYHEADER</constant> pour être
utilisé. Il est à noter que si une requête non-CONNECT est envoyé à un
proxy, libcurl envera à la fois les en-têtes de serveur et de proxy.
Lors de CONNECT, libcurl envera les en-têtes
<constant>CURLOPT_PROXYHEADER</constant> seulement au proxy et les
en-têtes <constant>CURLOPT_HTTPHEADER</constant> seulement au serveur.
</simpara>
<simpara>
Par défaut <constant>CURLHEADER_SEPARATE</constant> à partir de cURL
7.42.1, et <constant>CURLHEADER_UNIFIED</constant> auparavant.
</simpara>
</entry>
<entry valign="top">
Ajouté dans cURL 7.37.0. Disponible à partir de PHP 7.0.7.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_HTTP_VERSION</constant></entry>
<entry valign="top">
<constant>CURL_HTTP_VERSION_NONE</constant> (défaut, laisse cURL
décider la version à utiliser),
<constant>CURL_HTTP_VERSION_1_0</constant> (force HTTP/1.0),
ou <constant>CURL_HTTP_VERSION_1_1</constant> (force HTTP/1.1),
<constant>CURL_HTTP_VERSION_2_0</constant> (tente HTTP 2),
<constant>CURL_HTTP_VERSION_2 </constant> (alias de <constant>CURL_HTTP_VERSION_2_0</constant>)
,<constant>CURL_HTTP_VERSION_2TLS</constant> (tente HTTP 2 sur TLS (HTTPS) uniquement) ou
<constant>CURL_HTTP_VERSION_2_PRIOR_KNOWLEDGE</constant> (émet des requêtes HTTP non TLS en utilisant HTTP / 2 sans mise à niveau HTTP / 1.1).
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_HTTPAUTH</constant></entry>
<entry valign="top">
<para>
La méthode d'identification HTTP à utiliser. Ces options sont :
<constant>CURLAUTH_BASIC</constant>,
<constant>CURLAUTH_DIGEST</constant>,
<constant>CURLAUTH_GSSNEGOTIATE</constant>,
<constant>CURLAUTH_NTLM</constant>,
<constant>CURLAUTH_ANY</constant> et
<constant>CURLAUTH_ANYSAFE</constant>.
</para>
<para>
L'opérateur bit à bit <literal>|</literal> (ou) peut être utilisé
pour combiner plus d'une méthode. Si ceci est fait, cURL interrogera
le serveur pour voir quelles sont les méthodes supportées et prendra
la meilleur.
</para>
<para>
<constant>CURLAUTH_ANY</constant> est un alias pour
<literal>CURLAUTH_BASIC | CURLAUTH_DIGEST | CURLAUTH_GSSNEGOTIATE | CURLAUTH_NTLM</literal>.
</para>
<para>
<constant>CURLAUTH_ANYSAFE</constant> est un alias pour
<literal>CURLAUTH_DIGEST | CURLAUTH_GSSNEGOTIATE | CURLAUTH_NTLM</literal>.
</para>
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_INFILESIZE</constant></entry>
<entry valign="top">
La taille attendue, en octets, du fichier lors du téléversemement
d'un fichier vers un site distant. Notez que l'utilisation de cette
option n'arrêtera pas libcurl d'envoyer plus de données,
de la même façon que ce qui est envoyé dépend de l'option
<constant>CURLOPT_READFUNCTION</constant>.
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_LOW_SPEED_LIMIT</constant></entry>
<entry valign="top">
La vitesse de transfert, en octets par secondes en dessous de laquelle,
et pendant <constant>CURLOPT_LOW_SPEED_TIME</constant> secondes,
PHP considérera qu'elle est trop lente, et annulera le transfert.
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_LOW_SPEED_TIME</constant></entry>
<entry valign="top">
Le temps en secondes, pendant lequel si le transfert reste en
dessous de <constant>CURLOPT_LOW_SPEED_LIMIT</constant>,
PHP considérera que la connexion est trop lente, et l'annulera.
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_MAXCONNECTS</constant></entry>
<entry valign="top">
Le nombre maximal de connexions persistantes autorisées.
Lorsque la limite est atteinte,
<constant>CURLOPT_CLOSEPOLICY</constant>
est utilisé pour déterminer quelle connexion à fermer.
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_MAXREDIRS</constant></entry>
<entry valign="top">
Le nombre maximal de redirections HTTP à suivre.
Utilisez cette option avec l'option <constant>CURLOPT_FOLLOWLOCATION</constant>.
Une valeur par défaut de <literal>20</literal> est définit pour prévenir
les redirections infinies.
Définir à <literal>-1</literal> permet les redirections infinies, et <literal>0</literal>
refuse toute redirection.
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_PORT</constant></entry>
<entry valign="top">
Un numéro de port alternatif auquel se connecter.
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_POSTREDIR</constant></entry>
<entry valign="top">
Un masque de bit de 1 (301 Moved Permanently), 2 (302 Found)
et 4 (303 See Other) si la méthode HTTP POST doit être maintenu
quand <constant>CURLOPT_FOLLOWLOCATION</constant> est défini et un
type spécifique de redirection se produit.
</entry>
<entry valign="top">
Ajouté dans cURL 7.19.1.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_PROTOCOLS</constant></entry>
<entry valign="top">
<para>
Champ de bits de valeurs <constant>CURLPROTO_*</constant>.
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.
Voir aussi <constant>CURLOPT_REDIR_PROTOCOLS</constant>.
</para>
<para>
Les options valides de protocoles sont :
<constant>CURLPROTO_HTTP</constant>,
<constant>CURLPROTO_HTTPS</constant>,
<constant>CURLPROTO_FTP</constant>,
<constant>CURLPROTO_FTPS</constant>,
<constant>CURLPROTO_SCP</constant>,
<constant>CURLPROTO_SFTP</constant>,
<constant>CURLPROTO_TELNET</constant>,
<constant>CURLPROTO_LDAP</constant>,
<constant>CURLPROTO_LDAPS</constant>,
<constant>CURLPROTO_DICT</constant>,
<constant>CURLPROTO_FILE</constant>,
<constant>CURLPROTO_TFTP</constant>,
<constant>CURLPROTO_ALL</constant>
</para>
</entry>
<entry valign="top">
Ajouté en cURL 7.19.4.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_PROXYAUTH</constant></entry>
<entry valign="top">
La méthode d'authentifucation HTTP à utiliser pour la connexion
à un proxy. Utilisez la même méthode que celle décrite dans
<constant>CURLOPT_HTTPAUTH</constant>.
Pour une identification avec un proxy, seuls
<constant>CURLAUTH_BASIC</constant> et
<constant>CURLAUTH_NTLM</constant> sont actuellement supportés.
</entry>
<entry valign="top">
Ajouté en CURL 7.10.7.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_PROXYPORT</constant></entry>
<entry valign="top">
Le numéro du port du proxy à utiliser pour la connexion.
Ce numéro de port peut également être défini dans
<constant>CURLOPT_PROXY</constant>.
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_PROXYTYPE</constant></entry>
<entry valign="top">
Soit <constant>CURLPROXY_HTTP</constant> (par défaut),
<constant>CURLPROXY_SOCKS4</constant>,
<constant>CURLPROXY_SOCKS5</constant>,
<constant>CURLPROXY_SOCKS4A</constant> ou
<constant>CURLPROXY_SOCKS5_HOSTNAME</constant>.
</entry>
<entry valign="top">
Ajouté en cURL 7.10.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_REDIR_PROTOCOLS</constant></entry>
<entry valign="top">
Masque de bits des valeurs <constant>CURLPROTO_*</constant>. S'il est
utilisé, ce masque limite les protocoles que libcurl peut utiliser dans
un transfert qu'il suit après une redirection lorsque
<constant>CURLOPT_FOLLOWLOCATION</constant> est activé.
Cela permet de limiter certains transferts spécifique à utiliser un sous
groupe des protocoles lors d'une redirection.
Par défaut, libcurl va autoriser tous les protocoles, hormis FILE et SCP.
Ceci est différent comparé aux versions antérieurs à 7.19.4 qui
suivaient inconditionnellement tous les protocoles supportés.
Voir aussi <constant>CURLOPT_PROTOCOLS</constant> pour les
valeurs des constantes de protocoles.
</entry>
<entry valign="top">
Ajoutés en cURL 7.19.4.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_RESUME_FROM</constant></entry>
<entry valign="top">
La position, en octets, où reprendre un transfert.
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_SOCKS5_AUTH</constant></entry>
<entry valign="top">
<para>
Les méthode(s) d'authentification SOCKS5 à utiliser. Les options
sont : <constant>CURLAUTH_BASIC</constant>,
<constant>CURLAUTH_GSSAPI</constant>,
<constant>CURLAUTH_NONE</constant>.
</para>
<para>
L'opérateur bit à bit <literal>|</literal> (ou) peut être combiné
pour utiliser plus d'une méthode. Si ceci est fait, cURL
interrogera le serveur pour voir quelles méthodes sont prises en
charge et choisir la meilleure.
</para>
<para>
<constant>CURLAUTH_BASIC</constant> autorise l'authentification
utilisateur/mot de passe.
</para>
<para>
<constant>CURLAUTH_GSSAPI</constant> autorise l'authentification
GSS-API.
</para>
<para>
<constant>CURLAUTH_NONE</constant> autorise aucune authentification.
</para>
<para>
Par défaut <literal>CURLAUTH_BASIC|CURLAUTH_GSSAPI</literal>.
Définir l'utilisateur actuel et mot de passe avec l'option
<constant>CURLOPT_PROXYUSERPWD</constant>.
</para>
</entry>
<entry valign="top">
Disponible à partir de PHP 7.3.0 et curl &gt;= 7.55.0.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_SSL_OPTIONS</constant></entry>
<entry valign="top">
Définit les options de comportement SSL, qui est un masque de bits des
constantes suivantes :
<simpara>
<constant>CURLSSLOPT_ALLOW_BEAST</constant> : n'essaye pas
d'utiliser des solutions de contournement pour une faille de
sécurité dans les protocoles SSL3 et TLS1.0.
</simpara>
<simpara>
<constant>CURLSSLOPT_NO_REVOKE</constant> : désactiver les
vérifications de révocation de certificats pour les serveurs SSL
où un tel comportement est présent.
</simpara>
</entry>
<entry valign="top">
Ajouté dans cURL 7.25.0. Disponible à partir de PHP 7.0.7.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_SSL_VERIFYHOST</constant></entry>
<entry valign="top">
<literal>2</literal> pour vérifier qu'un champ Common Name field ou
Subject Alternate Name dans le certificat SSL correspond avec le nom d'hôte fourni.
<literal>0</literal> pour ne pas vérifier les noms.
<literal>1</literal> ne devrait pas être utilisé.
Dans les environnement de production, la valeur de cette option
doit être conservée à <literal>2</literal> (valeur par défaut).
</entry>
<entry valign="top">
Support pour la valeur <literal>1</literal> supprimé en cURL 7.28.1
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_SSLVERSION</constant></entry>
<entry valign="top">
Une valeur parmi <constant>CURL_SSLVERSION_DEFAULT</constant> (0),
<constant>CURL_SSLVERSION_TLSv1</constant> (1),
<constant>CURL_SSLVERSION_SSLv2</constant> (2),
<constant>CURL_SSLVERSION_SSLv3</constant> (3),
<constant>CURL_SSLVERSION_TLSv1_0</constant> (4),
<constant>CURL_SSLVERSION_TLSv1_1</constant> (5) ou
<constant>CURL_SSLVERSION_TLSv1_2</constant> (6).
La version TLS maximale peut être définie en utilisant une des
constantes <constant>CURL_SSLVERSION_MAX_*</constant>. Il est aussi
possible de OU une des constantes <constant>CURL_SSLVERSION_*</constant>
avec une des constantes <constant>CURL_SSLVERSION_MAX_*</constant>.
<constant>CURL_SSLVERSION_MAX_DEFAULT</constant> (la version maximale
supporté par la bibliothèque),
<constant>CURL_SSLVERSION_MAX_TLSv1_0</constant>,
<constant>CURL_SSLVERSION_MAX_TLSv1_1</constant>,
<constant>CURL_SSLVERSION_MAX_TLSv1_2</constant>, ou
<constant>CURL_SSLVERSION_MAX_TLSv1_3</constant>.
<note>
<para>
Dans votre intérêt, il est préférable de ne pas définir cette
valeur et utiliser la valeur par défaut. Définir à 2 ou 3 est
très dangereux sachant le nombre de vulnérabilité présentes dans
SSLv2 et SSLv3.
</para>
</note>
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_PROXY_SSL_OPTIONS</constant></entry>
<entry valign="top">
Définit les options de comportement proxie SSL, qui est un masque
de bits des constantes suivantes :
<simpara>
<constant>CURLSSLOPT_ALLOW_BEAST</constant> : n'essaye pas
d'utiliser des solutions de contournement pour une faille de
sécurité dans les protocoles SSL3 et TLS1.0.
</simpara>
<simpara>
<constant>CURLSSLOPT_NO_REVOKE</constant> : désactiver les
vérifications de révocation de certificats pour les serveurs SSL
où un tel comportement est présent. (curl &gt;= 7.44.0)
</simpara>
<simpara>
<constant>CURLSSLOPT_NO_PARTIALCHAIN</constant> : n'accepte pas
des chaînes "partielles" de certificats, qui est sinon la valeur
par défaut. (curl &gt;= 7.68.0)
</simpara>
</entry>
<entry valign="top">
Disponible à partir de PHP 7.3.0 et libcurl &gt;= cURL 7.52.0.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_PROXY_SSL_VERIFYHOST</constant></entry>
<entry valign="top">
Définir à <literal>2</literal> pour vérifier dans le certificats du
proxie HTTPS les champs de nom contre le nom du proxie.
Quand définie à <literal>0</literal> la connexion succède peut
importe des noms utilisés dans le certificat.
Utilisez cette fonctionnalité avec précaution!
<literal>1</literal> est traité comme une option de debug dans curl
7.28.0 et antérieur. Entre curl 7.28.1 et 7.65.3
<constant>CURLE_BAD_FUNCTION_ARGUMENT</constant> est retourné.
À partir de curl 7.66.0 <literal>1</literal> et <literal>2</literal>
sont traité comme la même valeur. En environnement de production,
la valeur de cette option doit être conservée à <literal>2</literal>
(valeur par défaut).
</entry>
<entry valign="top">
Disponible à partir de PHP 7.3.0 et libcurl &gt;= cURL 7.52.0.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_PROXY_SSLVERSION</constant></entry>
<entry valign="top">
Une de <constant>CURL_SSLVERSION_DEFAULT</constant>,
<constant>CURL_SSLVERSION_TLSv1</constant>,
<constant>CURL_SSLVERSION_TLSv1_0</constant>,
<constant>CURL_SSLVERSION_TLSv1_1</constant>,
<constant>CURL_SSLVERSION_TLSv1_2</constant>,
<constant>CURL_SSLVERSION_TLSv1_3</constant>,
<constant>CURL_SSLVERSION_MAX_DEFAULT</constant>,
<constant>CURL_SSLVERSION_MAX_TLSv1_0</constant>,
<constant>CURL_SSLVERSION_MAX_TLSv1_1</constant>,
<constant>CURL_SSLVERSION_MAX_TLSv1_2</constant>,
<constant>CURL_SSLVERSION_MAX_TLSv1_3</constant> ou
<constant>CURL_SSLVERSION_SSLv3</constant>.
<note>
<para>
Dans votre intérêt, il est préférable de ne pas définir ceci
et de le laisser utiliser la valeur par défaut
<constant>CURL_SSLVERSION_DEFAULT</constant> qui tentera de
comprendre la version du protocole SSL distant.
</para>
</note>
</entry>
<entry valign="top">
Disponible à partir de PHP 7.3.0 et libcurl &gt;= cURL 7.52.0.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_STREAM_WEIGHT</constant></entry>
<entry valign="top">
Définit le poid numérique du flux (un nombre entre 1 et 256).
</entry>
<entry valign="top">
Ajouté dans cURL 7.46.0. Disponible à partir de PHP 7.0.7.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_TCP_KEEPALIVE</constant></entry>
<entry valign="top">
Si définie à <literal>1</literal>, Des sondes TCP keepalive seront
envoyées. Le délais et fréquence de ces sondes peut être controllé
par les options <constant>CURLOPT_TCP_KEEPIDLE</constant> et
<constant>CURLOPT_TCP_KEEPINTVL</constant>, à condition que le
système d'exploitation les supporte. Si définie à
<literal>0</literal> (par défaut) les sondes keepalive sont désactivées.
</entry>
<entry valign="top">
Ajouté dans cURL 7.25.0.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_TCP_KEEPIDLE</constant></entry>
<entry valign="top">
Définie le délais, en secondes, que le système d'exploitation
attendra pendent que la connexion est inoccupé, avant d'envoyer des
sondes keepalive, si <constant>CURLOPT_TCP_KEEPALIVE</constant> est
activé. Pas tout les systèmes d'exploitations supportent cette option.
La valeur par défaut est <literal>60</literal>.
</entry>
<entry valign="top">
Ajouté dans cURL 7.25.0.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_TCP_KEEPINTVL</constant></entry>
<entry valign="top">
Définie l'intervalle, en secondes, que le système d'exploitation
attendra entre les envoies des sondes keepalive, si
<constant>CURLOPT_TCP_KEEPALIVE</constant> est activé.
Pas tout les systèmes d'exploitations supportent cette option.
La valeur par défaut est <literal>60</literal>.
</entry>
<entry valign="top">
Ajouté dans cURL 7.25.0.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_TIMECONDITION</constant></entry>
<entry valign="top">
Comment <constant>CURLOPT_TIMEVALUE</constant> est traité.
Utiliser <constant>CURL_TIMECOND_IFMODSINCE</constant> pour retourner
la page uniquement si elle a été modifiée depuis le temps spécifié dans
<constant>CURLOPT_TIMEVALUE</constant>. Si elle n'a pas été modifiée,
un en-tête <literal>"304 Not Modified"</literal> sera retourné en
supposant que <constant>CURLOPT_HEADER</constant> vaut &true;.
Utiliser <constant>CURL_TIMECOND_IFUNMODSINCE</constant> pour faire
l'inverse. Utiliser <constant>CURL_TIMECOND_NONE</constant> pour
ignorer <constant>CURLOPT_TIMEVALUE</constant> et toujours
retourner la page. La valeur par défaut est
<constant>CURL_TIMECOND_NONE</constant>.
</entry>
<entry valign="top">
Antérieur à cURL 7.46.0 la valeur par défaut était
<constant>CURL_TIMECOND_IFMODSINCE</constant>.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_TIMEOUT</constant></entry>
<entry valign="top">
Le temps maximum d'exécution de la fonction cURL exprimé en secondes.
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_TIMEOUT_MS</constant></entry>
<entry valign="top">
Le nombre maximal de millisecondes autorisé aux fonctions cURL
pour l'exécution.
<!-- http://curl.haxx.se/libcurl/c/curl_easy_setopt.html -->
Si libcurl est compilé pour utiliser le système standard de résolution
de noms, cette partie de la connexion utilisera toujours la
seconde résolution pour le délai d'attente maximal avec un délai
d'attente maximal minimum autorisé d'une seconde.
</entry>
<entry valign="top">
Ajouté en cURL 7.16.2.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_TIMEVALUE</constant></entry>
<entry valign="top">
Le temps en secondes depuis le 1er janvier 1970. Le temps sera
utilisée par <constant>CURLOPT_TIMECONDITION</constant>.
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_TIMEVALUE_LARGE</constant></entry>
<entry valign="top">
Le temps en secondes depuis le 1er Janvier, 1970. Le temps sera
utilisé par <constant>CURLOPT_TIMECONDITION</constant>. Par défaut zéro.
La différence entre cette option et <constant>CURLOPT_TIMEVALUE</constant>
est le type d'argument. Sur les systèmes où 'long' est seulement
large de 32 bits, cette option doit être utilisé pour définir des
dates au delà de l'année 2038.
</entry>
<entry valign="top">
Ajouté dans cURL 7.59.0. Disponible à partir de PHP 7.3.0.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_MAX_RECV_SPEED_LARGE</constant></entry>
<entry valign="top">
Si un téléchargement excède cette vitesse (comptée en octets par seconde)
sur une moyenne cumulée durant le transfert, le transfert se mettra
en pause pour conserver la moyenne inférieure ou égales à la valeur
de ce paramètre. Par défaut, la vitesse est illimitée.
</entry>
<entry valign="top">
Ajouté en cURL 7.15.5.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_MAX_SEND_SPEED_LARGE</constant></entry>
<entry valign="top">
Si un téléversement excède cette vitesse (comptée en octets par seconde)
sur une moyenne cumulée durant le transfert, le transfert se mettra
en pause pour conserver la moyenne inférieure ou égales à la valeur
de ce paramètre. Par défaut, la vitesse est illimitée.
</entry>
<entry valign="top">
Ajouté en cURL 7.15.5.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_SSH_AUTH_TYPES</constant></entry>
<entry valign="top">
Un masque de bit constitué d'une ou plusieurs de :
<constant>CURLSSH_AUTH_PUBLICKEY</constant>,
<constant>CURLSSH_AUTH_PASSWORD</constant>,
<constant>CURLSSH_AUTH_HOST</constant>,
<constant>CURLSSH_AUTH_KEYBOARD</constant>. Définir à
<constant>CURLSSH_AUTH_ANY</constant> pour laisser libcurl choisir.
</entry>
<entry valign="top">
Ajouté en cURL 7.16.1.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_IPRESOLVE</constant></entry>
<entry valign="top">
Autorise une application à sélectionner le type d'adresse IP à utiliser
lors de la résolution des noms d'hôtes. Ceci n'est intéressant
que lors de l'utilisation des noms d'hôtes qui résolvent les adresses
en utilisant plus d'une version d'IP ; les valeurs possibles sont
<constant>CURL_IPRESOLVE_WHATEVER</constant>,
<constant>CURL_IPRESOLVE_V4</constant>,
<constant>CURL_IPRESOLVE_V6</constant> ; par défaut
<constant>CURL_IPRESOLVE_WHATEVER</constant>.
</entry>
<entry valign="top">
Ajouté en cURL 7.10.8.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_FTP_FILEMETHOD</constant></entry>
<entry valign="top">
Dit à curl quelle méthode à utiliser pour atteindre un fichier
sur un serveur FTP(S). Valeur possible sont
<constant>CURLFTPMETHOD_MULTICWD</constant>,
<constant>CURLFTPMETHOD_NOCWD</constant> et
<constant>CURLFTPMETHOD_SINGLECWD</constant>.
</entry>
<entry valign="top">
Ajouté en cURL 7.15.1.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</para>
<!-- reviewed until here by girgias 2019-03-27 -->
<para>
<parameter>value</parameter> doit être une &string; pour les
valeurs suivantes du paramètres <parameter>option</parameter> :
<informaltable>
<tgroup cols="3">
<thead>
<row>
<entry>Option</entry>
<entry>Définir <parameter>value</parameter> à</entry>
<entry>Notes</entry>
</row>
</thead>
<tbody>
<row>
<entry valign="top"><constant>CURLOPT_ABSTRACT_UNIX_SOCKET</constant></entry>
<entry valign="top">
Active l'usage d'un socket domaine Unix abstrait au lieu d'établir
une connexion TCP à un hôte et définie le chemin à la &string;
fournie. Cette option partage les mêmes sémantiques que
<constant>CURLOPT_UNIX_SOCKET_PATH</constant>. Ces deux options
partagent le même stockage et doc seul un des deux peut être définie
par gestionnaire.
</entry>
<entry valign="top">
Disponible à partir de PHP 7.3.0 et cURL 7.53.0
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_CAINFO</constant></entry>
<entry valign="top">
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
<constant>CURLOPT_SSL_VERIFYPEER</constant>.
</entry>
<entry valign="top">
Peut nécessiter un chemin absolu.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_CAPATH</constant></entry>
<entry valign="top">
Un dossier qui contient les certificats. Utilisez cette option
avec l'option <constant>CURLOPT_SSL_VERIFYPEER</constant>.
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_COOKIE</constant></entry>
<entry valign="top">
Le contenu de l'en-tête <literal>"Cookie: "</literal>, à
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., "<literal>fruit=pomme; couleur=rouge</literal>")
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_COOKIEFILE</constant></entry>
<entry valign="top">
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.
Si le nom est une chaîne de caractère vide, aucun cookie
n'est chargé, mais le gestionnaire est toujours actif.
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_COOKIEJAR</constant></entry>
<entry valign="top">
Le nom de fichier pour y sauvegarder tous les cookies internes lorsque
la connexion se ferme, par exemple après un appel à curl_close.
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_COOKIELIST</constant></entry>
<entry valign="top">
Une chaîne cookie (c.à.d. une seule ligne dans le format Netscape/Mozilla,
ou un en-tête de style HTTP régulier Set-Cookie) ajoute cet unique
cookie au stockage interne de cookie.
<literal>"ALL"</literal> efface tout les cookies tenu en mémoire.
<literal>"SESS"</literal> efface tout les cookies de session tenu en mémoire.
<literal>"FLUSH"</literal> écrit tout les connues dans le fichier
spécifié par <constant>CURLOPT_COOKIEJAR</constant>.
<literal>"RELOAD"</literal> charge tout les cookies depuis les fichiers
spécifié par <constant>CURLOPT_COOKIEFILE</constant>.
</entry>
<entry valign="top">
Disponible à partir de cURL 7.14.1.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_CUSTOMREQUEST</constant></entry>
<entry valign="top"><para>
Une méthode de requête qui sera utilisée à la place de <literal>"GET"</literal>
ou <literal>"HEAD"</literal> lors des requêtes HTTP. Cette commande est pratique pour
effectuer un <literal>"DELETE"</literal> ou une autre commande HTTP exotique.
Les valeurs valides sont <literal>"GET"</literal>, <literal>"POST"</literal>,
<literal>"CONNECT"</literal> et plus ;
i.e. n'entrez pas une requête HTTP complète ici. Par exemple,
entrer <literal>"GET /index.html HTTP/1.0\r\n\r\n"</literal> serait incorrect.
<note>
<para>
N'utilisez pas cette commande sans vous assurer que le serveur l'accepte.
</para>
</note>
</para></entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_DEFAULT_PROTOCOL</constant></entry>
<entry valign="top"><para>
Le protocole par défaut à utiliser si l'URL manque un nom de schème.
</para></entry>
<entry valign="top">
Ajouté en cURL 7.45.0. Disponible à partir de PHP 7.0.7.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_DNS_INTERFACE</constant></entry>
<entry valign="top"><para>
Définit le nom de l'interface réseau à laquelle le résolveur DNS doit se lier.
Ceci doit être un nom d'interface (pas une adresse).
</para></entry>
<entry valign="top">
Ajouté en cURL 7.33.0. Disponible à partir de PHP 7.0.7.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_DNS_LOCAL_IP4</constant></entry>
<entry valign="top"><para>
Définit l'adresse IPv4 locale à laquelle le résolveur DNS doit se lier.
L'argument devrait contenir une seule adresse numérique IPv4 sous &string;
</para></entry>
<entry valign="top">
Ajouté en cURL 7.33.0. Disponible à partir de PHP 7.0.7.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_DNS_LOCAL_IP6</constant></entry>
<entry valign="top"><para>
Définit l'adresse IPv6 locale à laquelle le résolveur DNS doit se lier.
L'argument devrait contenir une seule adresse numérique IPv6 sous &string;
</para></entry>
<entry valign="top">
Ajouté en cURL 7.33.0. Disponible à partir de PHP 7.0.7.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_EGDSOCKET</constant></entry>
<entry valign="top">
Comme <constant>CURLOPT_RANDOM_FILE</constant> excepté
que vous passez une chaîne qui contient un nom de fichier vers le socket
<literal>Entropy Gathering Daemon</literal>.
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_ENCODING</constant></entry>
<entry valign="top">
Le contenu des en-têtes <literal>"Accept-Encoding: "</literal>
et active le décodage de la réponse. Les encodages supportés sont
<literal>"identity"</literal>, <literal>"deflate"</literal> et
<literal>"gzip"</literal>. Si une chaîne vide <literal>""</literal> est utilisé,
un en-tête contenant tous les types d'encodage supportés est envoyé.
</entry>
<entry valign="top">
Ajouté en cURL 7.10.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_FTPPORT</constant></entry>
<entry valign="top">
La valeur qui sera utilisée pour récupérer l'adresse IP utilisée
pour l'instruction FTP "PORT". L'instruction PORT 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.
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_INTERFACE</constant></entry>
<entry valign="top">
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.
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_KEYPASSWD</constant></entry>
<entry valign="top">
Le mot de passé nécessaire pour utiliser la clé privée
<constant>CURLOPT_SSLKEY</constant> ou la clé privée
<constant>CURLOPT_SSH_PRIVATE_KEYFILE</constant>.
</entry>
<entry valign="top">
Added in cURL 7.16.1.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_KRB4LEVEL</constant></entry>
<entry valign="top">
Le degré de sécurité
KRB4 (Kerberos 4). Chacune des valeurs (dans l'ordre du plus petit au plus grand)
suivantes sont valides :
<literal>"clear"</literal>,
<literal>"safe"</literal>,
<literal>"confidential"</literal>,
<literal>"private".</literal>.
Si la chaîne passée ne correspond pas à une de ces valeurs,
la valeur <literal>"private"</literal> 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.
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_LOGIN_OPTIONS</constant></entry>
<entry valign="top">
Peut être utilisé pour définir des options de connexion spécifiques au
protocole, telles que le mécanisme d’authentification préféré via
"AUTH = NTLM" ou "AUTH = *", et doit être utilisé conjointement avec
l'option <constant>CURLOPT_USERNAME</constant>.
</entry>
<entry valign="top">
Ajouté en cURL 7.34.0. Disponible à partir de PHP 7.0.7.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_PINNEDPUBLICKEY</constant></entry>
<entry valign="top">
Définit la clé publique épinglée.
La &string; peut être le nom de fichier de votre clé publique épinglée.
Le format de fichier attendu est "PEM" ou "DER". La &string; peut
également être un nombre quelconque de hachages sha256 codés en base64,
précédés de "sha256//" et séparés par ";".
</entry>
<entry valign="top">
Ajouté en cURL 7.39.0. Disponible à partir de PHP 7.0.7.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_POSTFIELDS</constant></entry>
<entry valign="top">
<simpara>
Toutes les données à passer lors d'une opération de HTTP POST.
Ce paramètre peut être passé sous la forme d'une chaîne encodée URL, comme
'<literal>para1=val1&amp;para2=val2&amp;...</literal>' 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 <parameter>value</parameter> est un tableau,
l'en-tête <literal>Content-Type</literal> sera définie à
<literal>multipart/form-data</literal>.
</simpara>
<simpara>
Des fichiers peuvent être envoyé en utilisant
<classname>CURLFile</classname> ou <classname>CURLStringFile</classname>, dans quel cas
<parameter>value</parameter> doit être un tableau.
</simpara>
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_PRIVATE</constant></entry>
<entry valign="top">
Toutes les données devant être associées à ce descripteur cURL.
Ces données peuvent ensuite être récupérées avec l'option
<constant>CURLINFO_PRIVATE</constant> de
<function>curl_getinfo</function>. cURL ne fait rien avec ces données.
Lors de l'utilisation d'un multidescripteur cURL, ces données privées
sont généralement une clé unique pour identifier un descripteur cURL standard.
</entry>
<entry valign="top">
Ajouté en cURL 7.10.3.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_PRE_PROXY</constant></entry>
<entry valign="top">
Définie une &string; contenant le nom d'hôte ou addresse OP sous
notation décimale à point à utiliser en tant que pré-proxy que curl
se connecte avant qu'il se connecte au proxy HTTP(S) spécifié dans
l'option <constant>CURLOPT_PROXY</constant> pour la requête à venir.
Le pré-proxy peut uniquement être un proxy SOCKS et devrait être
préfixé avec <literal>[scheme]://</literal> pour spécifier quel type
de socks est utilisé.
Une addresse IPv6 numérique doit être écrit entre [crochet].
Définir le pré-proxy à une chaîne vide désactive explicitement
l'utilisation d'un pré-proxy.
Pour spécifier le numéro de port dans la chaîne, ajouter
<literal>:[port]</literal> à la fin du nom d'hôte. Le numéro de port
du proxy peut être optionellement définie avec l'option distincte
<constant>CURLOPT_PROXYPORT</constant>. Utilise le port 1080 pour
les proxies par défaut si aucun port n'a été spécifié.
</entry>
<entry valign="top">
Disponible à partir de PHP 7.3.0 et libcurl &gt;= cURL 7.52.0.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_PROXY</constant></entry>
<entry valign="top">
Le nom du proxy HTTP au tunnel qui le demande.
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_PROXY_SERVICE_NAME</constant></entry>
<entry valign="top">
Le nom du service d'authentification proxy.
</entry>
<entry valign="top">
Ajouté en cURL 7.34.0. Disponible à partir de PHP 7.0.7.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_PROXY_CAINFO</constant></entry>
<entry valign="top">
Le chemin vers le bundle d'autorité de certification (CA) du proxy.
Définir le chemin en tant que &string; nomant un fichier tenant un
ou plusieurs certificats pour vérifier le proxy HTTPS avec.
Cette option est pour se connecter à un proxy HTTPS, pas un serveur
HTTPS. Par défaut définit au chemin système où le bundle cacert de
libcurl est supposé être stocké.
</entry>
<entry valign="top">
Disponible à partir de PHP 7.3.0 et libcurl &gt;= cURL 7.52.0.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_PROXY_CAPATH</constant></entry>
<entry valign="top">
Le dossier tenant plusieurs certificats CA pour vérifier le proxy
HTTPS avec.
</entry>
<entry valign="top">
Disponible à partir de PHP 7.3.0 et libcurl &gt;= cURL 7.52.0.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_PROXY_CRLFILE</constant></entry>
<entry valign="top">
Définie le nom de fichier avec la concatenation de CRL (Certificate
Revocation List) en format PEM pour utiliser lors de la validation
de certificat qui se produit lors de l'échange SSL.
</entry>
<entry valign="top">
Disponible à partir de PHP 7.3.0 et libcurl &gt;= cURL 7.52.0.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_PROXY_KEYPASSWD</constant></entry>
<entry valign="top">
Définie la &string; a utiliser comme mot de passe nécessaire pour
uriliser la clé privée <constant>CURLOPT_PROXY_SSLKEY</constant>.
Vous n'avez jamais besoin d'une passphrase pour charger un certificat
mais vous en avez besoin d'un pour charger votre clé privée.
Cette option est pour se connecter à un proxy HTTPS, et non un
serveur HTTPS.
</entry>
<entry valign="top">
Disponible à partir de PHP 7.3.0 et libcurl &gt;= cURL 7.52.0.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_PROXY_PINNEDPUBLICKEY</constant></entry>
<entry valign="top">
Définie la clé pubique éplinglé pour le proxy HTTPS. La &string;
peut être le nom de fichier de votre clé publique. Le format de
fichier attendue est "PEM" ou "DER".
La &string; peut également être un nombre quelconque de hachages
sha256 encodés en base64 précédés de "sha256//" et séparé de ";"
</entry>
<entry valign="top">
Disponible à partir de PHP 7.3.0 et libcurl &gt;= cURL 7.52.0.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_PROXY_SSLCERT</constant></entry>
<entry valign="top">
Le nom de fichier de votre certificat client utilisé pour se connecter
au proxy HTTPS. Le format par défaut est "P12" sur Secure Transport
et "PEM" sur les autres moteurs, et peut être modifié avec
<constant>CURLOPT_PROXY_SSLCERTTYPE</constant>.
Avec NSS ou Secure Transport, ceci peut être le surnom du certificat
avec lequel vous souhaitez vous authentifier avec tel qu'il est
nommée dans la base de donnée sécurité.
Si vous voulez utiliser un fichier du dossier courrent, veuillez
le précédez avec le préfix "./", de l'ordre à éviter une confusion
avec le surnom.
</entry>
<entry valign="top">
Disponible à partir de PHP 7.3.0 et libcurl &gt;= cURL 7.52.0.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_PROXY_SSLCERTTYPE</constant></entry>
<entry valign="top">
Le format de vos certificats client utilisé lors de la connexion à
un proxy HTTPS. Les formats supporté sont "PEM" et "DER", sauf avec
Secure Transport. OpenSSL (version 0.9.3 et ultérieur) et Secure
Transport (sur iOS 5 ou ultérieur, ou OS X 10.7 ou ultérieur)
supportent aussi les fichier encodé PKCS#12. Par défaut "PEM".
</entry>
<entry valign="top">
Disponible à partir de PHP 7.3.0 et libcurl &gt;= cURL 7.52.0.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_PROXY_SSL_CIPHER_LIST</constant></entry>
<entry valign="top">
La liste des suites de chiffrement à utiliser pour la connexion au
proxy HTTPS. La liste doit être syntaxiquement correcte, elle
consiste de une ou plusieurs suites de chiffrement séparé par des
deux-points. Les virgules ou espaces sont aussi des séparateurs
acceptable mais les deux-points sont normalement utilisé, !, - et +
peuvent être utilisé comme des opérations.
</entry>
<entry valign="top">
Disponible à partir de PHP 7.3.0 et libcurl &gt;= cURL 7.52.0.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_PROXY_TLS13_CIPHERS</constant></entry>
<entry valign="top">
La liste des suites de chiffrement à utiliser pour la connexion TLS
1.3 à un proxy. La liste doit être syntaxiquement correcte, elle
consiste de une ou plusieurs suites de chiffrement séparé par des
deux-points. Cette option est actuellement seulement utilisé quand
curl est compilé pour utiliser OpenSSL 1.1.1 ou ultérieur.
Si vous utilisé un backend SSL différent vous pouvez essayer de
définir les suites de chiffrement TLS 1.3 en utilisant l'option
<constant>CURLOPT_PROXY_SSL_CIPHER_LIST</constant>.
</entry>
<entry valign="top">
Disponible à partir de PHP 7.3.0 et libcurl &gt;= cURL 7.61.0.
Disponible si compilé avec OpenSSL &gt;= 1.1.1.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_PROXY_SSLKEY</constant></entry>
<entry valign="top">
Le nom de fichier de votre clé privé utilisé pour se connecter au
proxy HTTPS. Le format par défaut est "PEM" et peut être modifié
avec <constant>CURLOPT_PROXY_SSLKEYTYPE</constant>.
(iOS et Mac OS X uniquement) Cette option est ignoré si curl est
compilé contre Secure Transport.
</entry>
<entry valign="top">
Disponible à partir de PHP 7.3.0 et libcurl &gt;= cURL 7.52.0.
Disponible si TLS est activé.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_PROXY_SSLKEYTYPE</constant></entry>
<entry valign="top">
Le format de votre clé privée. Format supporté sont "PEM", "DER" et "ENG".
</entry>
<entry valign="top">
Disponible à partir de PHP 7.3.0 et libcurl &gt;= cURL 7.52.0.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_PROXY_TLSAUTH_PASSWORD</constant></entry>
<entry valign="top">
Le mot de passe à utiliser pour la méthode d'authentification TLS
spécifié avec l'option <constant>CURLOPT_PROXY_TLSAUTH_TYPE</constant>.
Nécessite que l'option <constant>CURLOPT_PROXY_TLSAUTH_USERNAME</constant>
soit aussi définie.
</entry>
<entry valign="top">
Disponible à partir de PHP 7.3.0 et libcurl &gt;= cURL 7.52.0.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_PROXY_TLSAUTH_TYPE</constant></entry>
<entry valign="top">
La méthode d'authentification TLS utilisé pour la connexion HTTPS.
Méthode supporté est "SRP".
<note>
<para>
L'authentification Secure Remote Password (SRP) pour TLS fournit
une authentification mutuelle si les deux côté ont un secret
partagé. Pour utiliser TLS-SRP, vous devez aussi définir les
options <constant>CURLOPT_PROXY_TLSAUTH_USERNAME</constant> et
<constant>CURLOPT_PROXY_TLSAUTH_PASSWORD</constant>.
</para>
</note>
</entry>
<entry valign="top">
Disponible à partir de PHP 7.3.0 et libcurl &gt;= cURL 7.52.0.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_PROXY_TLSAUTH_USERNAME</constant></entry>
<entry valign="top">
Tusername à utiliser pour la méthode d'autenthification TLS du proxy
HTTPS spécifié avec l'option <constant>CURLOPT_PROXY_TLSAUTH_TYPE</constant>.
Nécessite que l'option <constant>CURLOPT_PROXY_TLSAUTH_PASSWORD</constant>
soit aussi définie.
</entry>
<entry valign="top">
Disponible à partir de PHP 7.3.0 et libcurl &gt;= cURL 7.52.0.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_PROXYUSERPWD</constant></entry>
<entry valign="top">
Un nom d'utilisateur et un mot de passe formatés sous la forme
<literal>"[username]:[password]"</literal> à utiliser
pour la connexion avec le proxy.
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_RANDOM_FILE</constant></entry>
<entry valign="top">
Un nom de fichier à utiliser pour interroger le générateur de nombre aléatoire pour SSL.
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_RANGE</constant></entry>
<entry valign="top">
La plage de valeurs à récupérer sous la forme <literal>"X-Y"</literal>,
où les valeurs de X ou Y peuvent être omises. Le transfert HTTP
supporte aussi plusieurs intervalles, séparés par
des virgules : <literal>"X-Y,N-M"</literal>.
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_REFERER</constant></entry>
<entry valign="top">
Le contenu de l'en-tête <literal>"Referer: "</literal> à utiliser
dans une requête HTTP.
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_SERVICE_NAME</constant></entry>
<entry valign="top">
Le nom du service d'authentification.
</entry>
<entry valign="top">
Ajouté en cURL 7.43.0. Disponible à partir de PHP 7.0.7.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_SSH_HOST_PUBLIC_KEY_MD5</constant></entry>
<entry valign="top">
Une chaîne contenant 32 digits hexédécimaux. La chaîne doit être la somme
MD5 de la clé publique de l'hôte distant, et libcurl rejètera la connexion
à l'hôte tant que les sommes MD5 ne corresponderont pas. Cette option n'est
valable que pour les transferts SCP et SFTP.
</entry>
<entry valign="top">
Ajouté en cURL 7.17.1.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_SSH_PUBLIC_KEYFILE</constant></entry>
<entry valign="top">
Le nom du fichier pour la clé publique. Si non utilisé, libcurl
utilisera pas défaut $HOME/.ssh/id_dsa.pub si la variable d'environnement
$HOME est définie, et seulement "id_dsa.pub" si HOME n'est pas définie.
</entry>
<entry valign="top">
Ajouté en cURL 7.16.1.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_SSH_PRIVATE_KEYFILE</constant></entry>
<entry valign="top">
Le nom du fichier pour la clé privée. Si non utilisé, libcurl
utilisera pas défaut $HOME/.ssh/id_dsa si la variable d'environnement
$HOME est définie, et seulement "id_dsa" si HOME n'est pas définie.
Si le fichier est protégé par un mot de passe, définissez le avec la
constante <constant>CURLOPT_KEYPASSWD</constant>.
</entry>
<entry valign="top">
Ajouté en cURL 7.16.1.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_SSL_CIPHER_LIST</constant></entry>
<entry valign="top">
Une liste de chiffrements à utiliser avec SSL. Par exemple,
<literal>RC4-SHA</literal> et <literal>TLSv1</literal> sont des listes
valides de chiffrements.
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_SSLCERT</constant></entry>
<entry valign="top">
Le nom de fichier du certificat, au format PEM.
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_SSLCERTPASSWD</constant></entry>
<entry valign="top">
Le mot de passe nécessaire
pour utiliser le certificat <constant>CURLOPT_SSLCERT</constant>.
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_SSLCERTTYPE</constant></entry>
<entry valign="top">
Le format de votre certificat. Les formats supportés sont
<literal>"PEM"</literal> (par défaut), <literal>"DER"</literal>,
et <literal>"ENG"</literal>.
À partir de OpenSSL 0.9.3, <literal>"P12"</literal> (pour fichiers
encodé PKCS#12) et aussi supporté.
</entry>
<entry valign="top">
Ajouté en cURL 7.9.3.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_SSLENGINE</constant></entry>
<entry valign="top">
L'identifiant pour le moteur de chiffrement de votre clé privée spécifié dans
<constant>CURLOPT_SSLKEY</constant>.
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_SSLENGINE_DEFAULT</constant></entry>
<entry valign="top">
L'identifiant pour le moteur de chiffrement utilisé pour les opérations
de chiffrement asymétrique.
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_SSLKEY</constant></entry>
<entry valign="top">
Un nom de fichier contenant votre clé privée SSL.
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_SSLKEYPASSWD</constant></entry>
<entry valign="top"><para>
Le mot de passe secret utilisé par votre clé SSL privée spécifié dans
<constant>CURLOPT_SSLKEY</constant>.
<note>
<para>
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é.
</para>
</note>
</para></entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_SSLKEYTYPE</constant></entry>
<entry valign="top">
Le type de votre clé SSL privée spécifié dans
<constant>CURLOPT_SSLKEY</constant>. Les types de clé
supportés sont <literal>"PEM"</literal> (par défaut),
<literal>"DER"</literal>,
et <literal>"ENG"</literal>.
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_TLS13_CIPHERS</constant></entry>
<entry valign="top">
La liste des suites de chiffrement à utiliser pour la connexion TLS
1.3. La liste doit être syntaxiquement correcte, elle consiste de
un ou plusieurs chaînes de suites de chiffrement séparé par des
deux-points.
Cette option est actuellement uniquement quand curl est compilé pour
utiliser OpenSSL 1.1.1 ou ultérieur.
Si vous utiliser un backend SSL différent vous pouvez essayer de
définir les suites de chiffrement TLS 1.3 en utilisant l'option
<constant>CURLOPT_SSL_CIPHER_LIST</constant>.
</entry>
<entry valign="top">
Disponible à partir de PHP 7.3.0 et libcurl &gt;= cURL 7.61.0.
Disponible quand compilé avec OpenSSL &gt;= 1.1.1.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_UNIX_SOCKET_PATH</constant></entry>
<entry valign="top">
Permet l’utilisation de sockets de domaine Unix en tant que point de
connexion et définit le chemin à la &string; fournit.
</entry>
<entry valign="top">
Ajouté en cURL 7.40.0. Disponible à partir de PHP 7.0.7.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_URL</constant></entry>
<entry valign="top">
L'URL à récupérer.
Vous pouvez aussi choisir cette valeur lors de l'appel à
<function>curl_init</function>.
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_USERAGENT</constant></entry>
<entry valign="top">
Le contenu de l'en-tête <literal>"User-Agent: "</literal> à utiliser
dans une requête HTTP.
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_USERNAME</constant></entry>
<entry valign="top">
Le nom d'utilisateur à utiliser lors de l'authentification.
</entry>
<entry valign="top">
Ajouté en cURL 7.19.1.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_PASSWORD</constant></entry>
<entry valign="top">
Le mot de passe à utiliser lors de l'authentification.
</entry>
<entry valign="top">
Ajouté en cURL 7.19.1.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_USERPWD</constant></entry>
<entry valign="top">
Un nom d'utilisateur et un mot de passe formatés sous la forme
<literal>"[username]:[password]"</literal> à utiliser pour la connexion.
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_XOAUTH2_BEARER</constant></entry>
<entry valign="top">
Spécifie le jeton d'accès OAuth 2.0.
</entry>
<entry valign="top">
Ajouté en cURL 7.33.0. Disponible à partir de PHP 7.0.7.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</para>
<para>
<parameter>value</parameter> doit être un &array; pour les valeurs suivantes
du paramètres <parameter>option</parameter> :
<informaltable>
<tgroup cols="3">
<thead>
<row>
<entry>Option</entry>
<entry>Définir <parameter>value</parameter> à</entry>
<entry>Notes</entry>
</row>
</thead>
<tbody>
<row>
<entry valign="top"><constant>CURLOPT_CONNECT_TO</constant></entry>
<entry valign="top">
Connecte à un hôte et à un port spécifiques au lieu de l'hôte et
du port de l'URL. Accepte un &array; de &string; ave le format
<literal>HOST:PORT:CONNECT-TO-HOST:CONNECT-TO-PORT</literal>.
</entry>
<entry valign="top">
Ajouté en cURL 7.49.0. Disponible à partir de PHP 7.0.7.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_HTTP200ALIASES</constant></entry>
<entry valign="top">
Un tableau de réponses HTTP 200 qui sera traité comme réponses valides et
non comme des erreurs.
</entry>
<entry valign="top">
Ajouté en CURL 7.10.3.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_HTTPHEADER</constant></entry>
<entry valign="top">
Un tableau de champs d'en-têtes HTTP à définir, au format
<code>
array('Content-type: text/plain', 'Content-length: 100')
</code>
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_POSTQUOTE</constant></entry>
<entry valign="top">
Un tableau de commandes FTP à exécuter sur le serveur après
que la requête FTP se soit exécutée.
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_PROXYHEADER</constant></entry>
<entry valign="top">
Un &array; d'en-têtes HTTP personalisé à passer aux proxies.
</entry>
<entry valign="top">
Ajouté en cURL 7.37.0. Disponible à partir de PHP 7.0.7.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_QUOTE</constant></entry>
<entry valign="top">
Un &array; de commandes FTP à exécuter sur le serveur avant la requête FTP.
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_RESOLVE</constant></entry>
<entry valign="top">
Fournissez une adresse personnalisée pour une paire hôte / port
spécifique. Un &array; de &string; de nom d'hôte, de port et d'adresse
IP, chaque élément étant séparé par deux-points. Dans le format :
<code>
array("example.com:80:127.0.0.1")
</code>
</entry>
<entry valign="top">
Ajouté en cURL 7.21.3.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</para>
<para>
<parameter>value</parameter> doit être une ressource (utilisant
<function>fopen</function>, par exemple) pour les valeurs suivantes
du paramètre <parameter>option</parameter> :
<informaltable>
<tgroup cols="3">
<thead>
<row>
<entry>Option</entry>
<entry>Définissez le paramètre <parameter>value</parameter> à</entry>
</row>
</thead>
<tbody>
<row>
<entry valign="top"><constant>CURLOPT_FILE</constant></entry>
<entry valign="top">
Le fichier où sera écrit le transfert. Par défaut,
<literal>STDOUT</literal> (la fenêtre du navigateur).
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_INFILE</constant></entry>
<entry valign="top">
Le fichier lu par le transfert lors du chargement.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_STDERR</constant></entry>
<entry valign="top">
Un chemin alternatif à utiliser pour afficher les erreurs au lieu de
<literal>STDERR</literal>.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_WRITEHEADER</constant></entry>
<entry valign="top">
Le fichier où sera écrit les parties d'en-tête du transfert.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</para>
<para>
<parameter>value</parameter> doit être le nom d'une fonction ou d'une Closure
valide pour les valeurs suivantes du paramètres <parameter>option</parameter> :
<informaltable>
<tgroup cols="3">
<thead>
<row>
<entry>Option</entry>
<entry>Définir <parameter>value</parameter> à</entry>
</row>
</thead>
<tbody>
<row>
<entry valign="top"><constant>CURLOPT_HEADERFUNCTION</constant></entry>
<entry valign="top">
Une fonction de rappel acceptant deux paramètres. Le premier est la
ressource cURL, le second, une chaîne de caractères avec
les données d'en-têtes à écrire. Ces données d'en-têtes doivent
être écrites par cette fonction de rappel. Le nombre d'octets
écrit sera retourné.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_PASSWDFUNCTION</constant></entry>
<entry valign="top">
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.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_PROGRESSFUNCTION</constant></entry>
<entry valign="top">
<para>
Une fonction de rappel qui prend cinq arguments. Le premier est la
ressource cURL, le second est le nombre total d'octets attendu à
télécharger pendant le transfert, le troisième est le nombre d'octets
téléchargés, le quatrième est le total d'octets attendu à uploader
pendant le transfert, et le cinquième est le nombre d'octets
uploadés.
</para>
<note>
<para>
The callback is only called when the <constant>CURLOPT_NOPROGRESS</constant>
option is set to &false;.
</para>
</note>
<para>
Return a non-zero value to abort the transfer. In which case, the
transfer will set a <constant>CURLE_ABORTED_BY_CALLBACK</constant>
error.
</para>
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_READFUNCTION</constant></entry>
<entry valign="top">
Une fonction de rappel qui prend trois paramètres.
Le premier est une ressource cURL, le second,
une ressource de flux fournie à cURL via l'option
<constant>CURLOPT_INFILE</constant>, et le troisième, la quantité
maximale de données à lire. La fonction de rappel doit retourner
une chaîne dont la taille est inférieure ou égale à la quantité
de données demandées, habituellement en les lisant depuis la ressource
de flux passée. Elle doit retourner une chaîne vide pour signaler
la fin <literal>EOF</literal>.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_WRITEFUNCTION</constant></entry>
<entry valign="top">
Une fonction de rappel qui 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 le transfert échouera avec une erreur.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</para>
<para>
Autres valeurs :
<informaltable>
<tgroup cols="3">
<thead>
<row>
<entry>Option</entry>
<entry>Définit le paramètre <parameter>value</parameter> en</entry>
</row>
</thead>
<tbody>
<row>
<entry valign="top"><constant>CURLOPT_SHARE</constant></entry>
<entry valign="top">
Un résultat de la fonction <function>curl_share_init</function>.
Fait que le gestionnaire cURL va utiliser les données depuis
le gestionnaire partagé.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
&return.success;
</para>
</refsect1>
<refsect1 role="changelog">
&reftitle.changelog;
<para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
&curl.changelog.handle-param;
<row>
<entry>7.3.15, 7.4.3</entry>
<entry>
Introduction de la constante
<constant>CURLOPT_HTTP09_ALLOWED</constant>.
</entry>
</row>
<row>
<entry>7.3.0</entry>
<entry>
Introduit <constant>CURLOPT_ABSTRACT_UNIX_SOCKET</constant>, <constant>CURLOPT_KEEP_SENDING_ON_ERROR</constant>,
<constant>CURLOPT_PRE_PROXY</constant>, <constant>CURLOPT_PROXY_CAINFO</constant>,
<constant>CURLOPT_PROXY_CAPATH</constant>, <constant>CURLOPT_PROXY_CRLFILE</constant>,
<constant>CURLOPT_PROXY_KEYPASSWD</constant>, <constant>CURLOPT_PROXY_PINNEDPUBLICKEY</constant>,
<constant>CURLOPT_PROXY_SSLCERT</constant>, <constant>CURLOPT_PROXY_SSLCERTTYPE</constant>,
<constant>CURLOPT_PROXY_SSL_CIPHER_LIST</constant>, <constant>CURLOPT_PROXY_SSLKEY</constant>,
<constant>CURLOPT_PROXY_SSLKEYTYPE</constant>, <constant>CURLOPT_PROXY_SSL_OPTIONS</constant>,
<constant>CURLOPT_PROXY_SSL_VERIFYHOST</constant>, <constant>CURLOPT_PROXY_SSL_VERIFYPEER</constant>,
<constant>CURLOPT_PROXY_SSLVERSION</constant>, <constant>CURLOPT_PROXY_TLSAUTH_PASSWORD</constant>,
<constant>CURLOPT_PROXY_TLSAUTH_TYPE</constant>, <constant>CURLOPT_PROXY_TLSAUTH_USERNAME</constant>,
<constant>CURLOPT_SOCKS5_AUTH</constant>, <constant>CURLOPT_SUPPRESS_CONNECT_HEADERS</constant>,
<constant>CURLOPT_DISALLOW_USERNAME_IN_URL</constant>, <constant>CURLOPT_DNS_SHUFFLE_ADDRESSES</constant>,
<constant>CURLOPT_HAPPY_EYEBALLS_TIMEOUT_MS</constant>, <constant>CURLOPT_HAPROXYPROTOCOL</constant>,
<constant>CURLOPT_PROXY_TLS13_CIPHERS</constant>, <constant>CURLOPT_SSH_COMPRESSION</constant>,
<constant>CURLOPT_TIMEVALUE_LARGE</constant> et <constant>CURLOPT_TLS13_CIPHERS</constant>.
</entry>
</row>
<row>
<entry>7.0.7</entry>
<entry>
Introduit <constant>CURL_HTTP_VERSION_2</constant>, <constant>CURL_HTTP_VERSION_2_PRIOR_KNOWLEDGE</constant>,
<constant>CURL_HTTP_VERSION_2TLS</constant>, <constant>CURL_REDIR_POST_301</constant>,
<constant>CURL_REDIR_POST_302</constant>, <constant>CURL_REDIR_POST_303</constant>,
<constant>CURL_REDIR_POST_ALL</constant>, <constant>CURL_VERSION_KERBEROS5</constant>,
<constant>CURL_VERSION_PSL</constant>, <constant>CURL_VERSION_UNIX_SOCKETS</constant>,
<constant>CURLAUTH_NEGOTIATE</constant>, <constant>CURLAUTH_NTLM_WB</constant>,
<constant>CURLFTP_CREATE_DIR</constant>, <constant>CURLFTP_CREATE_DIR_NONE</constant>,
<constant>CURLFTP_CREATE_DIR_RETRY</constant>, <constant>CURLHEADER_SEPARATE</constant>,
<constant>CURLHEADER_UNIFIED</constant>, <constant>CURLMOPT_CHUNK_LENGTH_PENALTY_SIZE</constant>,
<constant>CURLMOPT_CONTENT_LENGTH_PENALTY_SIZE</constant>, <constant>CURLMOPT_MAX_HOST_CONNECTIONS</constant>,
<constant>CURLMOPT_MAX_PIPELINE_LENGTH</constant>, <constant>CURLMOPT_MAX_TOTAL_CONNECTIONS</constant>,
<constant>CURLOPT_CONNECT_TO</constant>, <constant>CURLOPT_DEFAULT_PROTOCOL</constant>,
<constant>CURLOPT_DNS_INTERFACE</constant>, <constant>CURLOPT_DNS_LOCAL_IP4</constant>,
<constant>CURLOPT_DNS_LOCAL_IP6</constant>, <constant>CURLOPT_EXPECT_100_TIMEOUT_MS</constant>,
<constant>CURLOPT_HEADEROPT</constant>, <constant>CURLOPT_LOGIN_OPTIONS</constant>,
<constant>CURLOPT_PATH_AS_IS</constant>, <constant>CURLOPT_PINNEDPUBLICKEY</constant>,
<constant>CURLOPT_PIPEWAIT</constant>, <constant>CURLOPT_PROXY_SERVICE_NAME</constant>,
<constant>CURLOPT_PROXYHEADER</constant>, <constant>CURLOPT_SASL_IR</constant>,
<constant>CURLOPT_SERVICE_NAME</constant>, <constant>CURLOPT_SSL_ENABLE_ALPN</constant>,
<constant>CURLOPT_SSL_ENABLE_NPN</constant>, <constant>CURLOPT_SSL_FALSESTART</constant>,
<constant>CURLOPT_SSL_VERIFYSTATUS</constant>, <constant>CURLOPT_STREAM_WEIGHT</constant>,
<constant>CURLOPT_TCP_FASTOPEN</constant>, <constant>CURLOPT_TFTP_NO_OPTIONS</constant>,
<constant>CURLOPT_UNIX_SOCKET_PATH</constant>, <constant>CURLOPT_XOAUTH2_BEARER</constant>,
<constant>CURLPROTO_SMB</constant>, <constant>CURLPROTO_SMBS</constant>,
<constant>CURLPROXY_HTTP_1_0</constant>, <constant>CURLSSH_AUTH_AGENT</constant> et
<constant>CURLSSLOPT_NO_REVOKE</constant>.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>Initialisation d'une nouvelle session CURL et recherche d'une page Web</title>
<programlisting role="php">
<![CDATA[
<?php
// Création d'une ressource cURL
$ch = curl_init();
// Définition de l'URL et autres options appropriées
curl_setopt($ch, CURLOPT_URL, "http://www.example.com/");
curl_setopt($ch, CURLOPT_HEADER, false);
// Récupération de l'URL et passage au navigateur
curl_exec($ch);
// Fermeture de la ressource cURL et libération des ressources systèmes
curl_close($ch);
?>
]]>
</programlisting>
</example>
</para>
</refsect1>
<refsect1 role="notes">
&reftitle.notes;
<note>
<para>
Le fait de passer un tableau à la constante
<constant>CURLOPT_POSTFIELDS</constant> encodera les données comme
<emphasis><literal>multipart/form-data</literal></emphasis>, tandis que le fait de passer
une chaîne encodée URL encodera les données comme
<emphasis><literal>application/x-www-form-urlencoded</literal></emphasis>.
</para>
</note>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>curl_setopt_array</function></member>
<member><classname>CURLFile</classname></member>
<member><classname>CURLStringFile</classname></member>
</simplelist>
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->
Reference in New Issue View Git Blame Copy Permalink