Doc #78367 [Ver->Csd]: missing CURL_SSLVERSION_MAX_xxx
| From: | cmb@php.net | Date: | Thu, 12 Mar 2020 16:08:04 +0000 |
| Subject: | Doc #78367 [Ver->Csd]: missing CURL_SSLVERSION_MAX_xxx | ||
| References: | 1 | Groups: | php.doc.bugs |
| Request: | Send a blank email to doc-bugs+get-17403@lists.php.net to get a copy of this message | ||
Edit report at https://bugs.php.net/bug.php?id=78367&edit=1
ID: 78367
Updated by: cmb@php.net
Reported by: mah at jump-ing dot de
Summary: missing CURL_SSLVERSION_MAX_xxx
-Status: Verified
+Status: Closed
Type: Documentation Problem
Package: cURL related
PHP Version: Irrelevant
Assigned To: cmb
Block user comment: N
Private report: N
New Comment:
This bug has been fixed in the documentation's XML sources. Since the
online and downloadable versions of the documentation need some time
to get updated, we would like to ask you to be a bit patient.
Thank you for the report, and for helping us make our documentation better.
Previous Comments:
------------------------------------------------------------------------
[2020-03-12 16:07:43] cmb@php.net
Automatic comment from SVN on behalf of cmb
Revision: http://svn.php.net/viewvc/?view=revision&revision=349394
Log: Fix #78367: missing CURL_SSLVERSION_MAX_xxx
------------------------------------------------------------------------
[2020-03-12 16:06:54] cmb@php.net
This has partially already been documented.
------------------------------------------------------------------------
[2019-08-02 16:23:16] mah at jump-ing dot de
Description:
------------
---
From manual page: https://php.net/function.curl-setopt
---
As the title says, documentation for these two groups of macros is outdated. More recent
documentation is here: https://curl.haxx.se/libcurl/c/CURLOPT_SSLVERSION.html
I went to https://edit.php.net/ for bringing this up to date,
saving gets accepted, but public documentation doesn't update. If there are additional steps
required I'm not aware of them.
In case somebody with more privileges needs to apply this, here's the new row for
CURLOPT_SSLVERSION in en/reference/curl/functions/curl-setopt.xml I came up with:
---
<row>
<entry
valign="top"><constant>CURLOPT_SSLVERSION</constant></entry>
<entry valign="top">
Sets the minimum acceptable TLS version for the connection.
<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) or
<constant>CURL_SSLVERSION_TLSv1_2</constant> (6).
The maximum TLS version used. It is also possible to OR one of the
CURL_SSLVERSION_ macros with one of the CURL_SSLVERSION_MAX_ macros.
Added in cURL 7.54.0.
<constant>CURL_SSLVERSION_MAX_DEFAULT</constant> The maximum version
supported by the library.
<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>
<note>
<para>
Your best bet is to not set this and let it use the default.
</para>
</note>
</entry>
In versions of cURL prior to 7.54 the CURL_SSLVERSION_{SSL|TLS} options
were documented to allow only the specified TLS version, but
behavior was inconsistent depending on the TLS library.
</row>
---
------------------------------------------------------------------------
--
Edit this bug report at https://bugs.php.net/bug.php?id=78367&edit=1