-
Notifications
You must be signed in to change notification settings - Fork 146
/
curl-setopt.xml
2839 lines (2827 loc) · 125 KB
/
curl-setopt.xml
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 310963ad9ab1c2ca315361ff94314a21fa65f8b8 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
<constant>STDERR</constant> 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 >= 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 >= 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 >= 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 >= 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, <constant>STDOUT</constant> 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 <constant>STDERR</constant>, 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 <literal>Expect: 100-continue</literal>
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 :
<constant>CURLFTPAUTH_SSL</constant> (tenter SSL en premier),
<constant>CURLFTPAUTH_TLS</constant> (tenter TLS en premier), ou
<constant>CURLFTPAUTH_DEFAULT</constant> (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">
<para>
Comment traiter les en-têtes.
L'une des constantes suivantes :
<variablelist>
<varlistentry>
<term>CURLHEADER_UNIFIED</term>
<listitem>
<simpara>
Les en-têtes spécifiés dans
<constant>CURLOPT_HTTPHEADER</constant>
seront utilisés dans les requêtes à la fois aux serveurs et aux proxies.
Avec cette option activée,
<constant>CURLOPT_PROXYHEADER</constant>
n'aura aucun effet.
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>CURLHEADER_SEPARATE</term>
<listitem>
<simpara>
Fait en sorte que les en-têtes de
<constant>CURLOPT_HTTPHEADER</constant>
soient envoyés uniquement à un serveur et non à un proxy.
Les en-têtes de proxy doivent être définis avec
<constant>CURLOPT_PROXYHEADER</constant>
pour être utilisés.
Notez que si une requête non-CONNECT est envoyée à un proxy,
libcurl enverra à la fois les en-têtes du serveur et les en-têtes du proxy.
Lors de la réalisation d'une connexion CONNECT, libcurl enverra
uniquement les en-têtes de
<constant>CURLOPT_PROXYHEADER</constant>
au proxy, puis uniquement les en-têtes de
<constant>CURLOPT_HTTPHEADER</constant>
au serveur.
</simpara>
</listitem>
</varlistentry>
</variablelist>
</para>
<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_AWS_SIGV4</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> définit tous les bits. cURL sélectionnera automatiquement celui qu'il trouve
le plus sécurisé.
</para>
<para>
<constant>CURLAUTH_ANYSAFE</constant> définit tous les bits sauf <constant>CURLAUTH_BASIC</constant>.
cURL sélectionnera automatiquement celui qu'il trouve le plus sécurisé.
</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_MAIL_RCPT_ALLLOWFAILS</constant></entry>
<entry valign="top">
Autorise l'échec de la commande RCPT TO pour certains destinataires.
</entry>
<entry valign="top">
Lors de l'envoi de données à plusieurs destinataires, cURL interrompt la conversation SMTP par défaut si au moins
l'un des destinataires provoque une erreur avec la commande RCPT TO. Cette option indique à cURL d'ignorer les erreurs et
de continuer avec les destinataires valides restants. Si tous les destinataires génèrent des échecs RCPT TO et que ce
drapeau est activé, cURL interrompra la conversation SMTP et renverra l'erreur reçue de la dernière commande RCPT TO.
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_MAXAGE_CONN</constant></entry>
<entry valign="top">
Le temps d'inactivité maximal autorisé pour qu'une connexion existante soit considérée comme réutilisable.
La durée maximale par défaut est de <literal>118</literal> secondes.
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_MAXFILESIZE_LARGE</constant></entry>
<entry valign="top">
La taille maximale du fichier en octets autorisée à télécharger. Si la taille du fichier demandé est supérieure à cette valeur,
le transfert ne commencera pas et <constant>CURLE_FILESIZE_EXCEEDED</constant> sera renvoyé.
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.
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_MAXLIFETIME_CONN</constant></entry>
<entry valign="top">
Le temps maximal en secondes, depuis la création de la connexion, qui est autorisé pour qu'une connexion existante
soit considérée pour être réutilisable. Si une connexion est trouvée dans la mémoire cache et est plus ancienne
que cette valeur, elle sera fermée une fois que tous les transferts en cours seront terminés.
La valeur par défaut est de 0 seconde, ce qui signifie que l'option est désactivée et que toutes les connexions sont éligibles pour être réutilisées.
</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,
la plus ancienne dans le cache est fermée pour éviter
d'augmenter le nombre de connexions ouvertes.
</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_MQTT</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>