[DOC-CVS] [doc-en] master: ext/curl: Document more curl deprecations (#5678)

Author: Sjoerd Langkemper (Sjord)
Committer: GitHub (web-flow)
Pusher: jordikroon
Date: 2026-07-21T21:48:20+02:00

Commit: https://github.com/php/doc-en/commit/5cdc4c99779c1bd1b770b15a5fc6438b39223c28
Raw diff: https://github.com/php/doc-en/commit/5cdc4c99779c1bd1b770b15a5fc6438b39223c28.diff

ext/curl: Document more curl deprecations (#5678)

* Document more curl deprecations

Co-authored-by: Louis-Arnaud <[email protected]>

Changed paths:
  M  reference/curl/constants_curl_getinfo.xml
  M  reference/curl/constants_curl_setopt.xml


Diff:

diff --git a/reference/curl/constants_curl_getinfo.xml b/reference/curl/constants_curl_getinfo.xml
index c2295e288ee8..faddce225ea2 100644
--- a/reference/curl/constants_curl_getinfo.xml
+++ b/reference/curl/constants_curl_getinfo.xml
@@ -112,7 +112,7 @@
   </term>
   <listitem>
    <simpara>
-    Content length of download, read from Content-Length: field
+    Content length of download, read from Content-Length: field. Deprecated since cURL 7.55.0. Use <constant>CURLINFO_CONTENT_LENGTH_DOWNLOAD_T</constant> instead.
    </simpara>
   </listitem>
  </varlistentry>
@@ -135,7 +135,7 @@
   </term>
   <listitem>
    <simpara>
-    Specified size of upload
+    Specified size of upload. Deprecated since cURL 7.55.0. Use <constant>CURLINFO_CONTENT_LENGTH_UPLOAD_T</constant> instead.
    </simpara>
   </listitem>
  </varlistentry>
@@ -453,7 +453,7 @@
   <listitem>
    <simpara>
     The protocol used in the last HTTP connection. The returned value will be exactly one of the <constant>CURLPROTO_<replaceable>*</replaceable></constant> values.
-    Available as of PHP 7.3.0 and cURL 7.52.0
+    Available as of PHP 7.3.0 and cURL 7.52.0. Deprecated since cURL 7.85.0. Use <constant>CURLINFO_SCHEME</constant> instead.
    </simpara>
   </listitem>
  </varlistentry>
@@ -671,7 +671,7 @@
   </term>
   <listitem>
    <simpara>
-    Total number of bytes downloaded
+    Total number of bytes downloaded. Deprecated since cURL 7.55.0. Use <constant>CURLINFO_SIZE_DOWNLOAD_T</constant> instead.
    </simpara>
   </listitem>
  </varlistentry>
@@ -694,7 +694,7 @@
   </term>
   <listitem>
    <simpara>
-    Total number of bytes uploaded
+    Total number of bytes uploaded. Deprecated since cURL 7.55.0. Use <constant>CURLINFO_SIZE_UPLOAD_T</constant> instead.
    </simpara>
   </listitem>
  </varlistentry>
@@ -717,7 +717,7 @@
   </term>
   <listitem>
    <simpara>
-    Average download speed
+    Average download speed. Deprecated since cURL 7.55.0. Use <constant>CURLINFO_SPEED_DOWNLOAD_T</constant> instead.
    </simpara>
   </listitem>
  </varlistentry>
@@ -740,7 +740,7 @@
   </term>
   <listitem>
    <simpara>
-    Average upload speed
+    Average upload speed. Deprecated since cURL 7.55.0. Use <constant>CURLINFO_SPEED_UPLOAD_T</constant> instead.
    </simpara>
   </listitem>
  </varlistentry>
diff --git a/reference/curl/constants_curl_setopt.xml b/reference/curl/constants_curl_setopt.xml
index e2307cf4533e..cae73adddc1f 100644
--- a/reference/curl/constants_curl_setopt.xml
+++ b/reference/curl/constants_curl_setopt.xml
@@ -1528,7 +1528,7 @@
      <literal>private</literal> is used.
      Setting this option to &null; will disable kerberos support for FTP.
      Defaults to &null;.
-     Available as of cURL 7.16.4.
+     Available as of cURL 7.16.4 and deprecated as of cURL 8.17.0.
     </para>
    </listitem>
   </varlistentry>
@@ -2280,13 +2280,13 @@
     (<type>int</type>)
    </term>
    <listitem>
-    <para>
+    <simpara>
      Bitmask of <constant>CURLPROTO_<replaceable>*</replaceable></constant> values.
      If used, this bitmask limits what protocols cURL may use in the transfer.
      Defaults to <constant>CURLPROTO_ALL</constant>, ie. cURL will accept all protocols it supports.
-     See also <constant>CURLOPT_REDIR_PROTOCOLS</constant>.
+     See also <constant>CURLOPT_REDIR_PROTOCOLS_STR</constant>.
      Available as of cURL 7.19.4 and deprecated as of cURL 7.85.0.
-    </para>
+    </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.curlopt-protocols-str">
@@ -3723,12 +3723,12 @@
     (<type>int</type>)
    </term>
    <listitem>
-    <para>
+    <simpara>
      &true; to enable and &false; to disable TLS false start
      which is a mode where a TLS client starts sending application data
      before verifying the server's <literal>Finished</literal> message.
-     Available as of PHP 7.0.7 and cURL 7.42.0.
-    </para>
+     Available as of PHP 7.0.7 and cURL 7.42.0. Deprecated since cURL 8.15.0.
+    </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.curlopt-ssl-options">