Add new curl_upkeep() function

Author: adoy

NEWS

@@ -12,6 +12,7 @@ PHP                                                                        NEWS
 
 - Curl:
   . Added new constants from cURL 7.62 to 7.80. (Pierrick)
+  . New function curl_upkeep(). (Pierrick)
 
 - MBString:
   . Backwards-compatible mappings for 0x5C/0x7E in Shift-JIS are restored,

UPGRADING

@@ -77,6 +77,7 @@ PHP 8.2 UPGRADE NOTES
   . Added CURLINFO_EFFECTIVE_METHOD option and returning the effective
     HTTP method in curl_getinfo() return value.
   . Exposed multiple new constants from libcurl 7.62 to 7.80.
+  . Added new function curl_upkeep() to perform any connection upkeep checks.
 
 - OCI8:
   . Added an oci8.prefetch_lob_size directive and oci_set_prefetch_lob()
@@ -174,6 +175,9 @@ PHP 8.2 UPGRADE NOTES
 6. New Functions
 ========================================
 
+- Curl:
+  . curl_upkeep() (libcurl >= 7.62.0)
+
 - Reflection:
   . ReflectionFunction::isAnonymous()
   . ReflectionMethod::hasPrototype()

ext/curl/curl.stub.php

@@ -54,6 +54,10 @@ function curl_getinfo(CurlHandle $handle, ?int $option = null): mixed {}
 /** @refcount 1 */
 function curl_init(?string $url = null): CurlHandle|false {}
 
+#if LIBCURL_VERSION_NUM >= 0x073E00 /* Available since 7.62.0 */
+function curl_upkeep(CurlHandle $handle): bool {}
+#endif
+
 function curl_multi_add_handle(CurlMultiHandle $multi_handle, CurlHandle $handle): int {}
 
 function curl_multi_close(CurlMultiHandle $multi_handle): void {}

ext/curl/curl_arginfo.h

@@ -3989,3 +3989,25 @@ PHP_FUNCTION(curl_pause)
 	RETURN_LONG(curl_easy_pause(ch->cp, bitmask));
 }
 /* }}} */
+
+#if LIBCURL_VERSION_NUM >= 0x073E00 /* Available since 7.62.0 */
+/* {{{ perform connection upkeep checks */
+PHP_FUNCTION(curl_upkeep)
+{
+	CURLcode	error;
+	zval		*zid;
+	php_curl	*ch;
+
+	ZEND_PARSE_PARAMETERS_START(1, 1)
+		Z_PARAM_OBJECT_OF_CLASS(zid, curl_ce)
+	ZEND_PARSE_PARAMETERS_END();
+
+	ch = Z_CURL_P(zid);
+
+	error = curl_easy_upkeep(ch->cp);
+	SAVE_CURL_ERROR(ch, error);
+
+	RETURN_BOOL(error == CURLE_OK);
+}
+/*}}} */
+#endif

ext/curl/interface.c

@@ -0,0 +1,27 @@
+--TEST--
+curl_upkeep() function
+--EXTENSIONS--
+curl
+--SKIPIF--
+<?php
+if (curl_version()['version_number'] < 0x073e00) die('skip requires curl >= 7.62.0');
+?>
+--FILE--
+<?php
+
+$url = "https://example.com";
+
+$ch = curl_init();
+curl_setopt($ch,CURLOPT_URL,$url);
+curl_setopt($ch,CURLOPT_RETURNTRANSFER,true);
+curl_setopt($ch,CURLOPT_HTTP_VERSION,CURL_HTTP_VERSION_2_0);
+curl_setopt($ch,CURLOPT_SSL_VERIFYPEER,false);
+curl_setopt($ch, CURLOPT_UPKEEP_INTERVAL_MS, 200);
+if (curl_exec($ch)) {
+    usleep(300);
+    var_dump(curl_upkeep($ch));
+}
+curl_close($ch);
+?>
+--EXPECT--
+bool(true)