php.net |  support |  documentation |  report a bug |  advanced search |  search howto |  statistics |  random bug |  login
Doc Bug #78367 missing CURL_SSLVERSION_MAX_xxx
Submitted: 2019-08-02 16:23 UTC Modified: 2020-03-12 16:08 UTC
From: mah at jump-ing dot de Assigned: cmb (profile)
Status: Closed Package: cURL related
PHP Version: Irrelevant OS:
Private report: No CVE-ID: None
Welcome back! If you're the original bug submitter, here's where you can edit the bug or add additional notes.
If this is not your bug, you can add a comment by following this link.
If this is your bug, but you forgot your password, you can retrieve your password here.
Password:
Status:
Package:
Bug Type:
Summary:
From: mah at jump-ing dot de
New email:
PHP Version: OS:

 

 [2019-08-02 16:23 UTC] 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>
---


Patches

Add a Patch

Pull Requests

Add a Pull Request

History

AllCommentsChangesGit/SVN commitsRelated reports
 [2020-03-12 16:06 UTC] cmb@php.net
-Summary: Incomplete CURL_SSLVERSION_xxx, missing CURL_SSLVERSION_MAX_xxx +Summary: missing CURL_SSLVERSION_MAX_xxx -Status: Open +Status: Verified -Assigned To: +Assigned To: cmb
 [2020-03-12 16:06 UTC] cmb@php.net
This has partially already been documented.
 [2020-03-12 16:07 UTC] cmb@php.net
Automatic comment from SVN on behalf of cmb
Revision: http://svn.php.net/viewvc/?view=revision&amp;revision=349394
Log: Fix #78367: missing CURL_SSLVERSION_MAX_xxx
 [2020-03-12 16:08 UTC] cmb@php.net
-Status: Verified +Status: Closed
 [2020-03-12 16:08 UTC] cmb@php.net
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.
 [2020-03-12 16:08 UTC] phpdocbot@php.net
Automatic comment on behalf of cmb
Revision: http://git.php.net/?p=doc/en.git;a=commit;h=a8356baaf4ce3dff88903d06f9845df51e2f4715
Log: Fix #78367: missing CURL_SSLVERSION_MAX_xxx
 
PHP Copyright © 2001-2024 The PHP Group
All rights reserved.
Last updated: Thu Apr 18 06:01:28 2024 UTC