Skip to content

Commit b586d2f

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 7b2f7ea commit b586d2f

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

0 commit comments

Comments
 (0)