Constantes pré-définies

Active l'utilisation d'un socket Unix abstrait à la place d'établir une connexion TCP à un hôte et définit le chemin donné en string. Cette option partage les mêmes sémantiques que CURLOPT_UNIX_SOCKET_PATH. Ces deux options partagent le même stockage et donc une seule d'entre elles peut être définie par un gestionnaire. Disponible depuis PHP 7.3.0 et cURL 7.53.0

Passer le nom de fichier pour que cURL utilise comme cache Alt-Svc pour lire le contenu du cache existant et éventuellement le réécrire après un transfert, à moins que CURLALTSVC_READONLYFILE ne soit défini via CURLOPT_ALTSVC_CTRL. Disponible depuis PHP 8.2.0 et cURL 7.64.1.

Peuple le masque de bits avec le bon ensemble de fonctionnalités pour indiquer à cURL comment gérer Alt-Svc pour les transferts utilisant ce gestionnaire. cURL n'accepte que les en-têtes Alt-Svc sur HTTPS. Il ne complétera également une demande à une origine alternative que si cette origine est correctement hébergée sur HTTPS. Définir un bit activera le moteur alt-svc. Les options sont : Populate the bitmask with the correct set of features to instruct cURL how to handle Alt-Svc for the CURLALTSVC_H1, CURLALTSVC_H2, CURLALTSVC_H3, et CURLALTSVC_READONLYFILE. Disponible depuis PHP 8.2.0 et cURL 7.64.1.

true pour définir automatiquement le champ Referer: dans les requêtes où il suit une redirection Location:.

Apporte une authentification de signature AWS V4 sur l'en-tête HTTP(S). Cette option remplace tout autre type d'authentification qui a été défini dans CURLOPT_HTTPAUTH. Cette méthode ne peut pas être combinée avec d'autres types d'authentification. Disponible depuis PHP 8.2.0 et cURL 7.75.0

Une taille de tampon à utiliser pour chaque lecture. Il n'y a aucune garantie que cette demande sera satisfaite, cependant. Disponible depuis cURL 7.10.

Le nom d'un fichier contenant un ou plusieurs certificats pour vérifier le pair avec. Cela n'a de sens que lorsqu'il est utilisé en combinaison avec CURLOPT_SSL_VERIFYPEER. Peut nécessiter un chemin absolu.

Le nom d'un fichier PEM contenant un ou plusieurs certificats pour vérifier le pair avec. Cette option remplace CURLOPT_CAINFO.

Un répertoire qui contient plusieurs certificats CA. Utilisez cette option en combinaison avec CURLOPT_SSL_VERIFYPEER.

Disponible depuis PHP 8.3.0 et cURL 7.87.0

true pour sortir des informations sur le certificat SSL sur STDERR sur les transferts sécurisés. Ajouté dans cURL 7.19.1. Nécessite CURLOPT_VERBOSE pour avoir un effet.

Le nombre de secondes à attendre lors de la tentative de connexion. Utilisez 0 pour attendre indéfiniment.

Le nombre de millisecondes à attendre lors de la tentative de connexion. Utilisez 0 pour attendre indéfiniment. Si libcurl est compilé pour utiliser le résolveur de noms système standard, cette partie de la connexion utilisera toujours une résolution à la seconde complète pour les délais d'attente avec un délai d'attente minimum autorisé d'une seconde. Disponible depuis cURL 7.16.2.

true pour indiquer à la librairie de ne pas effectuer d'authentification de proxy et de configuration de connexion requise, mais pas de transfert de données. Cette option est implémentée pour HTTP, SMTP et POP3. Disponible depuis cURL 7.15.2.

Connecte à un hôte et un port spécifiques au lieu de l'hôte et du port de l'URL. Accepte un tableau de chaînes avec le format HOST:PORT:CONNECT-TO-HOST:CONNECT-TO-PORT. Disponible depuis PHP 7.0.7 et cURL 7.49.0

Le contenu de l'en-tête "Cookie: " à utiliser dans la requête HTTP. Il est à noter que plusieurs cookies sont séparés par un point-virgule suivi d'un espace (par exemple, fruit=apple; colour=red)

Le nom du fichier contenant les données des cookies. Le fichier de cookies peut être au format Netscape, ou simplement des en-têtes HTTP classiques vidés dans un fichier. Si le nom est une chaîne vide, aucun cookie n'est chargé, mais la gestion des cookies est toujours activée.

Le nom du fichier pour sauvegarder tous les cookies internes lorsque le gestionnaire destructeur est appelé.

Une chaîne de caractères de cookies (c'est-à-dire une seule ligne dans le format Netscape/Mozilla, ou un en-tête Set-Cookie HTTP régulier) ajoute ce cookie unique au stockage interne des cookies. "ALL" efface tous les cookies stockés en mémoire. "SESS" efface tous les cookies de session stockés en mémoire. "FLUSH" écrit tous les cookies connus dans le fichier spécifié par CURLOPT_COOKIEJAR. "RELOAD" charge tous les cookies des fichiers spécifiés par CURLOPT_COOKIEFILE. Disponible depuis cURL 7.14.1

true pour marquer ceci comme une nouvelle "session" de cookie. Cela forcera libcurl à ignorer tous les cookies qu'il est sur le point de charger qui sont des "cookies de session" de la session précédente. Par défaut, libcurl stocke et charge toujours tous les cookies, indépendamment du fait qu'ils soient des cookies de session ou non. Les cookies de session sont des cookies sans date d'expiration et ils sont censés être vivants et existants pour cette "session" uniquement.

true pour convertir les fins de ligne Unix en fins de ligne CRLF sur les transferts.

Une méthode de requête personnalisée à utiliser à la place de "GET" ou "HEAD" lors de la réalisation d'une requête HTTP. Ceci est utile pour effectuer des requêtes HTTP plus obscures comme "DELETE" ou autres. Les valeurs valides sont des choses comme "GET", "POST", "CONNECT" et ainsi de suite; c'est-à-dire ne pas entrer une ligne de requête HTTP entière ici. Par exemple, entrer "GET /index.html HTTP/1.0\r\n\r\n" serait incorrect.

Note:

Ne pas faire cela sans vous assurer que le serveur supporte la méthode de requête personnalisée en premier.

Le protocole par défaut à utiliser si l'URL manque d'un nom de schéma. Disponible depuis PHP 7.0.7 et cURL 7.45.0

true pour ne pas autoriser les URL qui incluent un nom d'utilisateur. Les noms d'utilisateur sont autorisés par défaut (0). Disponible depuis PHP 7.3.0 et cURL 7.61.0

Le nombre de secondes à conserver les entrées DNS en mémoire. Cette option est définie par défaut à 120 (2 minutes).

Définit le nom de l'interface réseau que le résolveur DNS doit lier. Cela doit être un nom d'interface (pas une adresse). Disponible depuis PHP 7.0.7 et cURL 7.33.0

Définit l'adresse IPv4 locale à laquelle le résolveur doit se lier. L'argument doit contenir une seule adresse IPv4 numérique sous forme de chaîne. Disponible depuis PHP 7.0.7 et cURL 7.33.0

Définit l'adresse IPv6 locale à laquelle le résolveur doit se lier. L'argument doit contenir une seule adresse IPv6 numérique sous forme de chaîne.

true pour mélanger l'ordre de toutes les adresses retournées afin qu'elles soient utilisées dans un ordre aléatoire, lorsqu'un nom est résolu et que plus d'une adresse IP est retournée. Cela peut entraîner l'utilisation d'IPv4 avant IPv6 ou vice versa. Disponible depuis PHP 7.3.0 et cURL 7.60.0

true pour utiliser un cache DNS global. Cette option n'est pas thread-safe. Elle est activée par défaut si PHP est compilé pour une utilisation non threadée (CLI, FCGI, Apache2-Prefork, etc.).

Vérifie le champ de nom du certificat SSL du serveur DNS-over-HTTPS par rapport au nom d'hôte. Disponible depuis PHP 8.2.0 et cURL 7.76.0.

Vérifie l'authenticité du certificat SSL du serveur DNS-over-HTTPS. Disponible depuis PHP 8.2.0 et cURL 7.76.0.

Dit à cURL de vérifier le statut du certificat du serveur DNS-over-HTTPS en utilisant l'extension TLS "Certificate Status Request" (OCSP stapling). Disponible depuis PHP 8.2.0 et cURL 7.76.0.

Apporte l'URL DNS-over-HTTPS. Disponible depuis PHP 8.1.0 et cURL 7.62.0.

Comme CURLOPT_RANDOM_FILE excepté que vous passez une chaîne qui contient un nom de fichier vers le socket Entropy Gathering Daemon.

Le contenu des en-têtes "Accept-Encoding: ". Cela permet de décoder la réponse. Les encodages supportés sont "identity", "deflate", et "gzip". Si une chaîne vide, "", est définie, un en-tête contenant tous les types d'encodage supportés est envoyé. Disponible depuis cURL 7.10.

Le délais d'attente pour les réponses Expect: 100-continue en millisecondes. Par défaut, 1000 millisecondes. Disponible depuis PHP 7.0.7 et cURL 7.36.0

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.

Le fichier dans lequel le transfert doit être écrit. La valeur par défaut est STDOUT (la fenêtre du navigateur).

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 CURLINFO_FILETIME avec curl_getinfo().

true pour suivre tous les en-têtes "Location: " envoyés par le serveur dans la réponse HTTP. Voir aussi CURLOPT_MAXREDIRS. Cette constante n'est pas disponible lorsque open_basedir est activé.

true pour forcer à fermer explicitement la connexion lorsque le processus est terminé, elle ne sera donc pas mise en cache pour réutilisation.

true pour forcer l'utilisation d'une nouvelle connexion au lieu d'une connexion mise en cache.

true pour ajouter au fichier distant au lieu de l'écraser.

Un alias de CURLOPT_TRANSFERTEXT. Utilisez plutôt cela.

true pour seulement lister les noms d'un répertoire FTP.

La valeur qui sera utilisée pour obtenir l'adresse IP à utiliser pour l'instruction FTP "PORT". L'instruction "PORT" indique au serveur distant de se connecter à notre adresse IP spécifiée. La chaîne peut être une adresse IP simple, un nom d'hôte, un nom d'interface réseau (sous Unix), ou juste un '-' pour utiliser l'adresse IP par défaut du système.

L'authentification FTP (quand elle est activée): CURLFTPAUTH_SSL (essayer SSL en premier), CURLFTPAUTH_TLS (essayer TLS en premier), ou CURLFTPAUTH_DEFAULT (laisser cURL décider). Disponible depuis cURL 7.12.2.

true pour créer les répertoires manquants lorsqu'une opération FTP rencontre un chemin qui n'existe pas actuellement.

Indique à curl quelle méthode utiliser pour atteindre un fichier sur un serveur FTP(S). Les valeurs possibles sont CURLFTPMETHOD_DEFAULT, CURLFTPMETHOD_MULTICWD, CURLFTPMETHOD_NOCWD, et CURLFTPMETHOD_SINGLECWD. Disponible depuis cURL 7.15.1.

true pour utiliser EPRT (et LPRT) lors des téléchargements FTP actifs. Utilisez false pour désactiver EPRT et LPRT et utiliser PORT uniquement.

true pour essayer d'envoyer un commande EPSV pour les transferts FTP avant de revenir à PASV. Mettez à false pour désactiver EPSV.

Une avance pour IPv6 pour l'algorithme Happy Eyeballs. Happy Eyeballs tente de se connecter à la fois aux adresses IPv4 et IPv6 pour les hôtes double-stack, en préférant IPv6 en premier pour les millisecondes de délai d'attente. Par défaut à CURL_HET_DEFAULT, qui est actuellement de 200 millisecondes. Disponible depuis PHP 7.3.0 et cURL 7.59.0

true pour envoyer un en-tête de protocole HAProxy PROXY v1 au début de la connexion. L'action par défaut est de ne pas envoyer cet en-tête. Disponible depuis PHP 7.3.0 et cURL 7.60.0

true pour inclure l'en-tête dans la sortie.

Une fonction de rappel acceptant deux paramètres. Le premier est la ressource cURL, le second est une chaîne avec les données d'en-tête à écrire. Les données d'en-tête doivent être écrites par ce rappel. Retourne le nombre de bytes écrits.

Les valeurs possibles sont CURLHEADER_UNIFIED ou CURLHEADER_SEPARATE. Défaut à CURLHEADER_SEPARATE depuis cURL 7.42.1, et CURLHEADER_UNIFIED avant. Disponible depuis PHP 7.0.7 et cURL 7.37.0

Le nom du fichier de cache HSTS (HTTP Strict Transport Security). Disponible depuis PHP 8.2.0 et cURL 7.74.0

Contrôle le comportement HSTS (HTTP Strict Transport Security). Rempli le masque de bits avec le bon ensemble de fonctionnalités pour indiquer à cURL comment gérer HSTS pour les transferts utilisant ce gestionnaire. CURLHSTS_ENABLE active le cache HSTS en mémoire. Si le fichier de cache HSTS est défini, définissez CURLHSTS_READONLYFILE pour rendre le fichier en lecture seule. Disponible depuis PHP 8.2.0 et cURL 7.74.0

Si on autorise les réponses HTTP/0.9. Par défaut à false depuis cURL 7.66.0; avant, c'était true. Disponible depuis PHP 7.3.15 et 7.4.3, respectivement, et cURL 7.64.0

Un tableau de réponses HTTP 200 qui seront traitées comme valides et non comme des erreurs. Disponible depuis cURL 7.10.3.

La méthode d'authentification HTTP à utiliser. Les options sont : CURLAUTH_BASIC, CURLAUTH_DIGEST, CURLAUTH_GSSNEGOTIATE, CURLAUTH_NTLM, CURLAUTH_AWS_SIGV4, CURLAUTH_ANY, et CURLAUTH_ANYSAFE. L'opérateur binaire | (ou) peut être utilisé pour combiner plus d'une méthode. Si cela est fait, cURL interrogera le serveur pour voir quelles méthodes il supporte et choisira la meilleure. CURLAUTH_ANY définit tous les bits. cURL sélectionnera automatiquement celle qu'il trouve la plus sécurisée.

true pour réinitialiser la méthode de requête HTTP en GET. Puisque GET est la valeur par défaut, cela n'est nécessaire que si la méthode de requête a été changée.

Un tableau de champs d'en-tête HTTP à définir. Ce tableau doit être au format array('Content-type: text/plain', 'Content-length: 100')

true pour tunneliser à travers un proxy HTTP donné.

false pour désactiver le décodage automatique du contenu de réponse. Disponible depuis cURL 7.16.2.

CURL_HTTP_VERSION_NONE (défaut, laisse CURL décider quelle version utiliser), CURL_HTTP_VERSION_1_0 (force HTTP/1.0), CURL_HTTP_VERSION_1_1 (force HTTP/1.1), CURL_HTTP_VERSION_2_0 (essaye HTTP 2), CURL_HTTP_VERSION_2 (alias de CURL_HTTP_VERSION_2_0), CURL_HTTP_VERSION_2TLS (essaye HTTP 2 sur TLS (HTTPS) seulement) ou CURL_HTTP_VERSION_2_PRIOR_KNOWLEDGE (envoie des requêtes HTTP/2 sans TLS sans mise à niveau HTTP/1.1).

Le fichier à partir duquel la transfert doit être lu lors de l'envoi.

La taille attendue, en octets, du fichier lors de l'envoi d'un fichier à un site distant. Il est à noter que l'utilisation de cette option n'empêchera pas cURL d'envoyer plus de données, car ce qui est envoyé dépend exactement de CURLOPT_READFUNCTION.

Le nom de l'interface réseau sortante à utiliser. Cela peut être un nom d'interface, une adresse IP ou un nom d'hôte.

Autorise une application à sélectionner le type d'adresses IP à utiliser lors de la résolution des noms d'hôtes. Ceci est seulement intéressant lors de l'utilisation de noms d'hôtes qui résolvent des adresses en utilisant plus d'une version d'IP, les valeurs possibles sont CURL_IPRESOLVE_WHATEVER, CURL_IPRESOLVE_V4, CURL_IPRESOLVE_V6, par défaut CURL_IPRESOLVE_WHATEVER. Disponible depuis cURL 7.10.8.

Emetteur du certificat SSL à partir du blob de mémoire. Disponible depuis PHP 8.1.0 et cURL 7.71.0.

true pour continuer à envoyer le corps de la requête si le code HTTP retourné est égal ou supérieur à 300. L'action par défaut serait d'arrêter l'envoi et de fermer le flux ou la connexion. Convient pour l'authentification NTLM manuelle. La plupart des applications n'ont pas besoin de cette option. Disponible depuis PHP 7.3.0 et cURL 7.51.0

Le mot de passe requis pour utiliser la clé privée spécifiée par CURLOPT_SSLKEY ou CURLOPT_SSH_PRIVATE_KEYFILE. Disponible depuis cURL 7.16.1.

La sécurité KRB4 (Kerberos 4). Toute valeur suivante (dans l'ordre du moins au plus puissant) est valide : "clear", "safe", "confidential", "private".. Si la chaîne ne correspond pas à l'une de ces valeurs, "private" est utilisé. Définir cette option à null désactivera la sécurité KRB4. Actuellement, la sécurité KRB4 ne fonctionne qu'avec les transactions FTP.

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é en conjonction avec l'option CURLOPT_USERNAME. Disponible depuis PHP 7.0.7 et cURL 7.34.0

La vitesse de transfert, en octets par seconde, que le transfert doit être inférieur pendant le compte de CURLOPT_LOW_SPEED_TIME secondes avant que PHP ne considère le transfert trop lent et l'interrompe.

Le nombre de secondes que la vitesse de transfert doit être inférieure à CURLOPT_LOW_SPEED_LIMIT avant que PHP ne considère le transfert trop lent et l'interrompe.

Disponible depuis PHP 8.2.0 et cURL 7.69.0

Le temps maximum d'inactivité autorisé pour une connexion existante pour être considérée pour réutilisation. Par défaut, l'âge maximum est défini à 118 secondes. Disponible depuis PHP 8.2.0 et cURL 7.65.0

Le maximum de connexions persistantes autorisées. Lorsque la limite est atteinte, la plus ancienne dans le cache est fermée pour empêcher l'augmentation du nombre de connexions ouvertes.

La taille maximale en octets autorisée pour le téléchargement. Si le fichier demandé est trouvé plus grand que cette valeur, le transfert ne démarrera pas et CURLE_FILESIZE_EXCEEDED sera retourné. La taille du fichier n'est pas toujours connue avant le téléchargement, et pour de tels fichiers cette option n'a aucun effet même si le transfert de fichier finit par être plus grand que cette limite donnée. Disponible depuis PHP 8.2.0 et cURL 7.11.0

Le temps maximum en secondes, depuis la création de la connexion, autorisé pour une connexion existante pour être considérée pour réutilisation. Si une connexion est trouvée dans le cache qui est plus ancienne que cette valeur, elle sera plutôt fermée une fois que tous les transferts en cours sont terminés. Par défaut à 0 secondes, ce qui signifie que l'option est désactivée et que toutes les connexions sont éligibles pour réutilisation. Disponible depuis PHP 8.2.0 et cURL 7.80.0

La quantité maximale de redirections HTTP à suivre. Utilisez cette option aux côtés de CURLOPT_FOLLOWLOCATION. La valeur par défaut de 20 est définie pour éviter les redirections infinies. Définir à -1 permet les redirections infinies, et 0 refuse toutes les redirections.

Si un téléchargement dépasse cette vitesse (comptée en octets par seconde) en moyenne cumulative pendant le transfert, le transfert sera mis en pause pour maintenir la vitesse moyenne inférieure ou égale à la valeur du paramètre. La valeur par défaut est une vitesse illimitée. Disponible depuis cURL 7.15.5

Si un téléversement dépasse cette vitesse (comptée en octets par seconde) en moyenne cumulative pendant le transfert, le transfert sera mis en pause pour maintenir la vitesse moyenne inférieure ou égale à la valeur du paramètre. La valeur par défaut est une vitesse illimitée. Disponible depuis cURL 7.15.5

Disponible depuis PHP 8.3.0 et cURL 7.81.0

true pour être complètement silencieux avec les fonctions cURL. Enlèvé depuis cURL 7.15.5. Utilisez plutôt CURLOPT_RETURNTRANSFER.

true pour scanner le fichier ~/.netrc pour trouver un nom d'utilisateur et un mot de passe pour le site distant avec lequel une connexion est établie.

true pour exclure le corps de la sortie. La méthode de requête est alors définie sur HEAD. Changer cela en false ne le change pas en GET.

true pour désactiver la barre de progression pour les transferts cURL.

Note:

PHP définit automatiquement cette option à true, cela ne devrait être changé que pour des raisons de débogage.

true pour ignorer toute fonction cURL qui envoie un signal au processus PHP. Cela est activé par défaut dans les SAPI multi-thread pour que les options de délai d'attente puissent toujours être utilisées. Disponible depuis cURL 7.10.

Une fonction de rappel acceptant trois paramètres. Le premier est la ressource cURL, le second est une chaîne contenant un prompt de mot de passe, et le troisième est la longueur maximale du mot de passe. Retourne la chaîne contenant le mot de passe. Enlevé depuis PHP 7.3.0.

Le mot de passe à utiliser dans d'authentification. Disponible depuis cURL 7.19.1.

true pour ne pas traiter les séquences de points. Disponible depuis PHP 7.0.7 et cURL 7.42.0

Définit la clé publique épinglée. La chaîne peut être le nom de fichier de votre clé publique épinglée. Le format de fichier attendu est "PEM" ou "DER". La chaîne peut aussi être un nombre quelconque de hachages sha256 encodés en base64 précédés de "sha256//" et séparés par ";". Disponible depuis PHP 7.0.7 et cURL 7.39.0

true pour attendre le pipelining/multiplexage. Disponible depuis PHP 7.0.7 et cURL 7.43.0

Une alternative au numéro de port pour se connecter.

true pour effectuer un POST HTTP régulier. Ce POST est le type application/x-www-form-urlencoded le plus couramment utilisé par les formulaires HTML.

Les données complètes à envoyer dans une opération HTTP "POST". Ce paramètre peut être passé soit sous forme de chaîne urlencodée comme 'para1=val1&para2=val2&...' ou sous forme d'un tableau avec le nom du champ comme clé et les données du champ comme valeur. Si value est un tableau, l'en-tête Content-Type sera défini sur multipart/form-data. Les fichiers peuvent être envoyés en utilisant CURLFile ou CURLStringFile, auquel cas value doit être un tableau.

Un tableau de commandes FTP à exécuter sur le serveur après la requête FTP a été effectuée.

Un masque de bits de 1 (301 Moved Permanently), 2 (302 Found) et 4 (303 See Other) si la méthode HTTP POST doit être maintenue lorsque CURLOPT_FOLLOWLOCATION est défini et qu'un type spécifique de redirection se produit. Disponible depuis cURL 7.19.1.

Définit une chaîne string contenant le nom d'hôte ou l'adresse IP numérique pointée à utiliser comme préproxy auquel curl se connecte avant de se connecter au proxy HTTP(S) spécifié dans l'option CURLOPT_PROXY pour la prochaine requête. Le préproxy ne peut être qu'un proxy SOCKS et il doit être préfixé par [scheme]:// pour spécifier quel type de chaussettes est utilisé. Une adresse IP numérique IPv6 doit être écrite entre [crochets]. Définir le préproxy sur une chaîne vide désactive explicitement l'utilisation d'un préproxy. Pour spécifier le numéro de port dans cette chaîne, ajoutez :[port] à la fin du nom d'hôte. Le numéro de port du proxy peut éventuellement être spécifié avec l'option séparée CURLOPT_PROXYPORT. Par défaut, utilise le port 1080 pour les proxys si un port n'est pas spécifié. Disponible depuis PHP 7.3.0 et cURL 7.52.0

N'importe quelle donnée qui devrait être associée à ce gestionnaire cURL. Ces données peuvent ensuite être récupérées avec l'option CURLINFO_PRIVATE de curl_getinfo(). cURL ne fait rien avec ces données. Lors de l'utilisation d'un gestionnaire cURL multi, ces données privées sont typiquement une clé unique pour identifier un gestionnaire cURL standard. Disponible depuis cURL 7.10.3.

Une fonction de rappel acceptant cinq paramètres. Le premier est la ressource cURL, le second est le nombre total d'octets attendus à être téléchargés, le troisième est le nombre d'octets téléchargés jusqu'à présent, le quatrième est le nombre total d'octets attendus à être téléversés, et le cinquième est le nombre d'octets téléversés jusqu'à présent.

Note:

La fonction est appelée lorsque l'option CURLOPT_NOPROGRESS est définie sur false.

Un masque de bits de valeurs CURLPROTO_*. Si utilisé, ce masque limite les protocoles que libcurl peut utiliser dans le transfert. Cela vous permet d'avoir un libcurl compilé pour supporter une large gamme de protocoles mais de limiter des transferts spécifiques à n'utiliser qu'un sous-ensemble d'entre eux. Par défaut, libcurl acceptera tous les protocoles qu'il supporte. Voir CURLOPT_REDIR_PROTOCOLS. Les protocoles valides sont : CURLPROTO_HTTP, CURLPROTO_HTTPS, CURLPROTO_FTP, CURLPROTO_FTPS, CURLPROTO_SCP, CURLPROTO_SFTP, CURLPROTO_TELNET, CURLPROTO_LDAP, CURLPROTO_LDAPS, CURLPROTO_DICT, CURLPROTO_FILE, CURLPROTO_TFTP, CURLPROTO_MQTT, CURLPROTO_ALL Disponible depuis cURL 7.19.4.

Disponible depuis PHP 8.3.0 et cURL 7.85.0

Le proxy HTTP pour tunneler les requêtes à travers.

La méthode d'authentification HTTP à utiliser pour la connexion au proxy Utiliser les mêmes masques de bits que décrits dans CURLOPT_HTTPAUTH. Pour l'authentification du proxy, seulement CURLAUTH_BASIC et CURLAUTH_NTLM sont actuellement supportés. Disponible depuis cURL 7.10.7.

Un tableau d'en-têtes HTTP personnalisés à envoyer au proxy. Disponible depuis PHP 7.0.7 et cURL 7.37.0

Le numéro de port du proxy à connecter. Ce numéro de port peut aussi être défini dans CURLOPT_PROXY.

Soit CURLPROXY_HTTP (défaut), CURLPROXY_SOCKS4, CURLPROXY_SOCKS5, CURLPROXY_SOCKS4A ou CURLPROXY_SOCKS5_HOSTNAME. Disponible depuis cURL 7.10.

Un nom d'utilisateur et un mot de passe formatés comme "[username]:[password]" à utiliser pour la connexion au proxy.

Le chemin vers le fichier de certificats du proxy Certificate Authority (CA). Définir le chemin comme une string nommant un fichier contenant un ou plusieurs certificats pour vérifier le proxy HTTPS. Cette option est pour se connecter à un proxy HTTPS, pas à un serveur HTTPS. La valeur par défaut est le chemin système où le bundle cacert de libcurl est supposé être stocké. Disponible depuis PHP 7.3.0 et cURL 7.52.0

Le nom du fichier PEM contenant un ou plusieurs certificats pour vérifier le proxy HTTPS. Cette option est pour se connecter à un proxy HTTPS, pas à un serveur HTTPS. Par défaut, le chemin système où le bundle cacert de libcurl est supposé être stocké. Disponible depuis PHP 8.2.0 et cURL 7.77.0

Le répertoire contenant plusieurs certificats CA pour vérifier le proxy HTTPS. Disponible depuis PHP 7.3.0 et cURL 7.52.0

Définit le nom de fichier avec la concaténation de la liste de révocation de certificat (CRL) au format PEM à utiliser dans la validation du certificat qui se produit pendant l'échange SSL. Disponible depuis PHP 7.3.0 et cURL 7.52.0

Le nom de fichier du certificat SSL de l'émetteur du proxy. Disponible depuis PHP 8.1.0 et cURL 7.71.0.

Le certificat SSL de l'émetteur du proxy à partir du blob de mémoire. Disponible depuis PHP 8.1.0 et cURL 7.71.0.

Définit la chaîne à utiliser comme mot de passe pour charger la clé privée CURLOPT_PROXY_SSLKEY. Vous n'avez jamais besoin d'un mot de passe pour charger un certificat mais vous en avez besoin pour charger votre clé privée. Cette option est pour se connecter à un proxy HTTPS, pas à un serveur HTTPS. Disponible depuis PHP 7.3.0 et cURL 7.52.0

Définit la clé publique épinglée pour le proxy HTTPS. La chaîne peut être le nom de fichier de votre clé publique épinglée. Le format de fichier attendu est "PEM" ou "DER". La chaîne peut aussi être un nombre quelconque de hachages sha256 encodés en base64 précédés de "sha256//" et séparés par ";". Disponible depuis PHP 7.3.0 et cURL 7.52.0

Le nom du service d'authentification du proxy. Disponible depuis PHP 7.0.7, cURL 7.43.0 (pour les proxies HTTP) et cURL 7.49.0 (pour les proxies SOCKS5).

Le nom du 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 changé avec CURLOPT_PROXY_SSLCERTTYPE. Avec NSS ou Secure Transport, cela peut aussi être le surnom du certificat avec lequel vous souhaitez vous authentifier tel qu'il est nommé dans la base de données de sécurité. Si vous voulez utiliser un fichier du répertoire courant, veuillez le préfixer avec le préfixe "./" pour éviter toute confusion avec un surnom. Disponible depuis PHP 7.3.0 et cURL 7.52.0

Le format de votre certificat client utilisé pour se connecter au proxy HTTPS. Les formats supportés sont "PEM" et "DER", sauf avec Secure Transport. OpenSSL (versions 0.9.3 et ultérieures) et Secure Transport (sur iOS 5 ou ultérieur, ou OS X 10.7 ou ultérieur) supportent également "P12" pour les fichiers encodés en PKCS#12. Par défaut, c'est "PEM". Disponible depuis PHP 7.3.0 et cURL 7.52.0

Le certificat client pour le proxy HTTPS à partir du blob de mémoire. Disponible depuis PHP 8.1.0 et cURL 7.71.0.

Le nom de fichier de votre clé privée utilisée pour se connecter au proxy HTTPS. Le format par défaut est "PEM" et peut être changé avec CURLOPT_PROXY_SSLKEYTYPE. (iOS et Mac OS X uniquement) Cette option est ignorée si curl a été compilé avec Secure Transport. Disponible si compilé avec TLS. Disponible depuis PHP 7.3.0 et cURL 7.52.0

Le format de votre clé privée. Les formats supportés sont "PEM", "DER" et "ENG". Disponible depuis PHP 7.3.0 et cURL 7.52.0

La clé privée pour le certificat du proxy HTTPS à partir du blob de mémoire. Disponible depuis PHP 8.1.0 et cURL 7.71.0.

Une des CURL_SSLVERSION_DEFAULT, CURL_SSLVERSION_TLSv1, CURL_SSLVERSION_TLSv1_0, CURL_SSLVERSION_TLSv1_1, CURL_SSLVERSION_TLSv1_2, CURL_SSLVERSION_TLSv1_3, CURL_SSLVERSION_MAX_DEFAULT, CURL_SSLVERSION_MAX_TLSv1_0, CURL_SSLVERSION_MAX_TLSv1_1, CURL_SSLVERSION_MAX_TLSv1_2, CURL_SSLVERSION_MAX_TLSv1_3, CURL_SSLVERSION_SSLv3 .

La liste des suites de chiffrement à utiliser pour la connexion au proxy HTTPS. La liste doit être syntaxiquement correcte, elle se compose d'une ou plusieurs chaînes de suites de chiffrement séparées par des deux-points. Les virgules ou les espaces sont également des séparateurs acceptables mais les deux-points sont normalement utilisés, !, - et + peuvent être utilisés comme opérateurs. Disponible depuis PHP 7.3.0 et cURL 7.52.0

Définit les options de comportement SSL du proxy, qui est un masque de bits des constantes suivantes : CURLSSLOPT_ALLOW_BEAST, CURLSSLOPT_NO_REVOKE, CURLSSLOPT_NO_PARTIALCHAIN Disponible depuis PHP 7.3.0 et cURL 7.52.0

Définir sur 2 pour vérifier dans les champs de nom du certificat du proxy contre le nom du proxy. Lorsqu'il est défini sur 0, la connexion réussit indépendamment des noms utilisés dans le certificat. Utilisez cette capacité avec prudence! 1 est traité comme une option de débogage dans curl 7.28.0 et précédent. De curl 7.28.1 à 7.65.3 CURLE_BAD_FUNCTION_ARGUMENT est retourné. À partir de curl 7.66.0, 1 et 2 sont traités comme la même valeur. En environnement de production, la valeur de cette option doit être maintenue à 2 (valeur par défaut). Disponible depuis PHP 7.3.0 et cURL 7.52.0

false pour arrêter cURL de vérifier le certificat du proxy. Des certificats alternatifs à vérifier peuvent être spécifiés avec l'option CURLOPT_PROXY_CAINFO ou un répertoire de certificats peut être spécifié avec l'option CURLOPT_PROXY_CAPATH. Lorsque défini sur false, la vérification du certificat du proxy réussit indépendamment. true par défaut. Disponible depuis PHP 7.3.0 et cURL 7.52.0

La liste des suites de chiffrement à utiliser pour la connexion TLS 1.3 au proxy. La liste doit être syntaxiquement correcte, elle se compose d'une ou plusieurs chaînes de suites de chiffrement séparées par des deux-points. Cette option est actuellement utilisée uniquement lorsque curl est compilé pour utiliser OpenSSL 1.1.1 ou ultérieur. Si vous utilisez un autre backend SSL, vous pouvez essayer de définir les suites de chiffrement TLS 1.3 en utilisant l'option CURLOPT_PROXY_SSL_CIPHER_LIST. Disponible lorsque compilé avec OpenSSL >= 1.1.1. Disponible depuis PHP 7.3.0 et cURL 7.61.0

Le mot de passe à utiliser pour la méthode d'authentification TLS du proxy HTTPS spécifiée avec l'option CURLOPT_PROXY_TLSAUTH_TYPE. Nécessite également que l'option CURLOPT_PROXY_TLSAUTH_USERNAME soit définie. Disponible depuis PHP 7.3.0 et cURL 7.52.0

La méthode d'authentification TLS utilisée pour la connexion HTTPS. La méthode supportée est "SRP".

Note:

L'authentification Secure Remote Password (SRP) pour TLS fournit une authentification mutuelle si les deux parties ont un secret partagé. Pour utiliser TLS-SRP, vous devez également définir les options CURLOPT_PROXY_TLSAUTH_USERNAME et CURLOPT_PROXY_TLSAUTH_PASSWORD.

Le nom d'utilisateur à utiliser pour la méthode d'authentification TLS du proxy HTTPS spécifiée avec l'option CURLOPT_PROXY_TLSAUTH_TYPE. Nécessite également que l'option CURLOPT_PROXY_TLSAUTH_PASSWORD soit définie. Disponible depuis PHP 7.3.0 et cURL 7.52.0

true pour effectuer une requête HTTP PUT d'un fichier. Le fichier à mettre doit être défini avec CURLOPT_INFILE et CURLOPT_INFILESIZE.

Disponible depuis PHP 8.3.0 et cURL 7.87.0

Un tableau de commandes FTP à exécuter sur le serveur avant la requête FTP.

Un nom de fichier à utiliser pour initialiser le générateur de nombres aléatoires pour SSL.

La plage de données à récupérer au format "X-Y" où X ou Y sont optionnels. Les transferts HTTP supportent également plusieurs intervalles, séparés par des virgules au format "X-Y,N-M".

Une fonction de rappel acceptant trois paramètres. Le premier est la ressource cURL, le second est une ressource de flux fournie à cURL via l'option CURLOPT_INFILE, et le troisième est la quantité maximale de données à lire. La fonction de rappel doit renvoyer une chaîne d'une longueur égale ou inférieure à la quantité de données demandée, typiquement en la lisant à partir de la ressource de flux passée. Elle doit renvoyer une chaîne vide pour signaler la fin du fichier.

Un masque de bits de valeurs CURLPROTO_*. Si utilisé, ce masque limite les protocoles que libcurl peut utiliser dans un transfert qu'il suit dans une redirection lorsque CURLOPT_FOLLOWLOCATION est activé. Cela vous permet de limiter des transferts spécifiques à n'utiliser qu'un sous-ensemble de protocoles dans les redirections. Par défaut, libcurl acceptera tous les protocoles sauf FILE et SCP. C'est une différence par rapport aux versions antérieures à 7.19.4 qui suivraient inconditionnellement tous les protocoles supportés. Voir aussi CURLOPT_PROTOCOLS pour les valeurs constantes de protocole. Disponible depuis cURL 7.19.4.

Disponible depuis PHP 8.3.0 et cURL 7.85.0.

Le contenu de l'en-tête "Referer: " à utiliser dans une requête HTTP.

Disponible depuis PHP 7.3.0 et cURL 7.55.0.

Apporte une adresse personnalisée pour un hôte et un port spécifiques. Un tableau de chaînes de nom d'hôte, de port et d'adresse IP, chaque élément séparé par un deux-points. Dans le format : array("example.com:80:127.0.0.1") Disponible depuis cURL 7.21.3.

L'offset, en octets, pour reprendre un transfert.

true pour retourner la réponse en tant que chaîne de la fonction curl_exec() au lieu de l'afficher directement.

Toujours true, ce qui désactive le support du préfixe "@" pour l'envoi de fichiers dans CURLOPT_POSTFIELDS, ce qui signifie que les valeurs commençant par "@" peuvent être passées en toute sécurité en tant que champs. CURLFile peut être utilisé pour les téléversements à la place.

L'identité d'autorisation (authzid) pour le transfert. Applicable uniquement au mécanisme d'authentification SASL PLAIN où il est facultatif. Lorsqu'il n'est pas spécifié, seule l'identité d'authentification (authcid) telle que spécifiée par le nom d'utilisateur sera envoyée au serveur, avec le mot de passe. Le serveur déduira l'authzid de l'authcid lorsqu'il ne sera pas fourni, qu'il utilisera ensuite en interne. Disponible depuis PHP 8.2.0 et cURL 7.66.0

true pour activer l'initialisation de la réponse SASL (SASL Initial Response). Disponible depuis PHP 7.0.7 et cURL 7.31.0

Le nom du service d'authentification. Disponible depuis PHP 7.0.7 et cURL 7.43.0

Un résultat de curl_share_init(). Fait en sorte que le gestionnaire cURL utilise les données du gestionnaire partagé.

La méthode d'authentification SOCKS5 à utiliser. Les options sont : CURLAUTH_BASIC, CURLAUTH_GSSAPI, CURLAUTH_NONE. L'opération bit à bit | (ou) peut être utilisée pour combiner une ou plusieurs méthodes. Si cela est fait, cURL interrogera le serveur pour voir quelles méthodes il prend en charge et choisira la meilleure. CURLAUTH_BASIC permet l'authentification par nom d'utilisateur/mot de passe. CURLAUTH_GSSAPI permet l'authentification GSS-API. CURLAUTH_NONE n'autorise aucune authentification. Par défaut, CURLAUTH_BASIC|CURLAUTH_GSSAPI. Définissez le nom d'utilisateur et le mot de passe réels avec l'option CURLOPT_PROXYUSERPWD. Disponible depuis PHP 7.3.0 et cURL 7.55.0

Un masque de bits composé de l'une ou plusieurs des constantes CURLSSH_AUTH_PUBLICKEY, CURLSSH_AUTH_PASSWORD, CURLSSH_AUTH_HOST, CURLSSH_AUTH_KEYBOARD. Définissez-le sur CURLSSH_AUTH_ANY pour laisser libcurl en choisir un. Disponible depuis cURL 7.16.1.

true pour activer la compression SSH intégrée. C'est une demande, pas un ordre ; le serveur peut ou non le faire. Disponible depuis PHP 7.3.0 et cURL 7.56.0

Disponible depuis PHP 8.3.0 et cURL 7.84.0

Une chaîne contenant 32 chiffres hexadécimaux. La chaîne doit être le hachage MD5 de la clé publique de l'hôte distant, et libcurl rejettera la connexion à l'hôte à moins que les sommes de contrôle md5 ne correspondent. Cette option est uniquement pour les transferts SCP et SFTP. Disponible depuis cURL 7.17.1.

Le hachage SHA256 encodé en base64 de la clé publique de l'hôte distant. Le transfert échouera si le hachage donné ne correspond pas au hachage fourni par l'hôte distant. Disponible depuis PHP 8.2.0 et cURL 7.80.0

Le nom du fichier de votre clé privée. Si non utilisé, libcurl utilise par défaut $HOME/.ssh/id_dsa si la variable d'environnement HOME est définie, et juste "id_dsa" dans le répertoire courant si HOME n'est pas défini. Si le fichier est protégé par mot de passe, définissez le mot de passe avec CURLOPT_KEYPASSWD. Disponible depuis cURL 7.16.1.

Le nom du fichier de votre clé publique. Si non utilisé, libcurl utilise par défaut $HOME/.ssh/id_dsa.pub si la variable d'environnement HOME est définie, et juste "id_dsa.pub" dans le répertoire courant si HOME n'est pas défini. Disponible depuis cURL 7.16.1.

Le nom d'un fichier contenant un certificat au format PEM.

Le mot de passe requis pour utiliser le certificat CURLOPT_SSLCERT.

Le format du certificat. Les formats supportés sont "PEM" (par défaut), "DER", et "ENG". À partir de OpenSSL 0.9.3, "P12" (pour les fichiers encodés en PKCS#12) est également supporté. Disponible depuis cURL 7.9.3.

Le certificat client à partir du blob de mémoire. Disponible depuis PHP 8.1.0 et cURL 7.71.0.

L'identifiant du moteur de cryptographie de la clé SSL privée spécifiée dans CURLOPT_SSLKEY.

L'identifiant du moteur de cryptographie utilisé pour les opérations de cryptographie asymétrique.

Le nom d'un fichier contenant une clé privée SSL.

Le mot de passe requis pour utiliser la clé privée SSL spécifiée dans CURLOPT_SSLKEY.

Note:

Puisque cette option contient un mot de passe sensible, n'oubliez pas de garder le script PHP dans lequel il est contenu en sécurité.

Le type de clé privée SSL spécifié dans CURLOPT_SSLKEY. Les types de clé supportés sont "PEM" (par défaut), "DER", et "ENG".

La clé privée SSL à partir du blob de mémoire. Disponible depuis PHP 8.1.0 et cURL 7.71.0.

Une des constantes suivantes : CURL_SSLVERSION_DEFAULT, CURL_SSLVERSION_TLSv1, CURL_SSLVERSION_SSLv2, CURL_SSLVERSION_SSLv3, CURL_SSLVERSION_TLSv1_0, CURL_SSLVERSION_TLSv1_1, CURL_SSLVERSION_TLSv1_2, CURL_SSLVERSION_TLSv1_3 . Le maximum de la version TLS peut être défini en utilisant une des constantes CURL_SSLVERSION_MAX_*. Il est également possible de faire un OU binaire avec une des constantes CURL_SSLVERSION_* avec une des constantes CURL_SSLVERSION_MAX_*. CURL_SSLVERSION_MAX_DEFAULT (la verison maximum supportée par la librairie), CURL_SSLVERSION_MAX_TLSv1_0, CURL_SSLVERSION_MAX_TLSv1_1, CURL_SSLVERSION_MAX_TLSv1_2, CURL_SSLVERSION_MAX_TLSv1_3 .

Une liste de suites de chiffrement à utiliser pour SSL. Par exemple, RC4-SHA et TLSv1 sont des listes de suites de chiffrement valides.

Un liste de courbes elliptiques délimitées par des deux-points. Par exemple, X25519:P-521 est une liste de deux courbes elliptiques valides. Cette option définit les algorithmes d'échange de clés du client dans la poignée de main SSL, si le backend SSL cURL est compilé pour l'utiliser. Disponible depuis PHP 8.2.0 et cURL 7.73.0

false to disable ALPN in the SSL handshake (if the SSL backend libcurl is built to use supports it), which can be used to negotiate http2. Disponible depuis PHP 7.0.7 et cURL 7.36.0

false pour désactiver NPN dans la poignée de main SSL (si le backend SSL libcurl est compilé pour l'utiliser), ce qui peut être utilisé pour négocier http2. Disponible depuis PHP 7.0.7 et cURL 7.36.0

true pour activer le démarrage TLS false. Disponible depuis PHP 7.0.7 et cURL 7.42.0

Set SSL behavior options, which is a bitmask of the following constants: CURLSSLOPT_ALLOW_BEAST, CURLSSLOPT_NO_REVOKE, CURLSSLOPT_AUTO_CLIENT_CERT, CURLSSLOPT_NATIVE_CA, CURLSSLOPT_NO_PARTIALCHAIN, CURLSSLOPT_REVOKE_BEST_EFFORT Disponible depuis PHP 7.0.7. et cURL 7.25.0

2 pour vérifier qu'un champ de nom commun ou un champ de nom alternatif dans le certificat SSL du pair correspond au nom d'hôte fourni. 0 pour ne pas vérifier les noms. 1 ne doit pas être utilisé. En production, la valeur de cette option doit être conservée à 2 (valeur par défaut). Le support de la valeur 1 a été supprimé dans cURL 7.28.1.

false pour empêcher cURL de vérifier le certificat du pair. Des certificats alternatifs à vérifier peuvent être spécifiés avec l'option CURLOPT_CAINFO ou un répertoire de certificats peut être spécifié avec l'option CURLOPT_CAPATH. true par défaut à partir de cURL 7.10. Bundle par défaut installé à partir de cURL 7.10.

true pour vérifier le statut du certificat. Disponible depuis PHP 7.0.7 et cURL 7.41.0

Une location alternative pour afficher les erreurs à la place de STDERR.

Définit le poids du flux numérique (un nombre entre 1 et 256). Disponible depuis PHP 7.0.7 et cURL 7.46.0

true pour supprimer les en-têtes de réponse proxy CONNECT des fonctions de rappel utilisateur CURLOPT_HEADERFUNCTION et CURLOPT_WRITEFUNCTION, lorsque CURLOPT_HTTPPROXYTUNNEL est utilisé et une requête CONNECT est effectuée. Disponible depuis PHP 7.3.0 et cURL 7.54.0

true pour activer l'ouverture rapide TCP. Disponible depuis PHP 7.0.7 et cURL 7.49.0

Si défini à 1, des sondes de maintien de la connexion TCP seront envoyées. Le déliat et la fréquence de ces sondes peuvent être contrôlés par les options CURLOPT_TCP_KEEPIDLE et CURLOPT_TCP_KEEPINTVL, à condition que le système d'exploitation les supporte. Si défini à 0 (par défaut), les sondes de maintien de la connexion sont désactivées. Disponible depuis cURL 7.25.0

Défini le délai, en secondes, que le système d'exploitation attendra pendant que la connexion est inutilisée avant d'envoyer des sondes de maintien de la connexion, si CURLOPT_TCP_KEEPALIVE est activé. Tous les systèmes d'exploitation ne supportent pas cette option. La valeur par défaut est 60. Disponible depuis cURL 7.25.0

Définit l'intervalle, en secondes, que le système d'exploitation attendra entre l'envoi des sondes de maintien de la connexion, si CURLOPT_TCP_KEEPALIVE est activé. Tous les systèmes d'exploitation ne supportent pas cette option. La valeur par défaut est 60. Disponible depuis cURL 7.25.0

true pour désactiver l'algorithme de Nagle TCP, qui tente de minimiser le nombre de petits paquets sur le réseau. Disponible depuis cURL 7.11.2.

true pour ne pas envoyer de requêtes d'options TFTP. Disponible depuis PHP 7.0.7 et cURL 7.48.0

Comment CURLOPT_TIMEVALUE est traité. Utilisez CURL_TIMECOND_IFMODSINCE pour retourner la page uniquement si elle a été modifiée depuis le temps spécifié dans CURLOPT_TIMEVALUE. Si elle n'a pas été modifiée, un en-tête "304 Not Modified" sera retourné en supposant que CURLOPT_HEADER est true. Utiliser CURL_TIMECOND_IFUNMODSINCE pour l'effet inverse. Utiliser CURL_TIMECOND_NONE pour ignorer CURLOPT_TIMEVALUE et toujours retourner la page. CURL_TIMECOND_NONE est la valeur par défaut. Avant cURL 7.46.0 la valeur par défaut était CURL_TIMECOND_IFMODSINCE.

Le nombre maximum de secondes à attendre pour les fonctions cURL.

Le nombre maximum de millisecondes à attendre pour les fonctions cURL s'éxécutent. Si libcurl est compilé pour utiliser le résolveur de noms système standard, cette partie de la connexion utilisera toujours une résolution de seconde complète pour les délais d'attente avec un délai minimum autorisé d'une seconde. Disponible depuis cURL 7.16.2.

Le temps en secondes depuis le 1er janvier 1970. Le temps sera utilisé par CURLOPT_TIMECONDITION.

Le temps en secondes depuis le 1er janvier 1970. Le temps sera utilisé par CURLOPT_TIMECONDITION. Par défaut à zéro. La différence entre cette option et CURLOPT_TIMEVALUE est le type de l'argument. Sur les systèmes où 'long' n'est que de 32 bits de large, cette option doit être utilisée pour définir des dates au-delà de l'année 2038. Disponible depuis PHP 7.3.0 et cURL 7.59.0

La liste des suites de chiffrement à utiliser pour la connexion TLS 1.3. La liste doit être syntaxiquement correcte, elle se compose d'une ou plusieurs chaînes de suites de chiffrement séparées par des deux-points. Cette option est actuellement utilisée uniquement lorsque cURL est compilé pour utiliser OpenSSL 1.1.1 ou ultérieur. Si vous utilisez un autre backend SSL, vous pouvez essayer de définir les suites de chiffrement TLS 1.3 en utilisant l'option CURLOPT_SSL_CIPHER_LIST. Disponible lorsque compilé avec OpenSSL >= 1.1.1. Disponible depuis PHP 7.3.0 et cURL 7.61.0

true to use ASCII mode for FTP transfers. Pour LDAP, il récupère les données en texte brut au lieu de HTML. Sur les systèmes Windows, il ne définira pas STDOUT en mode binaire.

Active l'utilisation des sockets de domaine Unix comme point de connexion et définit le chemin du string donné. Disponible depuis PHP 7.0.7 et cURL 7.40.0

true pour continuer à envoyer le nom d'utilisateur et le mot de passe lors du suivi des emplacements (en utilisant CURLOPT_FOLLOWLOCATION), même lorsque le nom d'hôte a changé.

Quelques protocoles ont des mécanismes de "maintenance de la connexion". Ces mécanismes envoient généralement du trafic sur les connexions existantes pour les maintenir en vie. Cette option définit l'intervalle de maintenance de la connexion. Actuellement, le seul protocole avec un mécanisme de maintenance de la connexion est HTTP/2. Lorsque l'intervalle de maintenance de la connexion est dépassé, un cadre PING HTTP/2 est envoyé sur la connexion. La valeur par défaut est 60 secondes. Disponible depuis PHP 8.2.0 et cURL 7.62.0

true to prepare for an upload.

Le tampon de taille préférée en octets pour le téléchargement cURL. La taille du tampon de téléchargement par défaut est de 64 kilo-octets. La taille maximale du tampon autorisée à être définie est de 2 méga-octets. La taille minimale du tampon autorisée à être définie est de 16 kilo-octets. Disponible depuis PHP 8.2.0 et cURL 7.62.0

L'URL à récupérer. Cela peut également être défini lors de l'initialisation d'une session avec curl_init().

Le contenu de l'en-tête "User-Agent: " à utiliser dans une requête HTTP.

Le nom d'utilisateur à utiliser dans l'authentification. Disponible depuis cURL 7.19.1

Le nom d'utilisateur et le mot de passe sous la forme "[username]:[password]" à utiliser pour la connexion.

true pour afficher des informations détaillées sur la connexion. Écrit la sortie sur STDERR, ou le fichier spécifié en utilisant CURLOPT_STDERR.

Une fonction de rappel acceptant deux paramètres. Le premier est le gestionnaire cURL, et le second est une chaîne contenant les données à écrire. Les données doivent être enregistrées par ce rappel. Il doit retourner le nombre exact d'octets écrits ou le transfert sera interrompu avec une erreur.

Le fichier où la partie en-tête du transfert est écrite.

Disponible depuis PHP 8.3.0 et cURL 7.86.0

Une fonction de rappel acceptant deux paramètres. A une fonction similaire à CURLOPT_PROGRESSFUNCTION mais est plus moderne et l'option préférée de cURL. Disponible depuis PHP 8.2.0 et cURL 7.32.0.

Spécife le jeton d'accès OAuth 2.0. Disponible depuis PHP 7.0.7 et cURL 7.33.0

Passer une fermeture qui sera enregistré pour gérer les poussées du serveur et doit avoir la signature suivante:

parent_ch

Le gestionnaire parent cURL (la requête que le client a faite).

pushed_ch

Un nouveau gestionnaire cURL pour la requête poussée.

headers

Les en-têtes de la promesse de poussée.