From 826c2e6d807570a97837fd79992c46e8a66108d7 Mon Sep 17 00:00:00 2001
From: Ayesh Karunaratne <ayesh@aye.sh>
Date: Thu, 14 Nov 2024 22:55:08 +0700
Subject: [PATCH] [PHP 8.4] Curl: Add `CURLOPT_DEBUGFUNCTION`

Commit: php/php-src#15674
PHP.Watch: [PHP 8.4: Curl: New `CURLOPT_DEBUGFUNCTION` option](https://php.watch/versions/8.4/CURLOPT_DEBUGFUNCTION)
---
 reference/curl/constants_curl_setopt.xml | 127 +++++++++++++++++++++++
 1 file changed, 127 insertions(+)

diff --git a/reference/curl/constants_curl_setopt.xml b/reference/curl/constants_curl_setopt.xml
index 37c751a590ed..263eb19d270c 100644
--- a/reference/curl/constants_curl_setopt.xml
+++ b/reference/curl/constants_curl_setopt.xml
@@ -4534,4 +4534,131 @@
     </para>
    </listitem>
   </varlistentry>
+  <varlistentry xml:id="constant.curlopt-debugfunction">
+   <term>
+    <constant>CURLOPT_DEBUGFUNCTION</constant>
+    (<type>int</type>)
+   </term>
+   <listitem>
+    <para>
+     Available as of PHP 8.4.0.
+     This option requires <constant>CURLOPT_VERBOSE</constant> option enabled.
+     A <type>callable</type> to replace the standard cURL verbose output.
+     This callback gets called during various stages of the request with verbose debug information.
+     The callback should match the following signature:
+     <methodsynopsis>
+      <type>void</type><methodname><replaceable>callback</replaceable></methodname>
+      <methodparam><type>CurlHandle</type><parameter>curlHandle</parameter></methodparam>
+      <methodparam><type>int</type><parameter>type</parameter></methodparam>
+      <methodparam><type>string</type><parameter>data</parameter></methodparam>
+     </methodsynopsis>
+     <variablelist role="function_parameters">
+      <varlistentry>
+       <term><parameter>curlHandle</parameter></term>
+       <listitem>
+        <simpara>
+         The cURL handle.
+        </simpara>
+       </listitem>
+      </varlistentry>
+      <varlistentry>
+       <term><parameter>type</parameter></term>
+       <listitem>
+        <simpara>
+         One of the following constants indicating the type of the <parameter>data</parameter> value:
+        </simpara>
+        <variablelist xml:id="constant.curl-debugfunction.constants" role="constant_list">
+         <varlistentry xml:id="constant.curlinfo-text">
+          <term>
+           <constant>CURLINFO_TEXT</constant>
+           (<type>int</type>)
+          </term>
+          <listitem>
+           <simpara>
+            Informational text.
+           </simpara>
+          </listitem>
+         </varlistentry>
+         <varlistentry xml:id="constant.curlinfo-header-in">
+          <term>
+           <constant>CURLINFO_HEADER_IN</constant>
+           (<type>int</type>)
+          </term>
+          <listitem>
+           <simpara>
+            Header (or header-like) data received from the peer.
+           </simpara>
+          </listitem>
+         </varlistentry>
+         <varlistentry xml:id="constant.curlinfo-header-out-debug">
+          <term>
+           <constant linkend="constant.curlinfo-header-out-debug">CURLINFO_HEADER_OUT</constant>
+           (<type>int</type>)
+          </term>
+          <listitem>
+           <simpara>
+            Header (or header-like) data sent to the peer.
+           </simpara>
+          </listitem>
+         </varlistentry>
+         <varlistentry xml:id="constant.curlinfo-data-in">
+          <term>
+           <constant>CURLINFO_DATA_IN</constant>
+           (<type>int</type>)
+          </term>
+          <listitem>
+           <simpara>
+            Unprocessed protocol data received from the peer.
+            Even if the data is encoded or compressed, it is not provided decoded nor decompressed to this callback.
+           </simpara>
+          </listitem>
+         </varlistentry>
+         <varlistentry xml:id="constant.curlinfo-data-out">
+          <term>
+           <constant>CURLINFO_DATA_OUT</constant>
+           (<type>int</type>)
+          </term>
+          <listitem>
+           <simpara>
+            Protocol data sent to the peer.
+           </simpara>
+          </listitem>
+         </varlistentry>
+         <varlistentry xml:id="constant.curlinfo-ssl-data-in">
+          <term>
+           <constant>CURLINFO_SSL_DATA_IN</constant>
+           (<type>int</type>)
+          </term>
+          <listitem>
+           <simpara>
+            <acronym>SSL</acronym>/<acronym>TLS</acronym> (binary) data received from the peer.
+           </simpara>
+          </listitem>
+         </varlistentry>
+         <varlistentry xml:id="constant.curlinfo-ssl-data-out">
+          <term>
+           <constant>CURLINFO_SSL_DATA_OUT</constant>
+           (<type>int</type>)
+          </term>
+          <listitem>
+           <simpara>
+            <acronym>SSL</acronym>/<acronym>TLS</acronym> (binary) data sent to the peer.
+           </simpara>
+          </listitem>
+         </varlistentry>
+        </variablelist>
+       </listitem>
+      </varlistentry>
+      <varlistentry>
+       <term><parameter>data</parameter></term>
+       <listitem>
+        <simpara>
+         Verbose debug data of the type indicate by the <parameter>type</parameter> parameter.
+        </simpara>
+       </listitem>
+      </varlistentry>
+     </variablelist>
+    </para>
+   </listitem>
+  </varlistentry>
  </variablelist>