Add new curl_upkeep() function

Author: adoy

ext/curl/curl.stub.php

@@ -54,6 +54,8 @@ function curl_getinfo(CurlHandle $handle, ?int $option = null): mixed {}
 /** @refcount 1 */
 function curl_init(?string $url = null): CurlHandle|false {}
 
+function curl_upkeep(CurlHandle $handle): bool {}
+
 function curl_multi_add_handle(CurlMultiHandle $multi_handle, CurlHandle $handle): int {}
 
 function curl_multi_close(CurlMultiHandle $multi_handle): void {}

ext/curl/curl_arginfo.h

@@ -1,5 +1,5 @@
 /* This is a generated file, edit the .stub.php file instead.
- * Stub hash: 3abf3f6d5dfb14d2e22ebf5730a869e2c17c7958 */
+ * Stub hash: db30828ac619f11745aacb0a93f198166b603fe7 */
 
 ZEND_BEGIN_ARG_WITH_RETURN_TYPE_INFO_EX(arginfo_curl_close, 0, 1, IS_VOID, 0)
 	ZEND_ARG_OBJ_INFO(0, handle, CurlHandle, 0)
@@ -49,6 +49,10 @@ ZEND_BEGIN_ARG_WITH_RETURN_OBJ_TYPE_MASK_EX(arginfo_curl_init, 0, 0, CurlHandle,
 	ZEND_ARG_TYPE_INFO_WITH_DEFAULT_VALUE(0, url, IS_STRING, 1, "null")
 ZEND_END_ARG_INFO()
 
+ZEND_BEGIN_ARG_WITH_RETURN_TYPE_INFO_EX(arginfo_curl_upkeep, 0, 1, _IS_BOOL, 0)
+	ZEND_ARG_OBJ_INFO(0, handle, CurlHandle, 0)
+ZEND_END_ARG_INFO()
+
 ZEND_BEGIN_ARG_WITH_RETURN_TYPE_INFO_EX(arginfo_curl_multi_add_handle, 0, 2, IS_LONG, 0)
 	ZEND_ARG_OBJ_INFO(0, multi_handle, CurlMultiHandle, 0)
 	ZEND_ARG_OBJ_INFO(0, handle, CurlHandle, 0)
@@ -144,6 +148,7 @@ ZEND_FUNCTION(curl_exec);
 ZEND_FUNCTION(curl_file_create);
 ZEND_FUNCTION(curl_getinfo);
 ZEND_FUNCTION(curl_init);
+ZEND_FUNCTION(curl_upkeep);
 ZEND_FUNCTION(curl_multi_add_handle);
 ZEND_FUNCTION(curl_multi_close);
 ZEND_FUNCTION(curl_multi_errno);
@@ -179,6 +184,7 @@ static const zend_function_entry ext_functions[] = {
 	ZEND_FE(curl_file_create, arginfo_curl_file_create)
 	ZEND_FE(curl_getinfo, arginfo_curl_getinfo)
 	ZEND_FE(curl_init, arginfo_curl_init)
+	ZEND_FE(curl_upkeep, arginfo_curl_upkeep)
 	ZEND_FE(curl_multi_add_handle, arginfo_curl_multi_add_handle)
 	ZEND_FE(curl_multi_close, arginfo_curl_multi_close)
 	ZEND_FE(curl_multi_errno, arginfo_curl_multi_errno)

ext/curl/interface.c

@@ -3954,3 +3954,33 @@ PHP_FUNCTION(curl_pause)
 	RETURN_LONG(curl_easy_pause(ch->cp, bitmask));
 }
 /* }}} */
+
+/* {{{ perform connection upkeep checks */
+PHP_FUNCTION(curl_upkeep)
+{
+#if LIBCURL_VERSION_NUM >= 0x073E00 /* Available since 7.62.0 */
+	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);
+
+	if (error != CURLE_OK) {
+		RETURN_FALSE;
+	} else {
+		RETURN_TRUE;
+	}
+#else
+	php_error_docref(NULL, E_WARNING, "requires libcurl 7.62.0 or later, current version is %s", curl_version_info(CURLVERSION_NOW)->version);
+
+	RETURN_FALSE;
+#endif
+}
+/*}}} */