[RFC] Add curl websocket bindings

This adds bindings to Curl's websocket support that was added in
Curl 7.86.0. Instead of just pass-through C bindings, the API added
here is a little more high-level from a type-safety perspective.
I.e. this introduces an enum CurlWsMessageType and a DTO class
CurlWsFrame for nicer and safer API handling.

Still WIP.

Author: ndossche

Zend/Optimizer/zend_func_infos.h

@@ -49,6 +49,10 @@ static const func_info_t func_infos[] = {
 	F1("curl_share_init_persistent", MAY_BE_OBJECT),
 	F1("curl_strerror", MAY_BE_STRING|MAY_BE_NULL),
 	F1("curl_version", MAY_BE_ARRAY|MAY_BE_ARRAY_KEY_STRING|MAY_BE_ARRAY_OF_LONG|MAY_BE_ARRAY_OF_STRING|MAY_BE_ARRAY_OF_ARRAY|MAY_BE_FALSE),
+#if LIBCURL_VERSION_NUM >= 0x075600 /* Available since 7.86.0 */
+	F1("curl_ws_meta", MAY_BE_OBJECT),
+	F1("curl_ws_recv", MAY_BE_STRING|MAY_BE_FALSE),
+#endif
 	F1("date", MAY_BE_STRING),
 	F1("gmdate", MAY_BE_STRING),
 	F1("strftime", MAY_BE_STRING|MAY_BE_FALSE),

ext/curl/curl.stub.php

@@ -3657,6 +3657,16 @@
  * @cvalue CURLWS_RAW_MODE
  */
 const CURLWS_RAW_MODE = UNKNOWN;
+/**
+ * @var int
+ * @cvalue CURLWS_CONT
+ */
+const CURLWS_CONT = UNKNOWN;
+/**
+ * @var int
+ * @cvalue CURLWS_OFFSET
+ */
+const CURLWS_OFFSET = UNKNOWN;
 #endif
 
 #if LIBCURL_VERSION_NUM >= 0x075700 /* Available since 7.87.0 */
@@ -3686,6 +3696,14 @@
  */
 const CURLOPT_SAFE_UPLOAD = UNKNOWN;
 
+#if LIBCURL_VERSION_NUM >= 0x080e00 /* Available since 8.14.0 */
+/**
+ * @var int
+ * @cvalue CURLWS_NOAUTOPONG
+ */
+const CURLWS_NOAUTOPONG = UNKNOWN;
+#endif
+
 /**
  * @strict-properties
  * @not-serializable
@@ -3719,6 +3737,28 @@ final class CurlSharePersistentHandle
     public readonly array $options;
 }
 
+enum CurlWsMessageType
+{
+    case Binary;
+    case Text;
+    case Close;
+    case Ping;
+    case Pong;
+}
+
+/**
+ * @strict-properties
+ * @not-serializable
+ */
+final readonly class CurlWsFrame
+{
+    public CurlWsMessageType $type;
+    public bool $continued;
+    public int $offset;
+    public int $bytesLeft;
+    public int $length;
+}
+
 function curl_close(CurlHandle $handle): void {}
 
 /** @refcount 1 */
@@ -3812,3 +3852,16 @@ function curl_strerror(int $error_code): ?string {}
  * @refcount 1
  */
 function curl_version(): array|false {}
+
+#if LIBCURL_VERSION_NUM >= 0x075600 /* Available since 7.86.0 */
+/** @refcount 1 */
+function curl_ws_meta(CurlHandle $handle): CurlWsFrame {}
+
+/**
+ * @param CurlWsFrame $meta
+ * @refcount 1
+ */
+function curl_ws_recv(CurlHandle $handle, int $length, &$meta = null): string|false {}
+
+function curl_ws_send(CurlHandle $handle, string $buffer, CurlWsMessageType $type = CurlWsMessageType::Text, int $frag_size = 0, int $flags = 0): int {}
+#endif