From 420aae0f07f7556e0a0790d5e0ab18fa2ca86d43 Mon Sep 17 00:00:00 2001 From: lacatoire Date: Mon, 8 Jun 2026 15:17:48 +0200 Subject: [PATCH] Document new cURL constants (PHP 8.5) --- reference/curl/constants.xml | 46 +++++++++++++++++ reference/curl/constants_curl_getinfo.xml | 60 +++++++++++++++++++++++ reference/curl/constants_curl_setopt.xml | 15 ++++++ 3 files changed, 121 insertions(+) diff --git a/reference/curl/constants.xml b/reference/curl/constants.xml index e62a6f3ee13a..8f15c73e262f 100644 --- a/reference/curl/constants.xml +++ b/reference/curl/constants.xml @@ -212,6 +212,52 @@ + + + CURLFOLLOW_ALL + (int) + + + + Value for CURLOPT_FOLLOWLOCATION that enables following + redirects and keeps a custom request method set with + CURLOPT_CUSTOMREQUEST in use for all requests, even + after redirects. + Available as of PHP 8.5.0 and cURL 8.13.0. + + + + + + CURLFOLLOW_OBEYCODE + (int) + + + + Value for CURLOPT_FOLLOWLOCATION that enables following + redirects while obeying the HTTP response code: a custom request method set + with CURLOPT_CUSTOMREQUEST is kept, except that it is + changed to GET on the redirect status codes that require + it (such as 301, 302 and 303). + Available as of PHP 8.5.0 and cURL 8.13.0. + + + + + + CURLFOLLOW_FIRSTONLY + (int) + + + + Value for CURLOPT_FOLLOWLOCATION that enables following + redirects but uses a custom request method set with + CURLOPT_CUSTOMREQUEST for the first request only; + subsequent requests follow the method dictated by the redirect response code. + Available as of PHP 8.5.0 and cURL 8.13.0. + + + CURLFTPAUTH_DEFAULT diff --git a/reference/curl/constants_curl_getinfo.xml b/reference/curl/constants_curl_getinfo.xml index 115537120642..c2295e288ee8 100644 --- a/reference/curl/constants_curl_getinfo.xml +++ b/reference/curl/constants_curl_getinfo.xml @@ -70,6 +70,18 @@ + + + CURLINFO_CONN_ID + (int) + + + + The ID of the last connection used by the transfer. The connection ID is unique among all connections using the same connection cache and is useful to tell connection reuse apart. + Available as of PHP 8.5.0 and cURL 8.2.0. + + + CURLINFO_CONNECT_TIME @@ -251,6 +263,18 @@ + + + CURLINFO_HTTPAUTH_USED + (int) + + + + Bitmask indicating the HTTP authentication method(s) actually used in the previous request. + Available as of PHP 8.5.0 and cURL 8.12.0. + + + CURLINFO_HTTP_CODE @@ -444,6 +468,18 @@ + + + CURLINFO_PROXYAUTH_USED + (int) + + + + Bitmask indicating the proxy authentication method(s) actually used in the previous request. + Available as of PHP 8.5.0 and cURL 8.12.0. + + + CURLINFO_PROXY_ERROR @@ -468,6 +504,18 @@ + + + CURLINFO_QUEUE_TIME_T + (int) + + + + The time, in microseconds, that the transfer was held in a waiting queue before it started, due to limits set with CURLMOPT_MAX_TOTAL_CONNECTIONS or similar options. + Available as of PHP 8.5.0 and cURL 8.6.0. + + + CURLINFO_REDIRECT_COUNT @@ -776,6 +824,18 @@ + + + CURLINFO_USED_PROXY + (int) + + + + Whether the previous transfer used a proxy; returns 1 if a proxy was used and 0 otherwise. + Available as of PHP 8.5.0 and cURL 8.7.0. + + + CURLINFO_POSTTRANSFER_TIME_T diff --git a/reference/curl/constants_curl_setopt.xml b/reference/curl/constants_curl_setopt.xml index e482c47d17ff..07d2192a5540 100644 --- a/reference/curl/constants_curl_setopt.xml +++ b/reference/curl/constants_curl_setopt.xml @@ -1380,6 +1380,21 @@ + + + CURLOPT_INFILESIZE_LARGE + (int) + + + + The expected size, in bytes, of the file when uploading a file to + a remote site. This is the 64-bit variant of + CURLOPT_INFILESIZE, allowing sizes larger than + 2 GB to be specified. + Available as of PHP 8.5.0. + + + CURLOPT_INTERFACE