sigmasternchen/php-doc-en
1
0
Fork 0
mirror of https://github.com/sigmasternchen/php-doc-en synced 2025-03-30 15:58:55 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions
php-doc-en/reference/curl/functions/curl-setopt.xml
Christoph Michael Becker d3c48b9ae3 Properly mark up constants as such 
While these constants are supposed to be passed as argument, they are not
parameters per se.  Furthermore, parameters are linked to their declaration
in the PHP rendered version at least, and since there is no declaration,
the links are most useless.


git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@349504 c90b9560-bf6c-de11-be94-00142212c4b1
2020-03-20 15:07:42 +00:00

2559 lines
106 KiB
XML
Raw Blame History

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<refentry xml:id="function.curl-setopt" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>curl_setopt</refname>
<refpurpose>Set an option for a cURL transfer</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>bool</type><methodname>curl_setopt</methodname>
<methodparam><type>resource</type><parameter>ch</parameter></methodparam>
<methodparam><type>int</type><parameter>option</parameter></methodparam>
<methodparam><type>mixed</type><parameter>value</parameter></methodparam>
</methodsynopsis>
<para>
Sets an option on the given cURL session handle.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
&curl.ch.description;
<varlistentry>
<term><parameter>option</parameter></term>
<listitem>
<para>
The <literal>CURLOPT_XXX</literal> option to set.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>value</parameter></term>
<listitem>
<para>
The value to be set on <parameter>option</parameter>.
</para>
<para>
<parameter>value</parameter> should be a <type>bool</type> for the
following values of the <parameter>option</parameter> parameter:
<informaltable>
<tgroup cols="3">
<thead>
<row>
<entry valign="top">Option</entry>
<entry valign="top">Set <parameter>value</parameter> to</entry>
<entry valign="top">Notes</entry>
</row>
</thead>
<tbody>
<row>
<entry valign="top"><constant>CURLOPT_AUTOREFERER</constant></entry>
<entry valign="top">
&true; to automatically set the <literal>Referer:</literal> field in
requests where it follows a <literal>Location:</literal> redirect.
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_BINARYTRANSFER</constant></entry>
<entry valign="top">
&true; to return the raw output when
<constant>CURLOPT_RETURNTRANSFER</constant> is used.
</entry>
<entry valign="top">
From PHP 5.1.3, this option has no effect: the raw output will
always be returned when
<constant>CURLOPT_RETURNTRANSFER</constant> is used.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_COOKIESESSION</constant></entry>
<entry valign="top">
&true; to mark this as a new cookie "session". It will force libcurl
to ignore all cookies it is about to load that are "session cookies"
from the previous session. By default, libcurl always stores and
loads all cookies, independent if they are session cookies or not.
Session cookies are cookies without expiry date and they are meant
to be alive and existing for this "session" only.
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_CERTINFO</constant></entry>
<entry valign="top">
&true; to output SSL certification information to <literal>STDERR</literal>
on secure transfers.
</entry>
<entry valign="top">
Added in cURL 7.19.1.
Available since PHP 5.3.2.
Requires <constant>CURLOPT_VERBOSE</constant> to be on to have an effect.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_CONNECT_ONLY</constant></entry>
<entry valign="top">
&true; tells the library to perform all the required proxy authentication
and connection setup, but no data transfer. This option is implemented for
HTTP, SMTP and POP3.
</entry>
<entry valign="top">
Added in 7.15.2.
Available since PHP 5.5.0.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_CRLF</constant></entry>
<entry valign="top">
&true; to convert Unix newlines to CRLF newlines
on transfers.
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_DISALLOW_USERNAME_IN_URL</constant></entry>
<entry valign="top">
&true; to not allow URLs that include a username. Usernames are allowed by default (0).
</entry>
<entry valign="top">
Added in cURL 7.61.0. Available since PHP 7.3.0.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_DNS_SHUFFLE_ADDRESSES</constant></entry>
<entry valign="top">
&true; to shuffle the order of all returned addresses so that they will be used
in a random order, when a name is resolved and more than one IP address is returned.
This may cause IPv4 to be used before IPv6 or vice versa.
</entry>
<entry valign="top">
Added in cURL 7.60.0. Available since PHP 7.3.0.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_HAPROXYPROTOCOL</constant></entry>
<entry valign="top">
&true; to send an HAProxy PROXY protocol v1 header at the start of the connection.
The default action is not to send this header.
</entry>
<entry valign="top">
Added in cURL 7.60.0. Available since PHP 7.3.0.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_SSH_COMPRESSION</constant></entry>
<entry valign="top">
&true; to enable built-in SSH compression. This is a request, not an order;
the server may or may not do it.
</entry>
<entry valign="top">
Added in cURL 7.56.0. Available since PHP 7.3.0.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_DNS_USE_GLOBAL_CACHE</constant></entry>
<entry valign="top">
&true; to use a global DNS cache. This option is not thread-safe.
It is conditionally enabled by default if PHP is built for non-threaded use
(CLI, FCGI, Apache2-Prefork, etc.).
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_FAILONERROR</constant></entry>
<entry valign="top">
&true; to fail verbosely if the HTTP code returned
is greater than or equal to 400. The default behavior is to return
the page normally, ignoring the code.
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_SSL_FALSESTART</constant></entry>
<entry valign="top">
&true; to enable TLS false start.
</entry>
<entry valign="top">
Added in cURL 7.42.0. Available since PHP 7.0.7.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_FILETIME</constant></entry>
<entry valign="top">
&true; to attempt to retrieve the modification
date of the remote document. This value can be retrieved using
the <constant>CURLINFO_FILETIME</constant> option with
<function>curl_getinfo</function>.
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_FOLLOWLOCATION</constant></entry>
<entry valign="top">
&true; to follow any
<literal>"Location: "</literal> header that the server sends as
part of the HTTP header (note this is recursive, PHP will follow as
many <literal>"Location: "</literal> headers that it is sent,
unless <constant>CURLOPT_MAXREDIRS</constant> is set).
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_FORBID_REUSE</constant></entry>
<entry valign="top">
&true; to force the connection to explicitly
close when it has finished processing, and not be pooled for reuse.
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_FRESH_CONNECT</constant></entry>
<entry valign="top">
&true; to force the use of a new connection
instead of a cached one.
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_FTP_USE_EPRT</constant></entry>
<entry valign="top">
&true; to use EPRT (and LPRT) when doing active
FTP downloads. Use &false; to disable EPRT and LPRT and use PORT
only.
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_FTP_USE_EPSV</constant></entry>
<entry valign="top">
&true; to first try an EPSV command for FTP
transfers before reverting back to PASV. Set to &false;
to disable EPSV.
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_FTP_CREATE_MISSING_DIRS</constant></entry>
<entry valign="top">
&true; to create missing directories when an FTP operation
encounters a path that currently doesn't exist.
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_FTPAPPEND</constant></entry>
<entry valign="top">
&true; to append to the remote file instead of
overwriting it.
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_TCP_NODELAY</constant></entry>
<entry valign="top">
&true; to disable TCP's Nagle algorithm, which tries to minimize
the number of small packets on the network.
</entry>
<entry valign="top">
Available since PHP 5.2.1 for versions compiled with libcurl 7.11.2 or
greater.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_FTPASCII</constant></entry>
<entry valign="top">
An alias of
<constant>CURLOPT_TRANSFERTEXT</constant>. Use that instead.
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_FTPLISTONLY</constant></entry>
<entry valign="top">
&true; to only list the names of an FTP
directory.
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_HEADER</constant></entry>
<entry valign="top">
&true; to include the header in the output.
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry><constant>CURLINFO_HEADER_OUT</constant></entry>
<entry valign="top">
&true; to track the handle's request string.
</entry>
<entry valign="top">
Available since PHP 5.1.3. The <constant>CURLINFO_</constant>
prefix is intentional.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_HTTP09_ALLOWED </constant></entry>
<entry valign="top">
Whether to allow HTTP/0.9 responses. Defaults to &false; as of libcurl 7.66.0;
formerly it defaulted to &true;.
</entry>
<entry valign="top">
Available since PHP 7.3.15 and 7.4.3, respectively, if built against libcurl >= 7.64.0
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_HTTPGET</constant></entry>
<entry valign="top">
&true; to reset the HTTP request method to GET.
Since GET is the default, this is only necessary if the request
method has been changed.
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_HTTPPROXYTUNNEL</constant></entry>
<entry valign="top">
&true; to tunnel through a given HTTP proxy.
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_HTTP_CONTENT_DECODING</constant></entry>
<entry valign="top">
&false; to get the raw HTTP response body.
</entry>
<entry valign="top">
Available as of PHP 5.5.0 if built against libcurl >= 7.16.2.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_KEEP_SENDING_ON_ERROR</constant></entry>
<entry valign="top">
&true; to keep sending the request body if the HTTP code returned is
equal to or larger than 300. The default action would be to stop sending
and close the stream or connection. Suitable for manual NTLM authentication.
Most applications do not need this option.
</entry>
<entry valign="top">
Available as of PHP 7.3.0 if built against libcurl >= 7.51.0.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_MUTE</constant></entry>
<entry valign="top">
&true; to be completely silent with regards to
the cURL functions.
</entry>
<entry valign="top">
Removed in cURL 7.15.5 (You can use CURLOPT_RETURNTRANSFER instead)
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_NETRC</constant></entry>
<entry valign="top">
&true; to scan the <filename>~/.netrc</filename>
file to find a username and password for the remote site that
a connection is being established with.
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_NOBODY</constant></entry>
<entry valign="top">
&true; to exclude the body from the output.
Request method is then set to HEAD. Changing this to &false; does
not change it to GET.
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_NOPROGRESS</constant></entry>
<entry valign="top"><para>
&true; to disable the progress meter for cURL transfers.
<note>
<para>
PHP automatically sets this option to &true;, this should only be
changed for debugging purposes.
</para>
</note>
</para></entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_NOSIGNAL</constant></entry>
<entry valign="top">
&true; to ignore any cURL function that causes a
signal to be sent to the PHP process. This is turned on by default
in multi-threaded SAPIs so timeout options can still be used.
</entry>
<entry valign="top">
Added in cURL 7.10.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_PATH_AS_IS</constant></entry>
<entry valign="top">
&true; to not handle dot dot sequences.
</entry>
<entry valign="top">
Added in cURL 7.42.0. Available since PHP 7.0.7.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_PIPEWAIT</constant></entry>
<entry valign="top">
&true; to wait for pipelining/multiplexing.
</entry>
<entry valign="top">
Added in cURL 7.43.0. Available since PHP 7.0.7.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_POST</constant></entry>
<entry valign="top">
&true; to do a regular HTTP POST. This POST is the
normal <literal>application/x-www-form-urlencoded</literal> kind,
most commonly used by HTML forms.
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_PUT</constant></entry>
<entry valign="top">
&true; to HTTP PUT a file. The file to PUT must
be set with <constant>CURLOPT_INFILE</constant> and
<constant>CURLOPT_INFILESIZE</constant>.
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_RETURNTRANSFER</constant></entry>
<entry valign="top">
&true; to return the transfer as a string of the
return value of <function>curl_exec</function> instead of outputting
it directly.
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_SAFE_UPLOAD</constant></entry>
<entry valign="top">
&true; to disable support for the <literal>@</literal> prefix for
uploading files in <constant>CURLOPT_POSTFIELDS</constant>, which
means that values starting with <literal>@</literal> can be safely
passed as fields. <classname>CURLFile</classname> may be used for
uploads instead.
</entry>
<entry valign="top">
Added in PHP 5.5.0 with &false; as the default value. PHP 5.6.0
changes the default value to &true;. PHP 7 removes this option;
the CURLFile interface must be used to upload files.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_SASL_IR</constant></entry>
<entry valign="top">
&true; to enable sending the initial response in the first packet.
</entry>
<entry valign="top">
Added in cURL 7.31.10. Available since PHP 7.0.7.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_SSL_ENABLE_ALPN</constant></entry>
<entry valign="top">
&false; to disable ALPN in the SSL handshake (if the SSL backend
libcurl is built to use supports it), which can be used to
negotiate http2.
</entry>
<entry valign="top">
Added in cURL 7.36.0. Available since PHP 7.0.7.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_SSL_ENABLE_NPN</constant></entry>
<entry valign="top">
&false; to disable NPN in the SSL handshake (if the SSL backend
libcurl is built to use supports it), which can be used to
negotiate http2.
</entry>
<entry valign="top">
Added in cURL 7.36.0. Available since PHP 7.0.7.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_SSL_VERIFYPEER</constant></entry>
<entry valign="top">
&false; to stop cURL from verifying the peer's
certificate. Alternate certificates to verify against can be
specified with the <constant>CURLOPT_CAINFO</constant> option
or a certificate directory can be specified with the
<constant>CURLOPT_CAPATH</constant> option.
</entry>
<entry valign="top">
&true; by default as of cURL 7.10. Default bundle installed as of
cURL 7.10.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_SSL_VERIFYSTATUS</constant></entry>
<entry valign="top">
&true; to verify the certificate's status.
</entry>
<entry valign="top">
Added in cURL 7.41.0. Available since PHP 7.0.7.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_PROXY_SSL_VERIFYPEER</constant></entry>
<entry valign="top">
&false; to stop cURL from verifying the peer's certificate.
Alternate certificates to verify against can be
specified with the <constant>CURLOPT_CAINFO</constant> option
or a certificate directory can be specified with the
<constant>CURLOPT_CAPATH</constant> option.
When set to false, the peer certificate verification succeeds regardless.
</entry>
<entry valign="top">
&true; by default. Available since PHP 7.3.0 and libcurl >= cURL 7.52.0.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_SUPPRESS_CONNECT_HEADERS</constant></entry>
<entry valign="top">
&true; to suppress proxy CONNECT response headers from the user callback functions
<constant>CURLOPT_HEADERFUNCTION</constant> and <constant>CURLOPT_WRITEFUNCTION</constant>,
when <constant>CURLOPT_HTTPPROXYTUNNEL</constant> is used and a CONNECT request is made.
</entry>
<entry valign="top">
Added in cURL 7.54.0. Available since PHP 7.3.0.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_TCP_FASTOPEN</constant></entry>
<entry valign="top">
&true; to enable TCP Fast Open.
</entry>
<entry valign="top">
Added in cURL 7.49.0. Available since PHP 7.0.7.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_TFTP_NO_OPTIONS</constant></entry>
<entry valign="top">
&true; to not send TFTP options requests.
</entry>
<entry valign="top">
Added in cURL 7.48.0. Available since PHP 7.0.7.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_TRANSFERTEXT</constant></entry>
<entry valign="top">
&true; to use ASCII mode for FTP transfers.
For LDAP, it retrieves data in plain text instead of HTML. On
Windows systems, it will not set <literal>STDOUT</literal> to binary
mode.
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_UNRESTRICTED_AUTH</constant></entry>
<entry valign="top">
&true; to keep sending the username and password
when following locations (using
<constant>CURLOPT_FOLLOWLOCATION</constant>), even when the
hostname has changed.
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_UPLOAD</constant></entry>
<entry valign="top">
&true; to prepare for an upload.
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_VERBOSE</constant></entry>
<entry valign="top">
&true; to output verbose information. Writes
output to <literal>STDERR</literal>, or the file specified using
<constant>CURLOPT_STDERR</constant>.
</entry>
<entry valign="top">
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</para>
<para>
<parameter>value</parameter> should be an <type>integer</type> for the
following values of the <parameter>option</parameter> parameter:
<informaltable>
<tgroup cols="3">
<thead>
<row>
<entry>Option</entry>
<entry>Set <parameter>value</parameter> to</entry>
<entry>Notes</entry>
</row>
</thead>
<tbody>
<row>
<entry valign="top"><constant>CURLOPT_BUFFERSIZE</constant></entry>
<entry valign="top">
The size of the buffer to use for each read. There is no guarantee
this request will be fulfilled, however.
</entry>
<entry valign="top">
Added in cURL 7.10.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_CLOSEPOLICY</constant></entry>
<entry valign="top">
One of the <constant>CURLCLOSEPOLICY_*</constant> values.
<note>
<para>
This option is deprecated, as it was never implemented in cURL and
never had any effect.
</para>
</note>
</entry>
<entry valign="top">
Removed in PHP 5.6.0.
</entry>
</row>
<row>
<entry><constant>CURLOPT_CONNECTTIMEOUT</constant></entry>
<entry valign="top">
The number of seconds to wait while trying to connect. Use 0 to
wait indefinitely.
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_CONNECTTIMEOUT_MS</constant></entry>
<entry valign="top">
The number of milliseconds to wait while trying to connect. Use 0 to
wait indefinitely.
<!-- http://curl.haxx.se/libcurl/c/curl_easy_setopt.html -->
If libcurl is built to use the standard system name resolver, that
portion of the connect will still use full-second resolution for
timeouts with a minimum timeout allowed of one second.
</entry>
<entry valign="top">
Added in cURL 7.16.2. Available since PHP 5.2.3.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_DNS_CACHE_TIMEOUT</constant></entry>
<entry valign="top">
The number of seconds to keep DNS entries in memory. This
option is set to 120 (2 minutes) by default.
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_EXPECT_100_TIMEOUT_MS</constant></entry>
<entry valign="top">
The timeout for Expect: 100-continue responses in milliseconds.
Defaults to 1000 milliseconds.
</entry>
<entry valign="top">
Added in cURL 7.36.0. Available since PHP 7.0.7.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_HAPPY_EYEBALLS_TIMEOUT_MS</constant></entry>
<entry valign="top">
Head start for ipv6 for the happy eyeballs algorithm. Happy eyeballs attempts
to connect to both IPv4 and IPv6 addresses for dual-stack hosts,
preferring IPv6 first for timeout milliseconds.
Defaults to CURL_HET_DEFAULT, which is currently 200 milliseconds.
</entry>
<entry valign="top">
Added in cURL 7.59.0. Available since PHP 7.3.0.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_FTPSSLAUTH</constant></entry>
<entry valign="top">
The FTP authentication method (when is activated):
<literal>CURLFTPAUTH_SSL</literal> (try SSL first),
<literal>CURLFTPAUTH_TLS</literal> (try TLS first), or
<literal>CURLFTPAUTH_DEFAULT</literal> (let cURL decide).
</entry>
<entry valign="top">
Added in cURL 7.12.2.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_HEADEROPT</constant></entry>
<entry valign="top">
How to deal with headers. One of the following constants:
<simpara>
<constant>CURLHEADER_UNIFIED</constant>: the headers specified in
<constant>CURLOPT_HTTPHEADER</constant> will be used in requests
both to servers and proxies. With this option enabled,
<constant>CURLOPT_PROXYHEADER</constant> will not have any effect.
</simpara>
<simpara>
<constant>CURLHEADER_SEPARATE</constant>: makes
<constant>CURLOPT_HTTPHEADER</constant> headers only get sent to
a server and not to a proxy. Proxy headers must be set with
<constant>CURLOPT_PROXYHEADER</constant> to get used. Note that if
a non-CONNECT request is sent to a proxy, libcurl will send both
server headers and proxy headers. When doing CONNECT, libcurl will
send <constant>CURLOPT_PROXYHEADER</constant> headers only to the
proxy and then <constant>CURLOPT_HTTPHEADER</constant> headers
only to the server.
</simpara>
<simpara>
Defaults to <constant>CURLHEADER_SEPARATE</constant> as of cURL
7.42.1, and <constant>CURLHEADER_UNIFIED</constant> before.
</simpara>
</entry>
<entry valign="top">
Added in cURL 7.37.0. Available since PHP 7.0.7.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_HTTP_VERSION</constant></entry>
<entry valign="top">
<constant>CURL_HTTP_VERSION_NONE</constant> (default, lets CURL
decide which version to use),
<constant>CURL_HTTP_VERSION_1_0</constant> (forces HTTP/1.0),
or <constant>CURL_HTTP_VERSION_1_1</constant> (forces HTTP/1.1).
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_HTTPAUTH</constant></entry>
<entry valign="top">
<para>
The HTTP authentication method(s) to use. The options are:
<constant>CURLAUTH_BASIC</constant>,
<constant>CURLAUTH_DIGEST</constant>,
<constant>CURLAUTH_GSSNEGOTIATE</constant>,
<constant>CURLAUTH_NTLM</constant>,
<constant>CURLAUTH_ANY</constant>, and
<constant>CURLAUTH_ANYSAFE</constant>.
</para>
<para>
The bitwise <literal>|</literal> (or) operator can be used to combine
more than one method. If this is done, cURL will poll the server to see
what methods it supports and pick the best one.
</para>
<para>
<constant>CURLAUTH_ANY</constant> is an alias for
<literal>CURLAUTH_BASIC | CURLAUTH_DIGEST | CURLAUTH_GSSNEGOTIATE | CURLAUTH_NTLM</literal>.
</para>
<para>
<constant>CURLAUTH_ANYSAFE</constant> is an alias for
<literal>CURLAUTH_DIGEST | CURLAUTH_GSSNEGOTIATE | CURLAUTH_NTLM</literal>.
</para>
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_INFILESIZE</constant></entry>
<entry valign="top">
The expected size, in bytes, of the file when uploading a file to
a remote site. Note that using this option will not stop libcurl
from sending more data, as exactly what is sent depends on
<constant>CURLOPT_READFUNCTION</constant>.
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_LOW_SPEED_LIMIT</constant></entry>
<entry valign="top">
The transfer speed, in bytes per second, that the transfer should be
below during the count of <constant>CURLOPT_LOW_SPEED_TIME</constant>
seconds before PHP considers the transfer too slow and aborts.
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_LOW_SPEED_TIME</constant></entry>
<entry valign="top">
The number of seconds the transfer speed should be below
<constant>CURLOPT_LOW_SPEED_LIMIT</constant> before PHP considers
the transfer too slow and aborts.
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_MAXCONNECTS</constant></entry>
<entry valign="top">
The maximum amount of persistent connections that are allowed.
When the limit is reached,
<constant>CURLOPT_CLOSEPOLICY</constant> is used to determine
which connection to close.
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_MAXREDIRS</constant></entry>
<entry valign="top">
The maximum amount of HTTP redirections to follow. Use this option
alongside <constant>CURLOPT_FOLLOWLOCATION</constant>.
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_PORT</constant></entry>
<entry valign="top">
An alternative port number to connect to.
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_POSTREDIR</constant></entry>
<entry valign="top">
A bitmask of 1 (301 Moved Permanently), 2 (302 Found)
and 4 (303 See Other) if the HTTP POST method should be maintained
when <constant>CURLOPT_FOLLOWLOCATION</constant> is set and a
specific type of redirect occurs.
</entry>
<entry valign="top">
Added in cURL 7.19.1. Available since PHP 5.3.2.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_PROTOCOLS</constant></entry>
<entry valign="top">
<para>
Bitmask of <constant>CURLPROTO_*</constant> values. If used, this bitmask
limits what protocols libcurl may use in the transfer. This allows you to have
a libcurl built to support a wide range of protocols but still limit specific
transfers to only be allowed to use a subset of them. By default libcurl will
accept all protocols it supports.
See also <constant>CURLOPT_REDIR_PROTOCOLS</constant>.
</para>
<para>
Valid protocol options are:
<constant>CURLPROTO_HTTP</constant>,
<constant>CURLPROTO_HTTPS</constant>,
<constant>CURLPROTO_FTP</constant>,
<constant>CURLPROTO_FTPS</constant>,
<constant>CURLPROTO_SCP</constant>,
<constant>CURLPROTO_SFTP</constant>,
<constant>CURLPROTO_TELNET</constant>,
<constant>CURLPROTO_LDAP</constant>,
<constant>CURLPROTO_LDAPS</constant>,
<constant>CURLPROTO_DICT</constant>,
<constant>CURLPROTO_FILE</constant>,
<constant>CURLPROTO_TFTP</constant>,
<constant>CURLPROTO_ALL</constant>
</para>
</entry>
<entry valign="top">
Added in cURL 7.19.4.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_PROXYAUTH</constant></entry>
<entry valign="top">
The HTTP authentication method(s) to use for the proxy connection.
Use the same bitmasks as described in
<constant>CURLOPT_HTTPAUTH</constant>. For proxy authentication,
only <constant>CURLAUTH_BASIC</constant> and
<constant>CURLAUTH_NTLM</constant> are currently supported.
</entry>
<entry valign="top">
Added in cURL 7.10.7.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_PROXYPORT</constant></entry>
<entry valign="top">
The port number of the proxy to connect to. This port number can
also be set in <constant>CURLOPT_PROXY</constant>.
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_PROXYTYPE</constant></entry>
<entry valign="top">
Either <constant>CURLPROXY_HTTP</constant> (default),
<constant>CURLPROXY_SOCKS4</constant>,
<constant>CURLPROXY_SOCKS5</constant>,
<constant>CURLPROXY_SOCKS4A</constant> or
<constant>CURLPROXY_SOCKS5_HOSTNAME</constant>.
</entry>
<entry valign="top">
Added in cURL 7.10.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_REDIR_PROTOCOLS</constant></entry>
<entry valign="top">
Bitmask of <constant>CURLPROTO_*</constant> values. If used, this bitmask
limits what protocols libcurl may use in a transfer that it follows to in
a redirect when <constant>CURLOPT_FOLLOWLOCATION</constant> is enabled.
This allows you to limit specific transfers to only be allowed to use a subset
of protocols in redirections. By default libcurl will allow all protocols
except for FILE and SCP. This is a difference compared to pre-7.19.4 versions
which unconditionally would follow to all protocols supported.
See also <constant>CURLOPT_PROTOCOLS</constant> for protocol constant values.
</entry>
<entry valign="top">
Added in cURL 7.19.4.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_RESUME_FROM</constant></entry>
<entry valign="top">
The offset, in bytes, to resume a transfer from.
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_SOCKS5_AUTH</constant></entry>
<entry valign="top">
<para>
The SOCKS5 authentication method(s) to use. The options are:
<constant>CURLAUTH_BASIC</constant>,
<constant>CURLAUTH_GSSAPI</constant>,
<constant>CURLAUTH_NONE</constant>.
</para>
<para>
The bitwise <literal>|</literal> (or) operator can be used to combine
more than one method. If this is done, cURL will poll the server to see
what methods it supports and pick the best one.
</para>
<para>
<constant>CURLAUTH_BASIC</constant> allows username/password authentication.
</para>
<para>
<constant>CURLAUTH_GSSAPI</constant> allows GSS-API authentication.
</para>
<para>
<constant>CURLAUTH_NONE</constant> allows no authentication.
</para>
<para>
Defaults to <literal>CURLAUTH_BASIC|CURLAUTH_GSSAPI</literal>.
Set the actual username and password with the <constant>CURLOPT_PROXYUSERPWD</constant> option.
</para>
</entry>
<entry valign="top">
Available as of 7.3.0 and curl >= 7.55.0.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_SSL_OPTIONS</constant></entry>
<entry valign="top">
Set SSL behavior options, which is a bitmask of any of the following constants:
<simpara>
<constant>CURLSSLOPT_ALLOW_BEAST</constant>: do not attempt to use
any workarounds for a security flaw in the SSL3 and TLS1.0 protocols.
</simpara>
<simpara>
<constant>CURLSSLOPT_NO_REVOKE</constant>: disable certificate
revocation checks for those SSL backends where such behavior is
present.
</simpara>
</entry>
<entry valign="top">
Added in cURL 7.25.0. Available since PHP 7.0.7.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_SSL_VERIFYHOST</constant></entry>
<entry valign="top">
<literal>1</literal> to check the existence of a common name in the
SSL peer certificate. <literal>2</literal> to check the existence of
a common name and also verify that it matches the hostname
provided. <literal>0</literal> to not check the names. In production environments the value of this option
should be kept at <literal>2</literal> (default value).
</entry>
<entry valign="top">
Support for value <literal>1</literal> removed in cURL 7.28.1.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_SSLVERSION</constant></entry>
<entry valign="top">
One of <constant>CURL_SSLVERSION_DEFAULT</constant> (0),
<constant>CURL_SSLVERSION_TLSv1</constant> (1),
<constant>CURL_SSLVERSION_SSLv2</constant> (2),
<constant>CURL_SSLVERSION_SSLv3</constant> (3),
<constant>CURL_SSLVERSION_TLSv1_0</constant> (4),
<constant>CURL_SSLVERSION_TLSv1_1</constant> (5) or
<constant>CURL_SSLVERSION_TLSv1_2</constant> (6).
The maximum TLS version can be set by using one of the <constant>CURL_SSLVERSION_MAX_*</constant>
constants. It is also possible to OR one of the <constant>CURL_SSLVERSION_*</constant>
constants with one of the <constant>CURL_SSLVERSION_MAX_*</constant> constants.
<constant>CURL_SSLVERSION_MAX_DEFAULT</constant> (the maximum version supported by the library),
<constant>CURL_SSLVERSION_MAX_TLSv1_0</constant>,
<constant>CURL_SSLVERSION_MAX_TLSv1_1</constant>,
<constant>CURL_SSLVERSION_MAX_TLSv1_2</constant>, or
<constant>CURL_SSLVERSION_MAX_TLSv1_3</constant>.
<note>
<para>
Your best bet is to not set this and let it use the default.
Setting it to 2 or 3 is very dangerous given the known
vulnerabilities in SSLv2 and SSLv3.
</para>
</note>
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_PROXY_SSL_OPTIONS</constant></entry>
<entry valign="top">
Set proxy SSL behavior options, which is a bitmask of any of the following constants:
<simpara>
<constant>CURLSSLOPT_ALLOW_BEAST</constant>: do not attempt to use
any workarounds for a security flaw in the SSL3 and TLS1.0 protocols.
</simpara>
<simpara>
<constant>CURLSSLOPT_NO_REVOKE</constant>: disable certificate
revocation checks for those SSL backends where such behavior is
present. (curl >= 7.44.0)
</simpara>
<simpara>
<constant>CURLSSLOPT_NO_PARTIALCHAIN</constant>: do not accept "partial"
certificate chains, which it otherwise does by default. (curl >= 7.68.0)
</simpara>
</entry>
<entry valign="top">
Available since PHP 7.3.0 and libcurl >= cURL 7.52.0.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_PROXY_SSL_VERIFYHOST</constant></entry>
<entry valign="top">
Set to <literal>2</literal> to verify in the HTTPS proxy's certificate name fields against the proxy name.
When set to <literal>0</literal> the connection succeeds regardless of the names used in the certificate.
Use that ability with caution!
<literal>1</literal> treated as a debug option in curl 7.28.0 and earlier.
From curl 7.28.1 to 7.65.3 <constant>CURLE_BAD_FUNCTION_ARGUMENT</constant> is returned.
From curl 7.66.0 onwards <literal>1</literal> and <literal>2</literal> is treated as the same value.
In production environments the value of this option should be kept at <literal>2</literal> (default value).
</entry>
<entry valign="top">
Available since PHP 7.3.0 and libcurl >= cURL 7.52.0.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_PROXY_SSLVERSION</constant></entry>
<entry valign="top">
One of <constant>CURL_SSLVERSION_DEFAULT</constant>,
<constant>CURL_SSLVERSION_TLSv1</constant>,
<constant>CURL_SSLVERSION_TLSv1_0</constant>,
<constant>CURL_SSLVERSION_TLSv1_1</constant>,
<constant>CURL_SSLVERSION_TLSv1_2</constant>,
<constant>CURL_SSLVERSION_TLSv1_3</constant>,
<constant>CURL_SSLVERSION_MAX_DEFAULT</constant>,
<constant>CURL_SSLVERSION_MAX_TLSv1_0</constant>,
<constant>CURL_SSLVERSION_MAX_TLSv1_1</constant>,
<constant>CURL_SSLVERSION_MAX_TLSv1_2</constant>,
<constant>CURL_SSLVERSION_MAX_TLSv1_3</constant> or
<constant>CURL_SSLVERSION_SSLv3</constant>.
<note>
<para>
Your best bet is to not set this and let it use the default <constant>CURL_SSLVERSION_DEFAULT</constant>
which will attempt to figure out the remote SSL protocol version.
</para>
</note>
</entry>
<entry valign="top">
Available since PHP 7.3.0 and libcurl >= cURL 7.52.0.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_STREAM_WEIGHT</constant></entry>
<entry valign="top">
Set the numerical stream weight (a number between 1 and 256).
</entry>
<entry valign="top">
Added in cURL 7.46.0. Available since PHP 7.0.7.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_TCP_KEEPALIVE</constant></entry>
<entry valign="top">
If set to <literal>1</literal>, TCP keepalive probes will be sent. The delay and
frequency of these probes can be controlled by the <constant>CURLOPT_TCP_KEEPIDLE</constant>
and <constant>CURLOPT_TCP_KEEPINTVL</constant> options, provided the operating system
supports them. If set to <literal>0</literal> (default) keepalive probes are disabled.
</entry>
<entry valign="top">
Added in cURL 7.25.0. Available since PHP 5.5.0.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_TCP_KEEPIDLE</constant></entry>
<entry valign="top">
Sets the delay, in seconds, that the operating system will wait while the connection is
idle before sending keepalive probes, if <constant>CURLOPT_TCP_KEEPALIVE</constant> is
enabled. Not all operating systems support this option.
The default is <literal>60</literal>.
</entry>
<entry valign="top">
Added in cURL 7.25.0. Available since PHP 5.5.0.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_TCP_KEEPINTVL</constant></entry>
<entry valign="top">
Sets the interval, in seconds, that the operating system will wait between sending
keepalive probes, if <constant>CURLOPT_TCP_KEEPALIVE</constant> is enabled.
Not all operating systems support this option.
The default is <literal>60</literal>.
</entry>
<entry valign="top">
Added in cURL 7.25.0. Available since PHP 5.5.0.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_TIMECONDITION</constant></entry>
<entry valign="top">
How <constant>CURLOPT_TIMEVALUE</constant> is treated.
Use <constant>CURL_TIMECOND_IFMODSINCE</constant> to return the
page only if it has been modified since the time specified in
<constant>CURLOPT_TIMEVALUE</constant>. If it hasn't been modified,
a <literal>"304 Not Modified"</literal> header will be returned
assuming <constant>CURLOPT_HEADER</constant> is &true;.
Use <constant>CURL_TIMECOND_IFUNMODSINCE</constant> for the reverse
effect. <constant>CURL_TIMECOND_IFMODSINCE</constant> is the
default.
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_TIMEOUT</constant></entry>
<entry valign="top">
The maximum number of seconds to allow cURL functions to execute.
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_TIMEOUT_MS</constant></entry>
<entry valign="top">
The maximum number of milliseconds to allow cURL functions to
execute.
<!-- http://curl.haxx.se/libcurl/c/curl_easy_setopt.html -->
If libcurl is built to use the standard system name resolver, that
portion of the connect will still use full-second resolution for
timeouts with a minimum timeout allowed of one second.
</entry>
<entry valign="top">
Added in cURL 7.16.2. Available since PHP 5.2.3.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_TIMEVALUE</constant></entry>
<entry valign="top">
The time in seconds since January 1st, 1970. The time will be used
by <constant>CURLOPT_TIMECONDITION</constant>. By default,
<constant>CURL_TIMECOND_IFMODSINCE</constant> is used.
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_TIMEVALUE_LARGE</constant></entry>
<entry valign="top">
The time in seconds since January 1st, 1970. The time will be used
by <constant>CURLOPT_TIMECONDITION</constant>. Defaults to zero.
The difference between this option and <constant>CURLOPT_TIMEVALUE</constant>
is the type of the argument. On systems where 'long' is only 32 bit wide,
this option has to be used to set dates beyond the year 2038.
</entry>
<entry valign="top">
Added in cURL 7.59.0. Available since PHP 7.3.0.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_MAX_RECV_SPEED_LARGE</constant></entry>
<entry valign="top">
If a download exceeds this speed (counted in bytes per second) on
cumulative average during the transfer, the transfer will pause to
keep the average rate less than or equal to the parameter value.
Defaults to unlimited speed.
</entry>
<entry valign="top">
Added in cURL 7.15.5. Available since PHP 5.4.0.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_MAX_SEND_SPEED_LARGE</constant></entry>
<entry valign="top">
If an upload exceeds this speed (counted in bytes per second) on
cumulative average during the transfer, the transfer will pause to
keep the average rate less than or equal to the parameter value.
Defaults to unlimited speed.
</entry>
<entry valign="top">
Added in cURL 7.15.5. Available since PHP 5.4.0.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_SSH_AUTH_TYPES</constant></entry>
<entry valign="top">
A bitmask consisting of one or more of
<constant>CURLSSH_AUTH_PUBLICKEY</constant>,
<constant>CURLSSH_AUTH_PASSWORD</constant>,
<constant>CURLSSH_AUTH_HOST</constant>,
<constant>CURLSSH_AUTH_KEYBOARD</constant>. Set to
<constant>CURLSSH_AUTH_ANY</constant> to let libcurl pick one.
</entry>
<entry valign="top">
Added in cURL 7.16.1.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_IPRESOLVE</constant></entry>
<entry valign="top">
Allows an application to select what kind of IP addresses to use when
resolving host names. This is only interesting when using host names that
resolve addresses using more than one version of IP, possible values are
<constant>CURL_IPRESOLVE_WHATEVER</constant>,
<constant>CURL_IPRESOLVE_V4</constant>,
<constant>CURL_IPRESOLVE_V6</constant>, by default
<constant>CURL_IPRESOLVE_WHATEVER</constant>.
</entry>
<entry valign="top">
Added in cURL 7.10.8.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_FTP_FILEMETHOD</constant></entry>
<entry valign="top">
Tell curl which method to use to reach a file on a FTP(S) server. Possible values are
<constant>CURLFTPMETHOD_MULTICWD</constant>,
<constant>CURLFTPMETHOD_NOCWD</constant> and
<constant>CURLFTPMETHOD_SINGLECWD</constant>.
</entry>
<entry valign="top">
Added in cURL 7.15.1. Available since PHP 5.3.0.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</para>
<para>
<parameter>value</parameter> should be a <type>string</type> for the
following values of the <parameter>option</parameter> parameter:
<informaltable>
<tgroup cols="3">
<thead>
<row>
<entry>Option</entry>
<entry>Set <parameter>value</parameter> to</entry>
<entry>Notes</entry>
</row>
</thead>
<tbody>
<row>
<entry valign="top"><constant>CURLOPT_ABSTRACT_UNIX_SOCKET</constant></entry>
<entry valign="top">
Enables the use of an abstract Unix domain socket instead of
establishing a TCP connection to a host and sets the path to
the given <type>string</type>. This option shares the same semantics
as <constant>CURLOPT_UNIX_SOCKET_PATH</constant>. These two options
share the same storage and therefore only one of them can be set
per handle.
</entry>
<entry valign="top">
Available since PHP 7.3.0 and cURL 7.53.0
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_CAINFO</constant></entry>
<entry valign="top">
The name of a file holding one or more certificates to verify the
peer with. This only makes sense when used in combination with
<constant>CURLOPT_SSL_VERIFYPEER</constant>.
</entry>
<entry valign="top">
Might require an absolute path.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_CAPATH</constant></entry>
<entry valign="top">
A directory that holds multiple CA certificates. Use this option
alongside <constant>CURLOPT_SSL_VERIFYPEER</constant>.
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_COOKIE</constant></entry>
<entry valign="top">
The contents of the <literal>"Cookie: "</literal> header to be
used in the HTTP request.
Note that multiple cookies are separated with a semicolon followed
by a space (e.g., "<literal>fruit=apple; colour=red</literal>")
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_COOKIEFILE</constant></entry>
<entry valign="top">
The name of the file containing the cookie data. The cookie file can
be in Netscape format, or just plain HTTP-style headers dumped into
a file.
If the name is an empty string, no cookies are loaded, but cookie
handling is still enabled.
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_COOKIEJAR</constant></entry>
<entry valign="top">
The name of a file to save all internal cookies to when the handle is closed,
e.g. after a call to curl_close.
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_COOKIELIST</constant></entry>
<entry valign="top">
A cookie string (i.e. a single line in Netscape/Mozilla format, or a regular
HTTP-style Set-Cookie header) adds that single cookie to the internal cookie store.
<literal>"ALL"</literal> erases all cookies held in memory.
<literal>"SESS"</literal> erases all session cookies held in memory.
<literal>"FLUSH"</literal> writes all known cookies to the file specified by <constant>CURLOPT_COOKIEJAR</constant>.
<literal>"RELOAD"</literal> loads all cookies from the files specified by <constant>CURLOPT_COOKIEFILE</constant>.
</entry>
<entry valign="top">
Available since PHP 5.5.0 and cURL 7.14.1.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_CUSTOMREQUEST</constant></entry>
<entry valign="top"><para>
A custom request method to use instead of
<literal>"GET"</literal> or <literal>"HEAD"</literal> when doing
a HTTP request. This is useful for doing
<literal>"DELETE"</literal> or other, more obscure HTTP requests.
Valid values are things like <literal>"GET"</literal>,
<literal>"POST"</literal>, <literal>"CONNECT"</literal> and so on;
i.e. Do not enter a whole HTTP request line here. For instance,
entering <literal>"GET /index.html HTTP/1.0\r\n\r\n"</literal>
would be incorrect.
<note>
<para>
Don't do this without making sure the server supports the custom
request method first.
</para>
</note>
</para></entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_DEFAULT_PROTOCOL</constant></entry>
<entry valign="top"><para>
The default protocol to use if the URL is missing a scheme name.
</para></entry>
<entry valign="top">
Added in cURL 7.45.0. Available since PHP 7.0.7.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_DNS_INTERFACE</constant></entry>
<entry valign="top"><para>
Set the name of the network interface that the DNS resolver should bind to.
This must be an interface name (not an address).
</para></entry>
<entry valign="top">
Added in cURL 7.33.0. Available since PHP 7.0.7.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_DNS_LOCAL_IP4</constant></entry>
<entry valign="top"><para>
Set the local IPv4 address that the resolver should bind to. The argument
should contain a single numerical IPv4 address as a string.
</para></entry>
<entry valign="top">
Added in cURL 7.33.0. Available since PHP 7.0.7.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_DNS_LOCAL_IP6</constant></entry>
<entry valign="top"><para>
Set the local IPv6 address that the resolver should bind to. The argument
should contain a single numerical IPv6 address as a string.
</para></entry>
<entry valign="top">
Added in cURL 7.33.0. Available since PHP 7.0.7.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_EGDSOCKET</constant></entry>
<entry valign="top">
Like <constant>CURLOPT_RANDOM_FILE</constant>, except a filename
to an Entropy Gathering Daemon socket.
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_ENCODING</constant></entry>
<entry valign="top">
The contents of the <literal>"Accept-Encoding: "</literal> header.
This enables decoding of the response. Supported encodings are
<literal>"identity"</literal>, <literal>"deflate"</literal>, and
<literal>"gzip"</literal>. If an empty string, <literal>""</literal>,
is set, a header containing all supported encoding types is sent.
</entry>
<entry valign="top">
Added in cURL 7.10.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_FTPPORT</constant></entry>
<entry valign="top">
The value which will be used to get the IP address to use
for the FTP "PORT" instruction. The "PORT" instruction tells
the remote server to connect to our specified IP address. The
string may be a plain IP address, a hostname, a network
interface name (under Unix), or just a plain '-' to use the
systems default IP address.
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_INTERFACE</constant></entry>
<entry valign="top">
The name of the outgoing network interface to use. This can be an
interface name, an IP address or a host name.
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_KEYPASSWD</constant></entry>
<entry valign="top">
The password required to use the <constant>CURLOPT_SSLKEY</constant>
or <constant>CURLOPT_SSH_PRIVATE_KEYFILE</constant> private key.
</entry>
<entry valign="top">
Added in cURL 7.16.1.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_KRB4LEVEL</constant></entry>
<entry valign="top">
The KRB4 (Kerberos 4) security level. Any of the following values
(in order from least to most powerful) are valid:
<literal>"clear"</literal>,
<literal>"safe"</literal>,
<literal>"confidential"</literal>,
<literal>"private".</literal>.
If the string does not match one of these,
<literal>"private"</literal> is used. Setting this option to &null;
will disable KRB4 security. Currently KRB4 security only works
with FTP transactions.
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_LOGIN_OPTIONS</constant></entry>
<entry valign="top">
Can be used to set protocol specific login options, such as the
preferred authentication mechanism via "AUTH=NTLM" or "AUTH=*",
and should be used in conjunction with the
<constant>CURLOPT_USERNAME</constant> option.
</entry>
<entry valign="top">
Added in cURL 7.34.0. Available since PHP 7.0.7.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_PINNEDPUBLICKEY</constant></entry>
<entry valign="top">
Set the pinned public key.
The string can be the file name of your pinned public key. The file
format expected is "PEM" or "DER". The string can also be any
number of base64 encoded sha256 hashes preceded by "sha256//" and
separated by ";".
</entry>
<entry valign="top">
Added in cURL 7.39.0. Available since PHP 7.0.7.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_POSTFIELDS</constant></entry>
<entry valign="top">
<simpara>
The full data to post in a HTTP "POST" operation.
To post a file, prepend a filename with <literal>@</literal> and
use the full path. The filetype can be explicitly specified by
following the filename with the type in the format
'<literal>;type=mimetype</literal>'. This parameter can either be
passed as a urlencoded string like '<literal>para1=val1&amp;para2=val2&amp;...</literal>'
or as an array with the field name as key and field data as value.
If <parameter>value</parameter> is an array, the
<literal>Content-Type</literal> header will be set to
<literal>multipart/form-data</literal>.
</simpara>
<simpara>
As of PHP 5.2.0, <parameter>value</parameter> must be an array if
files are passed to this option with the <literal>@</literal> prefix.
</simpara>
<simpara>
As of PHP 5.5.0, the <literal>@</literal> prefix is deprecated and
files can be sent using <classname>CURLFile</classname>. The
<literal>@</literal> prefix can be disabled for safe passing of
values beginning with <literal>@</literal> by setting the
<constant>CURLOPT_SAFE_UPLOAD</constant> option to &true;.
</simpara>
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_PRIVATE</constant></entry>
<entry valign="top">
Any data that should be associated with this cURL handle. This data
can subsequently be retrieved with the
<constant>CURLINFO_PRIVATE</constant> option of
<function>curl_getinfo</function>. cURL does nothing with this data.
When using a cURL multi handle, this private data is typically a
unique key to identify a standard cURL handle.
</entry>
<entry valign="top">
Added in cURL 7.10.3.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_PRE_PROXY</constant></entry>
<entry valign="top">
Set a <type>string</type> holding the host name or dotted numerical
IP address to be used as the preproxy that curl connects to before
it connects to the HTTP(S) proxy specified in the
<constant>CURLOPT_PROXY</constant> option for the upcoming request.
The preproxy can only be a SOCKS proxy and it should be prefixed with
<literal>[scheme]://</literal> to specify which kind of socks is used.
A numerical IPv6 address must be written within [brackets].
Setting the preproxy to an empty string explicitly disables the use of a preproxy.
To specify port number in this string, append <literal>:[port]</literal>
to the end of the host name. The proxy's port number may optionally be
specified with the separate option <constant>CURLOPT_PROXYPORT</constant>.
Defaults to using port 1080 for proxies if a port is not specified.
</entry>
<entry valign="top">
Available since PHP 7.3.0 and libcurl >= cURL 7.52.0.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_PROXY</constant></entry>
<entry valign="top">
The HTTP proxy to tunnel requests through.
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_PROXY_SERVICE_NAME</constant></entry>
<entry valign="top">
The proxy authentication service name.
</entry>
<entry valign="top">
Added in cURL 7.34.0. Available since PHP 7.0.7.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_PROXY_CAINFO</constant></entry>
<entry valign="top">
The path to proxy Certificate Authority (CA) bundle. Set the path as a
<type>string</type> naming a file holding one or more certificates to
verify the HTTPS proxy with.
This option is for connecting to an HTTPS proxy, not an HTTPS server.
Defaults set to the system path where libcurl's cacert bundle is assumed
to be stored.
</entry>
<entry valign="top">
Available since PHP 7.3.0 and libcurl >= cURL 7.52.0.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_PROXY_CAPATH</constant></entry>
<entry valign="top">
The directory holding multiple CA certificates to verify the HTTPS proxy with.
</entry>
<entry valign="top">
Available since PHP 7.3.0 and libcurl >= cURL 7.52.0.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_PROXY_CRLFILE</constant></entry>
<entry valign="top">
Set the file name with the concatenation of CRL (Certificate Revocation List)
in PEM format to use in the certificate validation that occurs during
the SSL exchange.
</entry>
<entry valign="top">
Available since PHP 7.3.0 and libcurl >= cURL 7.52.0.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_PROXY_KEYPASSWD</constant></entry>
<entry valign="top">
Set the string be used as the password required to use the
<constant>CURLOPT_PROXY_SSLKEY</constant> private key. You never needed a
passphrase to load a certificate but you need one to load your private key.
This option is for connecting to an HTTPS proxy, not an HTTPS server.
</entry>
<entry valign="top">
Available since PHP 7.3.0 and libcurl >= cURL 7.52.0.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_PROXY_PINNEDPUBLICKEY</constant></entry>
<entry valign="top">
Set the pinned public key for HTTPS proxy. The string can be the file name
of your pinned public key. The file format expected is "PEM" or "DER".
The string can also be any number of base64 encoded sha256 hashes preceded by
"sha256//" and separated by ";"
</entry>
<entry valign="top">
Available since PHP 7.3.0 and libcurl >= cURL 7.52.0.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_PROXY_SSLCERT</constant></entry>
<entry valign="top">
The file name of your client certificate used to connect to the HTTPS proxy.
The default format is "P12" on Secure Transport and "PEM" on other engines,
and can be changed with <constant>CURLOPT_PROXY_SSLCERTTYPE</constant>.
With NSS or Secure Transport, this can also be the nickname of the certificate
you wish to authenticate with as it is named in the security database.
If you want to use a file from the current directory, please precede it with
"./" prefix, in order to avoid confusion with a nickname.
</entry>
<entry valign="top">
Available since PHP 7.3.0 and libcurl >= cURL 7.52.0.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_PROXY_SSLCERTTYPE</constant></entry>
<entry valign="top">
The format of your client certificate used when connecting to an HTTPS proxy.
Supported formats are "PEM" and "DER", except with Secure Transport.
OpenSSL (versions 0.9.3 and later) and Secure Transport
(on iOS 5 or later, or OS X 10.7 or later) also support "P12" for
PKCS#12-encoded files. Defaults to "PEM".
</entry>
<entry valign="top">
Available since PHP 7.3.0 and libcurl >= cURL 7.52.0.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_PROXY_SSL_CIPHER_LIST</constant></entry>
<entry valign="top">
The list of ciphers to use for the connection to the HTTPS proxy.
The list must be syntactically correct, it consists of one or more cipher
strings separated by colons. Commas or spaces are also acceptable separators
but colons are normally used, !, - and + can be used as operators.
</entry>
<entry valign="top">
Available since PHP 7.3.0 and libcurl >= cURL 7.52.0.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_PROXY_TLS13_CIPHERS</constant></entry>
<entry valign="top">
The list of cipher suites to use for the TLS 1.3 connection to a proxy.
The list must be syntactically correct, it consists of one or more
cipher suite strings separated by colons. This option is currently used
only when curl is built to use OpenSSL 1.1.1 or later.
If you are using a different SSL backend you can try setting
TLS 1.3 cipher suites by using the <constant>CURLOPT_PROXY_SSL_CIPHER_LIST</constant> option.
</entry>
<entry valign="top">
Available since PHP 7.3.0 and libcurl >= cURL 7.61.0. Available when built with OpenSSL >= 1.1.1.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_PROXY_SSLKEY</constant></entry>
<entry valign="top">
The file name of your private key used for connecting to the HTTPS proxy.
The default format is "PEM" and can be changed with
<constant>CURLOPT_PROXY_SSLKEYTYPE</constant>.
(iOS and Mac OS X only) This option is ignored if curl was built against Secure Transport.
</entry>
<entry valign="top">
Available since PHP 7.3.0 and libcurl >= cURL 7.52.0. Available if built TLS enabled.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_PROXY_SSLKEYTYPE</constant></entry>
<entry valign="top">
The format of your private key. Supported formats are "PEM", "DER" and "ENG".
</entry>
<entry valign="top">
Available since PHP 7.3.0 and libcurl >= cURL 7.52.0.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_PROXY_TLSAUTH_PASSWORD</constant></entry>
<entry valign="top">
The password to use for the TLS authentication method specified with the
<constant>CURLOPT_PROXY_TLSAUTH_TYPE</constant> option. Requires that the
<constant>CURLOPT_PROXY_TLSAUTH_USERNAME</constant> option to also be set.
</entry>
<entry valign="top">
Available since PHP 7.3.0 and libcurl >= cURL 7.52.0.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_PROXY_TLSAUTH_TYPE</constant></entry>
<entry valign="top">
The method of the TLS authentication used for the HTTPS connection. Supported method is "SRP".
<note>
<para>
Secure Remote Password (SRP) authentication for TLS provides mutual authentication
if both sides have a shared secret. To use TLS-SRP, you must also set the
<constant>CURLOPT_PROXY_TLSAUTH_USERNAME</constant> and
<constant>CURLOPT_PROXY_TLSAUTH_PASSWORD</constant> options.
</para>
</note>
</entry>
<entry valign="top">
Available since PHP 7.3.0 and libcurl >= cURL 7.52.0.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_PROXY_TLSAUTH_USERNAME</constant></entry>
<entry valign="top">
Tusername to use for the HTTPS proxy TLS authentication method specified with the
<constant>CURLOPT_PROXY_TLSAUTH_TYPE</constant> option. Requires that the
<constant>CURLOPT_PROXY_TLSAUTH_PASSWORD</constant> option to also be set.
</entry>
<entry valign="top">
Available since PHP 7.3.0 and libcurl >= cURL 7.52.0.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_PROXYUSERPWD</constant></entry>
<entry valign="top">
A username and password formatted as
<literal>"[username]:[password]"</literal> to use for the
connection to the proxy.
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_RANDOM_FILE</constant></entry>
<entry valign="top">
A filename to be used to seed the random number generator for SSL.
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_RANGE</constant></entry>
<entry valign="top">
Range(s) of data to retrieve in the format
<literal>"X-Y"</literal> where X or Y are optional. HTTP transfers
also support several intervals, separated with commas in the format
<literal>"X-Y,N-M"</literal>.
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_REFERER</constant></entry>
<entry valign="top">
The contents of the <literal>"Referer: "</literal> header to be used
in a HTTP request.
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_SERVICE_NAME</constant></entry>
<entry valign="top">
The authentication service name.
</entry>
<entry valign="top">
Added in cURL 7.43.0. Available since PHP 7.0.7.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_SSH_HOST_PUBLIC_KEY_MD5</constant></entry>
<entry valign="top">
A string containing 32 hexadecimal digits. The string should be the
MD5 checksum of the remote host's public key, and libcurl will reject
the connection to the host unless the md5sums match.
This option is only for SCP and SFTP transfers.
</entry>
<entry valign="top">
Added in cURL 7.17.1.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_SSH_PUBLIC_KEYFILE</constant></entry>
<entry valign="top">
The file name for your public key. If not used, libcurl defaults to
$HOME/.ssh/id_dsa.pub if the HOME environment variable is set,
and just "id_dsa.pub" in the current directory if HOME is not set.
</entry>
<entry valign="top">
Added in cURL 7.16.1.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_SSH_PRIVATE_KEYFILE</constant></entry>
<entry valign="top">
The file name for your private key. If not used, libcurl defaults to
$HOME/.ssh/id_dsa if the HOME environment variable is set,
and just "id_dsa" in the current directory if HOME is not set.
If the file is password-protected, set the password with
<constant>CURLOPT_KEYPASSWD</constant>.
</entry>
<entry valign="top">
Added in cURL 7.16.1.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_SSL_CIPHER_LIST</constant></entry>
<entry valign="top">
A list of ciphers to use for SSL. For example,
<literal>RC4-SHA</literal> and <literal>TLSv1</literal> are valid
cipher lists.
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_SSLCERT</constant></entry>
<entry valign="top">
The name of a file containing a PEM formatted certificate.
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_SSLCERTPASSWD</constant></entry>
<entry valign="top">
The password required to use the
<constant>CURLOPT_SSLCERT</constant> certificate.
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_SSLCERTTYPE</constant></entry>
<entry valign="top">
The format of the certificate. Supported formats are
<literal>"PEM"</literal> (default), <literal>"DER"</literal>,
and <literal>"ENG"</literal>.
As of OpenSSL 0.9.3, <literal>"P12"</literal> (for PKCS#12-encoded files)
is also supported.
</entry>
<entry valign="top">
Added in cURL 7.9.3.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_SSLENGINE</constant></entry>
<entry valign="top">
The identifier for the crypto engine of the private SSL key
specified in <constant>CURLOPT_SSLKEY</constant>.
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_SSLENGINE_DEFAULT</constant></entry>
<entry valign="top">
The identifier for the crypto engine used for asymmetric crypto
operations.
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_SSLKEY</constant></entry>
<entry valign="top">
The name of a file containing a private SSL key.
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_SSLKEYPASSWD</constant></entry>
<entry valign="top"><para>
The secret password needed to use the private SSL key specified in
<constant>CURLOPT_SSLKEY</constant>.
<note>
<para>
Since this option contains a sensitive password, remember to keep
the PHP script it is contained within safe.
</para>
</note>
</para></entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_SSLKEYTYPE</constant></entry>
<entry valign="top">
The key type of the private SSL key specified in
<constant>CURLOPT_SSLKEY</constant>. Supported key types are
<literal>"PEM"</literal> (default), <literal>"DER"</literal>,
and <literal>"ENG"</literal>.
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_TLS13_CIPHERS</constant></entry>
<entry valign="top">
The list of cipher suites to use for the TLS 1.3 connection. The list must be
syntactically correct, it consists of one or more cipher suite strings separated by colons.
This option is currently used only when curl is built to use OpenSSL 1.1.1 or later.
If you are using a different SSL backend you can try setting
TLS 1.3 cipher suites by using the <constant>CURLOPT_SSL_CIPHER_LIST</constant> option.
</entry>
<entry valign="top">
Available since PHP 7.3.0 and libcurl >= cURL 7.61.0. Available when built with OpenSSL >= 1.1.1.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_UNIX_SOCKET_PATH</constant></entry>
<entry valign="top">
Enables the use of Unix domain sockets as connection endpoint and
sets the path to the given <type>string</type>.
</entry>
<entry valign="top">
Added in cURL 7.40.0. Available since PHP 7.0.7.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_URL</constant></entry>
<entry valign="top">
The URL to fetch. This can also be set when initializing a
session with <function>curl_init</function>.
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_USERAGENT</constant></entry>
<entry valign="top">
The contents of the <literal>"User-Agent: "</literal> header to be
used in a HTTP request.
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_USERNAME</constant></entry>
<entry valign="top">
The user name to use in authentication.
</entry>
<entry valign="top">
Added in cURL 7.19.1. Available since PHP 5.5.0.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_USERPWD</constant></entry>
<entry valign="top">
A username and password formatted as
<literal>"[username]:[password]"</literal> to use for the
connection.
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_XOAUTH2_BEARER</constant></entry>
<entry valign="top">
Specifies the OAuth 2.0 access token.
</entry>
<entry valign="top">
Added in cURL 7.33.0. Available since PHP 7.0.7.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</para>
<para>
<parameter>value</parameter> should be an array for the
following values of the <parameter>option</parameter> parameter:
<informaltable>
<tgroup cols="3">
<thead>
<row>
<entry>Option</entry>
<entry>Set <parameter>value</parameter> to</entry>
<entry>Notes</entry>
</row>
</thead>
<tbody>
<row>
<entry valign="top"><constant>CURLOPT_CONNECT_TO</constant></entry>
<entry valign="top">
Connect to a specific host and port instead of the URL's host and port.
Accepts an array of strings with the format
<literal>HOST:PORT:CONNECT-TO-HOST:CONNECT-TO-PORT</literal>.
</entry>
<entry valign="top">
Added in cURL 7.49.0. Available since PHP 7.0.7.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_HTTP200ALIASES</constant></entry>
<entry valign="top">
An array of HTTP 200 responses that will be treated as valid
responses and not as errors.
</entry>
<entry valign="top">
Added in cURL 7.10.3.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_HTTPHEADER</constant></entry>
<entry valign="top">
An array of HTTP header fields to set, in the format
<code>
array('Content-type: text/plain', 'Content-length: 100')
</code>
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_POSTQUOTE</constant></entry>
<entry valign="top">
An array of FTP commands to execute on the server after the FTP
request has been performed.
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_PROXYHEADER</constant></entry>
<entry valign="top">
An array of custom HTTP headers to pass to proxies.
</entry>
<entry valign="top">
Added in cURL 7.37.0. Available since PHP 7.0.7.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_QUOTE</constant></entry>
<entry valign="top">
An array of FTP commands to execute on the server prior to the FTP
request.
</entry>
<entry valign="top">
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_RESOLVE</constant></entry>
<entry valign="top">
Provide a custom address for a specific host and port pair. An array
of hostname, port, and IP address strings, each element separated by
a colon. In the format:
<code>
array("example.com:80:127.0.0.1")
</code>
</entry>
<entry valign="top">
Added in cURL 7.21.3. Available since PHP 5.5.0.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</para>
<para>
<parameter>value</parameter> should be a stream resource (using
<function>fopen</function>, for example) for the following values of the
<parameter>option</parameter> parameter:
<informaltable>
<tgroup cols="3">
<thead>
<row>
<entry>Option</entry>
<entry>Set <parameter>value</parameter> to</entry>
</row>
</thead>
<tbody>
<row>
<entry valign="top"><constant>CURLOPT_FILE</constant></entry>
<entry valign="top">
The file that the transfer should be written to. The default
is <literal>STDOUT</literal> (the browser window).
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_INFILE</constant></entry>
<entry valign="top">
The file that the transfer should be read from when uploading.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_STDERR</constant></entry>
<entry valign="top">
An alternative location to output errors to instead of
<literal>STDERR</literal>.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_WRITEHEADER</constant></entry>
<entry valign="top">
The file that the header part of the transfer is written to.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</para>
<para>
<parameter>value</parameter> should be the name of a valid function or a Closure
for the following values of the <parameter>option</parameter> parameter:
<informaltable>
<tgroup cols="3">
<thead>
<row>
<entry>Option</entry>
<entry>Set <parameter>value</parameter> to</entry>
</row>
</thead>
<tbody>
<row>
<entry valign="top"><constant>CURLOPT_HEADERFUNCTION</constant></entry>
<entry valign="top">
A callback accepting two parameters.
The first is the cURL resource, the second is a
string with the header data to be written. The header data must
be written by this callback. Return the number of
bytes written.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_PASSWDFUNCTION</constant></entry>
<entry valign="top">
A callback accepting three parameters.
The first is the cURL resource, the second is a
string containing a password prompt, and the third is the maximum
password length. Return the string containing the password.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_PROGRESSFUNCTION</constant></entry>
<entry valign="top">
<para>
A callback accepting five parameters.
The first is the cURL resource, the second is the total number of
bytes expected to be downloaded in this transfer, the third is
the number of bytes downloaded so far, the fourth is the total
number of bytes expected to be uploaded in this transfer, and the
fifth is the number of bytes uploaded so far.
</para>
<note>
<para>
The callback is only called when the <constant>CURLOPT_NOPROGRESS</constant>
option is set to &false;.
</para>
</note>
<para>
Return a non-zero value to abort the transfer. In which case, the
transfer will set a <constant>CURLE_ABORTED_BY_CALLBACK</constant>
error.
</para>
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_READFUNCTION</constant></entry>
<entry valign="top">
A callback accepting three parameters.
The first is the cURL resource, the second is a
stream resource provided to cURL through the option
<constant>CURLOPT_INFILE</constant>, and the third is the maximum
amount of data to be read. The callback must return a string
with a length equal or smaller than the amount of data requested,
typically by reading it from the passed stream resource. It should
return an empty string to signal <literal>EOF</literal>.
</entry>
</row>
<row>
<entry valign="top"><constant>CURLOPT_WRITEFUNCTION</constant></entry>
<entry valign="top">
A callback accepting two parameters.
The first is the cURL resource, and the second is a
string with the data to be written. The data must be saved by
this callback. It must return the exact number of bytes written
or the transfer will be aborted with an error.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</para>
<para>
Other values:
<informaltable>
<tgroup cols="3">
<thead>
<row>
<entry>Option</entry>
<entry>Set <parameter>value</parameter> to</entry>
</row>
</thead>
<tbody>
<row>
<entry valign="top"><constant>CURLOPT_SHARE</constant></entry>
<entry valign="top">
A result of <function>curl_share_init</function>. Makes the cURL
handle to use the data from the shared handle.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
&return.success;
</para>
</refsect1>
<refsect1 role="changelog">
&reftitle.changelog;
<para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>7.3.15, 7.4.3</entry>
<entry>
Introduced <constant>CURLOPT_HTTP09_ALLOWED </constant>.
</entry>
</row>
<row>
<entry>7.3.0</entry>
<entry>
Introduced <constant>CURLOPT_ABSTRACT_UNIX_SOCKET</constant>, <constant>CURLOPT_KEEP_SENDING_ON_ERROR</constant>,
<constant>CURLOPT_PRE_PROXY</constant>, <constant>CURLOPT_PROXY_CAINFO</constant>,
<constant>CURLOPT_PROXY_CAPATH</constant>, <constant>CURLOPT_PROXY_CRLFILE</constant>,
<constant>CURLOPT_PROXY_KEYPASSWD</constant>, <constant>CURLOPT_PROXY_PINNEDPUBLICKEY</constant>,
<constant>CURLOPT_PROXY_SSLCERT</constant>, <constant>CURLOPT_PROXY_SSLCERTTYPE</constant>,
<constant>CURLOPT_PROXY_SSL_CIPHER_LIST</constant>, <constant>CURLOPT_PROXY_SSLKEY</constant>,
<constant>CURLOPT_PROXY_SSLKEYTYPE</constant>, <constant>CURLOPT_PROXY_SSL_OPTIONS</constant>,
<constant>CURLOPT_PROXY_SSL_VERIFYHOST</constant>, <constant>CURLOPT_PROXY_SSL_VERIFYPEER</constant>,
<constant>CURLOPT_PROXY_SSLVERSION</constant>, <constant>CURLOPT_PROXY_TLSAUTH_PASSWORD</constant>,
<constant>CURLOPT_PROXY_TLSAUTH_TYPE</constant>, <constant>CURLOPT_PROXY_TLSAUTH_USERNAME</constant>,
<constant>CURLOPT_SOCKS5_AUTH</constant>, <constant>CURLOPT_SUPPRESS_CONNECT_HEADERS</constant>,
<constant>CURLOPT_DISALLOW_USERNAME_IN_URL</constant>, <constant>CURLOPT_DNS_SHUFFLE_ADDRESSES</constant>,
<constant>CURLOPT_HAPPY_EYEBALLS_TIMEOUT_MS</constant>, <constant>CURLOPT_HAPROXYPROTOCOL</constant>,
<constant>CURLOPT_PROXY_TLS13_CIPHERS</constant>, <constant>CURLOPT_SSH_COMPRESSION</constant>,
<constant>CURLOPT_TIMEVALUE_LARGE</constant> and <constant>CURLOPT_TLS13_CIPHERS</constant>.
</entry>
</row>
<row>
<entry>7.0.7</entry>
<entry>
Introduced <constant>CURL_HTTP_VERSION_2</constant>, <constant>CURL_HTTP_VERSION_2_PRIOR_KNOWLEDGE</constant>,
<constant>CURL_HTTP_VERSION_2TLS</constant>, <constant>CURL_REDIR_POST_301</constant>,
<constant>CURL_REDIR_POST_302</constant>, <constant>CURL_REDIR_POST_303</constant>,
<constant>CURL_REDIR_POST_ALL</constant>, <constant>CURL_VERSION_KERBEROS5</constant>,
<constant>CURL_VERSION_PSL</constant>, <constant>CURL_VERSION_UNIX_SOCKETS</constant>,
<constant>CURLAUTH_NEGOTIATE</constant>, <constant>CURLAUTH_NTLM_WB</constant>,
<constant>CURLFTP_CREATE_DIR</constant>, <constant>CURLFTP_CREATE_DIR_NONE</constant>,
<constant>CURLFTP_CREATE_DIR_RETRY</constant>, <constant>CURLHEADER_SEPARATE</constant>,
<constant>CURLHEADER_UNIFIED</constant>, <constant>CURLMOPT_CHUNK_LENGTH_PENALTY_SIZE</constant>,
<constant>CURLMOPT_CONTENT_LENGTH_PENALTY_SIZE</constant>, <constant>CURLMOPT_MAX_HOST_CONNECTIONS</constant>,
<constant>CURLMOPT_MAX_PIPELINE_LENGTH</constant>, <constant>CURLMOPT_MAX_TOTAL_CONNECTIONS</constant>,
<constant>CURLOPT_CONNECT_TO</constant>, <constant>CURLOPT_DEFAULT_PROTOCOL</constant>,
<constant>CURLOPT_DNS_INTERFACE</constant>, <constant>CURLOPT_DNS_LOCAL_IP4</constant>,
<constant>CURLOPT_DNS_LOCAL_IP6</constant>, <constant>CURLOPT_EXPECT_100_TIMEOUT_MS</constant>,
<constant>CURLOPT_HEADEROPT</constant>, <constant>CURLOPT_LOGIN_OPTIONS</constant>,
<constant>CURLOPT_PATH_AS_IS</constant>, <constant>CURLOPT_PINNEDPUBLICKEY</constant>,
<constant>CURLOPT_PIPEWAIT</constant>, <constant>CURLOPT_PROXY_SERVICE_NAME</constant>,
<constant>CURLOPT_PROXYHEADER</constant>, <constant>CURLOPT_SASL_IR</constant>,
<constant>CURLOPT_SERVICE_NAME</constant>, <constant>CURLOPT_SSL_ENABLE_ALPN</constant>,
<constant>CURLOPT_SSL_ENABLE_NPN</constant>, <constant>CURLOPT_SSL_FALSESTART</constant>,
<constant>CURLOPT_SSL_VERIFYSTATUS</constant>, <constant>CURLOPT_STREAM_WEIGHT</constant>,
<constant>CURLOPT_TCP_FASTOPEN</constant>, <constant>CURLOPT_TFTP_NO_OPTIONS</constant>,
<constant>CURLOPT_UNIX_SOCKET_PATH</constant>, <constant>CURLOPT_XOAUTH2_BEARER</constant>,
<constant>CURLPROTO_SMB</constant>, <constant>CURLPROTO_SMBS</constant>,
<constant>CURLPROXY_HTTP_1_0</constant>, <constant>CURLSSH_AUTH_AGENT</constant> and
<constant>CURLSSLOPT_NO_REVOKE</constant>.
</entry>
</row>
<row>
<entry>7.0.0</entry>
<entry>
Support for disabling the <constant>CURLOPT_SAFE_UPLOAD</constant> option has been removed.
All curl file uploads must use <classname>CURLFile</classname>.
</entry>
</row>
<row>
<entry>5.6.0</entry>
<entry>
<constant>CURLOPT_SAFE_UPLOAD</constant> is now &true; by default.
</entry>
</row>
<row>
<entry>5.6.0</entry>
<entry>
Removed <constant>CURLOPT_CLOSEPOLICY</constant> and associated values.
</entry>
</row>
<row>
<entry>5.5.0</entry>
<entry>
Added the cURL resource as the first argument to the
<constant>CURLOPT_PROGRESSFUNCTION</constant> callback.
</entry>
</row>
<row>
<entry>5.5.0</entry>
<entry>
Introduced <constant>CURLOPT_SHARE</constant>.
</entry>
</row>
<row>
<entry>5.3.0</entry>
<entry>
Introduced <constant>CURLOPT_PROGRESSFUNCTION</constant>.
</entry>
</row>
<row>
<entry>5.2.10</entry>
<entry>
Introduced <constant>CURLOPT_PROTOCOLS</constant>, and
<constant>CURLOPT_REDIR_PROTOCOLS</constant>.
</entry>
</row>
<row>
<entry>5.2.4</entry>
<entry>
Introduced <constant>CURLOPT_PRIVATE</constant>.
</entry>
</row>
<row>
<entry>5.1.0</entry>
<entry>
Introduced <constant>CURLOPT_AUTOREFERER</constant>,
<constant>CURLOPT_BINARYTRANSFER</constant>,
<constant>CURLOPT_FTPSSLAUTH</constant>,
<constant>CURLOPT_PROXYAUTH</constant>, and
<constant>CURLOPT_TIMECONDITION</constant>.
</entry>
</row>
<row>
<entry>5.0.0</entry>
<entry>
Introduced <constant>CURLOPT_FTP_USE_EPRT</constant>,
<constant>CURLOPT_NOSIGNAL</constant>,
<constant>CURLOPT_UNRESTRICTED_AUTH</constant>,
<constant>CURLOPT_BUFFERSIZE</constant>,
<constant>CURLOPT_HTTPAUTH</constant>,
<constant>CURLOPT_PROXYPORT</constant>,
<constant>CURLOPT_PROXYTYPE</constant>,
<constant>CURLOPT_SSLCERTTYPE</constant>, and
<constant>CURLOPT_HTTP200ALIASES</constant>.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>Initializing a new cURL session and fetching a web page</title>
<programlisting role="php">
<![CDATA[
<?php
// create a new cURL resource
$ch = curl_init();
// set URL and other appropriate options
curl_setopt($ch, CURLOPT_URL, "http://www.example.com/");
curl_setopt($ch, CURLOPT_HEADER, false);
// grab URL and pass it to the browser
curl_exec($ch);
// close cURL resource, and free up system resources
curl_close($ch);
?>
]]>
</programlisting>
</example>
</para>
<para>
<example>
<title>Uploading file (deprecated as of PHP 5.5.0)</title>
<programlisting role="php">
<![CDATA[
<?php
/* http://localhost/upload.php:
print_r($_POST);
print_r($_FILES);
*/
$ch = curl_init();
$data = array('name' => 'Foo', 'file' => '@/home/user/test.png');
curl_setopt($ch, CURLOPT_URL, 'http://localhost/upload.php');
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_SAFE_UPLOAD, false); // required as of PHP 5.6.0
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
curl_exec($ch);
?>
]]>
</programlisting>
&example.outputs;
<screen>
<![CDATA[
Array
(
[name] => Foo
)
Array
(
[file] => Array
(
[name] => test.png
[type] => image/png
[tmp_name] => /tmp/phpcpjNeQ
[error] => 0
[size] => 279
)
)
]]>
</screen>
</example>
</para>
</refsect1>
<refsect1 role="notes">
&reftitle.notes;
<note>
<para>
Passing an array to <constant>CURLOPT_POSTFIELDS</constant> will
encode the data as <emphasis>multipart/form-data</emphasis>,
while passing a URL-encoded string will encode the data as
<emphasis>application/x-www-form-urlencoded</emphasis>.
</para>
</note>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>curl_setopt_array</function></member>
</simplelist>
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->
Reference in a new issue View git blame Copy permalink