Skip to content

Commit dfed9c2

Browse files
AyeshAyesh
committed
[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)
1 parent a8273ea commit dfed9c2

File tree

1 file changed

+132
-0
lines changed

1 file changed

+132
-0
lines changed

‎reference/curl/constants_curl_setopt.xml

Lines changed: 132 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4531,4 +4531,136 @@
45314531
</para>
45324532
</listitem>
45334533
</varlistentry>
4534+
<varlistentry xml:id="constant.curlopt-debugfunction">
4535+
<term>
4536+
<constant>CURLOPT_DEBUGFUNCTION</constant>
4537+
(<type>int</type>)
4538+
</term>
4539+
<listitem>
4540+
<para>
4541+
Available as of PHP 8.4.0.
4542+
A <type>callable</type> to replace the standard Curl verbose output.
4543+
This callback gets called during various stages of the request with
4544+
verbose debug information. This option requires <constant>CURLOPT_VERBOSE</constant>
4545+
option enabled. The callback should match the following signature:
4546+
<methodsynopsis>
4547+
<type>void</type><methodname><replaceable>callback</replaceable></methodname>
4548+
<methodparam><type>CurlHandle</type><parameter>curlHandle</parameter></methodparam>
4549+
<methodparam><type>int</type><parameter>type</parameter></methodparam>
4550+
<methodparam><type>string</type><parameter>data</parameter></methodparam>
4551+
</methodsynopsis>
4552+
<variablelist role="function_parameters">
4553+
<varlistentry>
4554+
<term><parameter>curlHandle</parameter></term>
4555+
<listitem>
4556+
<simpara>
4557+
The cURL handle.
4558+
</simpara>
4559+
</listitem>
4560+
</varlistentry>
4561+
<varlistentry>
4562+
<term><parameter>type</parameter></term>
4563+
<listitem>
4564+
<simpara>
4565+
One of <constant>CURLINFO_TEXT</constant>, <constant>CURLINFO_HEADER_IN</constant>,
4566+
<constant linkend="constant.curlinfo-header-out-debug">CURLINFO_HEADER_OUT</constant>, <constant>CURLINFO_DATA_IN</constant>,
4567+
<constant>CURLINFO_DATA_OUT</constant>, <constant>CURLINFO_SSL_DATA_IN</constant>,
4568+
or <constant>CURLINFO_SSL_DATA_OUT</constant> constants indicating the type of the
4569+
<parameter>data</parameter> value.
4570+
</simpara>
4571+
</listitem>
4572+
</varlistentry>
4573+
<varlistentry>
4574+
<term><parameter>data</parameter></term>
4575+
<listitem>
4576+
<simpara>
4577+
Verbose debug data of the type indicate by the <parameter>type</parameter> parameter.
4578+
</simpara>
4579+
</listitem>
4580+
</varlistentry>
4581+
</variablelist>
4582+
</para>
4583+
<variablelist xml:id="constant.curl-debugfunction.constants" role="constant_list">
4584+
<title>Possible values for <varname>type</varname> parameter</title>
4585+
<varlistentry xml:id="constant.curlinfo-text">
4586+
<term>
4587+
<constant>CURLINFO_TEXT</constant>
4588+
(<type>int</type>)
4589+
</term>
4590+
<listitem>
4591+
<simpara>
4592+
Informational text.
4593+
</simpara>
4594+
</listitem>
4595+
</varlistentry>
4596+
<varlistentry xml:id="constant.curlinfo-header-in">
4597+
<term>
4598+
<constant>CURLINFO_HEADER_IN</constant>
4599+
(<type>int</type>)
4600+
</term>
4601+
<listitem>
4602+
<simpara>
4603+
Header (or header-like) data received from the peer.
4604+
</simpara>
4605+
</listitem>
4606+
</varlistentry>
4607+
<varlistentry xml:id="constant.curlinfo-header-out-debug">
4608+
<term>
4609+
<constant>CURLINFO_HEADER_OUT</constant>
4610+
(<type>int</type>)
4611+
</term>
4612+
<listitem>
4613+
<simpara>
4614+
Header (or header-like) data sent to the peer.
4615+
</simpara>
4616+
</listitem>
4617+
</varlistentry>
4618+
<varlistentry xml:id="constant.curlinfo-data-in">
4619+
<term>
4620+
<constant>CURLINFO_DATA_IN</constant>
4621+
(<type>int</type>)
4622+
</term>
4623+
<listitem>
4624+
<simpara>
4625+
Unprocessed protocol data received from the peer. Even if
4626+
the data is encoded or compressed, it is not provided decoded nor decompressed to this callback
4627+
</simpara>
4628+
</listitem>
4629+
</varlistentry>
4630+
<varlistentry xml:id="constant.curlinfo-data-out">
4631+
<term>
4632+
<constant>CURLINFO_DATA_OUT</constant>
4633+
(<type>int</type>)
4634+
</term>
4635+
<listitem>
4636+
<simpara>
4637+
Protocol data sent to the peer
4638+
</simpara>
4639+
</listitem>
4640+
</varlistentry>
4641+
<varlistentry xml:id="constant.curlinfo-ssl-data-in">
4642+
<term>
4643+
<constant>CURLINFO_SSL_DATA_IN</constant>
4644+
(<type>int</type>)
4645+
</term>
4646+
<listitem>
4647+
<simpara>
4648+
SSL/TLS (binary) data received from the peer.
4649+
</simpara>
4650+
</listitem>
4651+
</varlistentry>
4652+
<varlistentry xml:id="constant.curlinfo-ssl-data-out">
4653+
<term>
4654+
<constant>CURLINFO_SSL_DATA_OUT</constant>
4655+
(<type>int</type>)
4656+
</term>
4657+
<listitem>
4658+
<simpara>
4659+
SSL/TLS (binary) data sent to the peer.
4660+
</simpara>
4661+
</listitem>
4662+
</varlistentry>
4663+
</variablelist>
4664+
</listitem>
4665+
</varlistentry>
45344666
</variablelist>

0 commit comments

Comments
 (0)