UPGRADING: Add CURLINFO_USED_PROXY, HTTPAUTH_USED, and PROXYAUTH_USED

Follow-up to phpGH-17816.

Author: Ayesh

NEWS

@@ -28,6 +28,8 @@ PHP                                                                        NEWS
 - Curl:
   . Added curl_multi_get_handles(). (timwolla)
   . Added curl_share_init_persistent(). (enorris)
+  . Added CURLINFO_USED_PROXY, CURLINFO_HTTPAUTH_USED, and CURLINFO_PROXYAUTH_USED
+    support to curl_getinfo. (Ayesh Karunaratne)
 
 - Date:
   . Fix undefined behaviour problems regarding integer overflow in extreme edge

UPGRADING

@@ -95,6 +95,18 @@ PHP 8.5 UPGRADE NOTES
   . Added support for share handles that are persisted across multiple PHP
     requests, safely allowing for more effective connection reuse.
     RFC: https://wiki.php.net/rfc/curl_share_persistence_improvement
+  . Added support for CURLINFO_USED_PROXY (libcurl >= 8.7.0),
+    CURLINFO_HTTPAUTH_USED, and CURLINFO_PROXYAUTH_USED
+    (libcurl >= 8.12.0) to the curl_getinfo() function.
+    When curl_getinfo() returns an array, the same information
+    is available as "used_proxy", "httpauth_used", and "proxyauth_used"
+    keys.
+    CURLINFO_USED_PROXY gets zero set if no proxy was used in the
+    previous transfer or a non-zero value if a proxy was used.
+    CURLINFO_HTTPAUTH_USED and CURLINFO_PROXYAUTH_USED get bitmasks
+    indicating the http and proxy authentication methods that were
+    used in the previous request. See CURLAUTH_* constants for
+    possible values.
 
 - DOM:
   . Added Dom\Element::$outerHTML.
@@ -265,6 +277,11 @@ PHP 8.5 UPGRADE NOTES
 - Core:
   . PHP_BUILD_DATE.
 
+- Curl:
+  . CURLINFO_USED_PROXY.
+  . CURLINFO_HTTPAUTH_USED.
+  . CURLINFO_PROXYAUTH_USED.
+
 - POSIX:
   . POSIX_SC_OPEN_MAX.