Doc #78367 [NEW]: Incomplete CURL_SSLVERSION_xxx, missing CURL_SSLVERSION_MAX_xxx
| From: | mah at jump-ing dot de | Date: | Fri, 02 Aug 2019 16:23:16 +0000 |
| Subject: | Doc #78367 [NEW]: Incomplete CURL_SSLVERSION_xxx, missing CURL_SSLVERSION_MAX_xxx | ||
| Groups: | php.doc.bugs | ||
| Request: | Send a blank email to doc-bugs+get-16849@lists.php.net to get a copy of this message | ||
From: mah at jump-ing dot de
Operating system:
PHP version: Irrelevant
Package: cURL related
Bug Type: Documentation Problem
Bug description:Incomplete CURL_SSLVERSION_xxx, missing CURL_SSLVERSION_MAX_xxx
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 bug report at https://bugs.php.net/bug.php?id=78367&edit=1
--
Fix committed: https://bugs.php.net/fix.php?id=78367&r=fixed
Fixed in release: https://bugs.php.net/fix.php?id=78367&r=alreadyfixed
Need backtrace: https://bugs.php.net/fix.php?id=78367&r=needtrace
Need Reproduce Script: https://bugs.php.net/fix.php?id=78367&r=needscript
Try newer version: https://bugs.php.net/fix.php?id=78367&r=oldversion
Not developer issue: https://bugs.php.net/fix.php?id=78367&r=support
Expected behavior: https://bugs.php.net/fix.php?id=78367&r=notwrong
Not enough info: https://bugs.php.net/fix.php?id=78367&r=notenoughinfo
Submitted twice: https://bugs.php.net/fix.php?id=78367&r=submittedtwice
register_globals: https://bugs.php.net/fix.php?id=78367&r=globals
PHP version support discontinued: https://bugs.php.net/fix.php?id=78367&r=phptooold
Daylight Savings: https://bugs.php.net/fix.php?id=78367&r=dst
IIS Stability: https://bugs.php.net/fix.php?id=78367&r=isapi
Install GNU Sed: https://bugs.php.net/fix.php?id=78367&r=gnused
Floating point limitations: https://bugs.php.net/fix.php?id=78367&r=float
No Zend Extensions: https://bugs.php.net/fix.php?id=78367&r=nozend
MySQL Configuration Error: https://bugs.php.net/fix.php?id=78367&r=mysqlcfg