ConFoo 2025

预定义常量

下列常量由此扩展定义,且仅在此扩展编译入 PHP 或在运行时动态载入时可用。

curl_setopt()curl_multi_setopt()curl_getinfo() 文档中常量的描述和使用。

常量 描述
CURLALTSVC_H1 (int) 自 PHP 8.2.0 和 cURL 7.64.1 起可用。
CURLALTSVC_H2 (int) 自 PHP 8.2.0 和 cURL 7.64.1 起可用。
CURLALTSVC_H3 (int) 自 PHP 8.2.0 和 cURL 7.64.1 起可用。
CURLALTSVC_READONLYFILE (int) 自 PHP 8.2.0 和 cURL 7.64.1 起可用。
CURLAUTH_ANY (int)
CURLAUTH_ANYSAFE (int)
CURLAUTH_AWS_SIGV4 (int) 自 PHP 8.2.0 和 cURL 7.75.0 起可用。
CURLAUTH_BASIC (int)
CURLAUTH_BEARER (int) 自 PHP 7.3.0 和 cURL 7.61.0 起可用。
CURLAUTH_DIGEST (int)
CURLAUTH_DIGEST_IE (int) 使用带有 IE 风格的 HTTP 摘要认证。自 cURL 7.19.3 起可用。
CURLAUTH_GSSAPI (int) 自 PHP 7.3.0 和 cURL 7.54.1 起可用
CURLAUTH_GSSNEGOTIATE (int)
CURLAUTH_NEGOTIATE (int) 自 PHP 7.0.7 和 cURL 7.38.0 起可用。
CURLAUTH_NONE (int) 自 cURL 7.10.6 起可用。
CURLAUTH_NTLM (int)
CURLAUTH_NTLM_WB (int) 自 PHP 7.0.7 和 cURL 7.22.0 起可用
CURLAUTH_ONLY (int) 这是元符号。将此值与单个特定认证值进行 OR 运算,以强制 libcurl 探测不受限制的认证方法;如果不可用,则仅接受该单个认证算法。自 cURL 7.21.3 起可用。
CURLFTPAUTH_DEFAULT (int)
CURLFTPAUTH_SSL (int)
CURLFTPAUTH_TLS (int)
CURLFTPMETHOD_DEFAULT (int) 自 PHP 8.2.0 和 cURL 7.15.3 起可用。
CURLFTPMETHOD_MULTICWD (int) 对指定 URL 中的每个路径部分执行一次 CWD 操作。自 cURL 7.15.3 起可用。
CURLFTPMETHOD_NOCWD (int) libcurl 完全不执行 CWD 操作。libcurl 执行 SIZERETRSTOR 等命令,并为这些命令向服务器提供完整路径。自 cURL 7.15.3 起可用。
CURLFTPMETHOD_SINGLECWD (int) libcurl 使用完整的目标目录执行一次 CWD 操作,然后像在多次 CWD 情况下对文件进行操作。自 cURL 7.15.3 起可用。
CURLFTPSSL_ALL (int)
CURLFTPSSL_CCC_ACTIVE (int) 发起关闭操作并等待回复。自 cURL 7.16.2 起可用。
CURLFTPSSL_CCC_NONE (int) 不要尝试使用 CCC(清除命令通道)。自 cURL 7.16.2 起可用。
CURLFTPSSL_CCC_PASSIVE (int) 不要发起关闭操作,而是等待服务器进行关闭。不要发送回复。自 cURL 7.16.1 起可用。
CURLFTPSSL_CONTROL (int)
CURLFTPSSL_NONE (int)
CURLFTPSSL_TRY (int)
CURLFTP_CREATE_DIR (int) 自 PHP 7.0.7 和 cURL 7.19.3 起可用
CURLFTP_CREATE_DIR_NONE (int) 自 PHP 7.0.7 和 cURL 7.19.3 起可用
CURLFTP_CREATE_DIR_RETRY (int) 自 PHP 7.0.7 和 cURL 7.19.3 起可用
CURLGSSAPI_DELEGATION_FLAG (int) 允许无条件的 GSSAPI 凭证委派。自 cURL 7.22.0 起可用。
CURLGSSAPI_DELEGATION_POLICY_FLAG (int) 仅当服务票据(service ticket)中设置了 OK-AS-DELEGATE flag 的情况下进行委托,前提是由 GSS-API 实现支持此功能,并且在编译时定义了 GSS_C_DELEG_POLICY_FLAG 时可用。自 cURL 7.22.0 起可用。
CURLHEADER_SEPARATE (int) 自 PHP 7.0.7 和 cURL 7.37.0 起可用。
CURLHEADER_UNIFIED (int) 自 PHP 7.0.7 和 cURL 7.37.0 起可用。
CURLHSTS_ENABLE (int) 自 PHP 8.2.0 和 cURL 7.74.0 起可用
CURLHSTS_READONLYFILE (int) 自 PHP 8.2.0 和 cURL 7.74.0 起可用
CURLKHMATCH_LAST (int) 自 PHP 8.3.0 和 cURL 7.19.6 起可用
CURLKHMATCH_MISMATCH (int) 自 PHP 8.3.0 和 cURL 7.19.6 起可用
CURLKHMATCH_MISSING (int) 自 PHP 8.3.0 和 cURL 7.19.6 起可用
CURLKHMATCH_OK (int) 自 PHP 8.3.0 和 cURL 7.19.6 起可用
CURLMIMEOPT_FORMESCAPE (int) 自 PHP 8.3.0 和 cURL 7.81.0 起可用
CURLMSG_DONE (int)
CURLPIPE_HTTP1 (int) 自 cURL 7.43.0 起可用。
CURLPIPE_MULTIPLEX (int) 自 cURL 7.43.0 起可用。
CURLPIPE_NOTHING (int) 自 cURL 7.43.0 起可用。
CURLPROXY_HTTP (int) 自 cURL 7.10 起可用。
CURLPROXY_HTTPS (int) 自 PHP 7.3.0 和 cURL 7.52.0 起可用
CURLPROXY_HTTP_1_0 (int) 自 PHP 7.0.7 和 cURL 7.19.3 起可用
CURLPROXY_SOCKS4 (int) 自 cURL 7.10 起可用。
CURLPROXY_SOCKS4A (int) 自 cURL 7.18.0 起可用。
CURLPROXY_SOCKS5 (int) 自 cURL 7.10 起可用。
CURLPROXY_SOCKS5_HOSTNAME (int) 自 cURL 7.18.0 起可用。
CURLPX_BAD_ADDRESS_TYPE (int) 自 PHP 8.2.0 和 cURL 7.73.0 起可用
CURLPX_BAD_VERSION (int) 自 PHP 8.2.0 和 cURL 7.73.0 起可用
CURLPX_CLOSED (int) 自 PHP 8.2.0 和 cURL 7.73.0 起可用
CURLPX_GSSAPI (int) 自 PHP 8.2.0 和 cURL 7.73.0 起可用
CURLPX_GSSAPI_PERMSG (int) 自 PHP 8.2.0 和 cURL 7.73.0 起可用
CURLPX_GSSAPI_PROTECTION (int) 自 PHP 8.2.0 和 cURL 7.73.0 起可用
CURLPX_IDENTD (int) 自 PHP 8.2.0 和 cURL 7.73.0 起可用
CURLPX_IDENTD_DIFFER (int) 自 PHP 8.2.0 和 cURL 7.73.0 起可用
CURLPX_LONG_HOSTNAME (int) 自 PHP 8.2.0 和 cURL 7.73.0 起可用
CURLPX_LONG_PASSWD (int) 自 PHP 8.2.0 和 cURL 7.73.0 起可用
CURLPX_LONG_USER (int) 自 PHP 8.2.0 和 cURL 7.73.0 起可用
CURLPX_NO_AUTH (int) 自 PHP 8.2.0 和 cURL 7.73.0 起可用
CURLPX_OK (int) 自 PHP 8.2.0 和 cURL 7.73.0 起可用
CURLPX_RECV_ADDRESS (int) 自 PHP 8.2.0 和 cURL 7.73.0 起可用
CURLPX_RECV_AUTH (int) 自 PHP 8.2.0 和 cURL 7.73.0 起可用
CURLPX_RECV_CONNECT (int) 自 PHP 8.2.0 和 cURL 7.73.0 起可用
CURLPX_RECV_REQACK (int) 自 PHP 8.2.0 和 cURL 7.73.0 起可用
CURLPX_REPLY_ADDRESS_TYPE_NOT_SUPPORTED (int) 自 PHP 8.2.0 和 cURL 7.73.0 起可用
CURLPX_REPLY_COMMAND_NOT_SUPPORTED (int) 自 PHP 8.2.0 和 cURL 7.73.0 起可用
CURLPX_REPLY_CONNECTION_REFUSED (int) 自 PHP 8.2.0 和 cURL 7.73.0 起可用
CURLPX_REPLY_GENERAL_SERVER_FAILURE (int) 自 PHP 8.2.0 和 cURL 7.73.0 起可用
CURLPX_REPLY_HOST_UNREACHABLE (int) 自 PHP 8.2.0 和 cURL 7.73.0 起可用
CURLPX_REPLY_NETWORK_UNREACHABLE (int) 自 PHP 8.2.0 和 cURL 7.73.0 起可用
CURLPX_REPLY_NOT_ALLOWED (int) 自 PHP 8.2.0 和 cURL 7.73.0 起可用
CURLPX_REPLY_TTL_EXPIRED (int) 自 PHP 8.2.0 和 cURL 7.73.0 起可用
CURLPX_REPLY_UNASSIGNED (int) 自 PHP 8.2.0 和 cURL 7.73.0 起可用
CURLPX_REQUEST_FAILED (int) 自 PHP 8.2.0 和 cURL 7.73.0 起可用
CURLPX_RESOLVE_HOST (int) 自 PHP 8.2.0 和 cURL 7.73.0 起可用
CURLPX_SEND_AUTH (int) 自 PHP 8.2.0 和 cURL 7.73.0 起可用
CURLPX_SEND_CONNECT (int) 自 PHP 8.2.0 和 cURL 7.73.0 起可用
CURLPX_SEND_REQUEST (int) 自 PHP 8.2.0 和 cURL 7.73.0 起可用
CURLPX_UNKNOWN_FAIL (int) 自 PHP 8.2.0 和 cURL 7.73.0 起可用
CURLPX_UNKNOWN_MODE (int) 自 PHP 8.2.0 和 cURL 7.73.0 起可用
CURLPX_USER_REJECTED (int) 自 PHP 8.2.0 和 cURL 7.73.0 起可用
CURLSSH_AUTH_AGENT (int) 自 PHP 7.0.7 和 cURL 7.28.0 起可用
CURLSSH_AUTH_ANY (int)
CURLSSH_AUTH_DEFAULT (int)
CURLSSH_AUTH_GSSAPI (int) 自 PHP 7.3.0 和 cURL 7.58.0 起可用
CURLSSH_AUTH_HOST (int)
CURLSSH_AUTH_KEYBOARD (int)
CURLSSH_AUTH_NONE (int)
CURLSSH_AUTH_PASSWORD (int)
CURLSSH_AUTH_PUBLICKEY (int)
CURLSSLOPT_ALLOW_BEAST (int) 自 cURL 7.25.0 起可用
CURLSSLOPT_AUTO_CLIENT_CERT (int) 自 PHP 8.2.0 和 cURL 7.77.0 起可用
CURLSSLOPT_NATIVE_CA (int) 自 PHP 8.2.0 和 cURL 7.71.0 起可用
CURLSSLOPT_NO_PARTIALCHAIN (int) 自 PHP 8.2.0 和 cURL 7.68.0 起可用
CURLSSLOPT_NO_REVOKE (int) 自 PHP 7.0.7 和 cURL 7.44.0 起可用
CURLSSLOPT_REVOKE_BEST_EFFORT (int) 自 PHP 8.2.0 和 cURL 7.70.0 起可用
CURLUSESSL_ALL (int) 所有通信都需要 SSL,否则会失败并出现 CURLE_USE_SSL_FAILED。自 cURL 7.17.0 起可用。
CURLUSESSL_CONTROL (int) 控制连接需要 SSL,否则会失败并出现 CURLE_USE_SSL_FAILED。自 cURL 7.17.0 起可用。
CURLUSESSL_NONE (int) 不要尝试使用 SSL。自 cURL 7.17.0 起可用。
CURLUSESSL_TRY (int) 尝试使用 SSL,如果失败则按正常方式继续。注意,如果协商不成功,服务器可能会关闭连接。自 cURL 7.17.0 起可用。
CURLVERSION_NOW (int)
CURLWS_RAW_MODE (int) 自 PHP 8.3.0 和 cURL 7.86.0 起可用
CURL_FNMATCHFUNC_FAIL (int) 如果发生错误,则由通配符匹配回调函数返回。自 cURL 7.21.0 起可用。
CURL_FNMATCHFUNC_MATCH (int) 如果模式与字符串匹配,则由通配符匹配回调函数返回。自 cURL 7.21.0 起可用。
CURL_FNMATCHFUNC_NOMATCH (int) 如果模式与字符串不匹配,则由通配符匹配回调函数返回。自 cURL 7.21.0 起可用。
CURL_HTTP_VERSION_1_0 (int)
CURL_HTTP_VERSION_1_1 (int)
CURL_HTTP_VERSION_2 (int) 自 PHP 7.0.7 和 cURL 7.43.0 起可用
CURL_HTTP_VERSION_2TLS (int) 自 PHP 7.0.7 和 cURL 7.47.0 起可用
CURL_HTTP_VERSION_2_0 (int) 自 cURL 7.33.0 起可用
CURL_HTTP_VERSION_2_PRIOR_KNOWLEDGE (int) 自 PHP 7.0.7 和 cURL 7.49.0 起可用
CURL_HTTP_VERSION_3 (int) 自 PHP 8.4.0 和 cURL 7.66.0 起可用。
CURL_HTTP_VERSION_3ONLY (int) 自 PHP 8.4.0 和 cURL 7.88.0 起可用。
CURL_HTTP_VERSION_NONE (int)
CURL_IPRESOLVE_V4 (int) 建立连接或从连接池中选一个时仅使用 IPv4 地址。自 cURL 7.10.8 起可用。
CURL_IPRESOLVE_V6 (int) 建立连接或从连接池中选一个时仅使用 IPv6 地址。自 cURL 7.10.8 起可用。
CURL_IPRESOLVE_WHATEVER (int) 使用系统允许的所有 IP 版本的地址。自 cURL 7.10.8 起可用。
CURL_MAX_READ_SIZE (int) 自 PHP 7.3.0 和 cURL 7.53.0 起可用
CURL_NETRC_IGNORED (int)
CURL_NETRC_OPTIONAL (int)
CURL_NETRC_REQUIRED (int)
CURL_PUSH_DENY (int) 自 PHP 7.1.0 和 cURL 7.44.0 起可用
CURL_PUSH_OK (int) 自 PHP 7.1.0 和 cURL 7.44.0 起可用
CURL_READFUNC_PAUSE (int) 自 cURL 7.18.0 起可用。
CURL_REDIR_POST_301 (int) 自 PHP 7.0.7 和 cURL 7.18.2 起可用
CURL_REDIR_POST_302 (int) 自 PHP 7.0.7 和 cURL 7.18.2 起可用
CURL_REDIR_POST_303 (int) 自 PHP 7.0.7 和 cURL 7.25.1 起可用
CURL_REDIR_POST_ALL (int) 自 PHP 7.0.7 和 cURL 7.18.2 起可用
CURL_RTSPREQ_ANNOUNCE (int) 当客户端发送时,该方法会更改会话的描述。ANNOUNCE 的作用类似于 HTTP PUT 或 POST,就像 CURL_RTSPREQ_SET_PARAMETER 一样。自 cURL 7.20.0 起可用。
CURL_RTSPREQ_DESCRIBE (int) 用于获取流的低级描述。应用程序应在 Accept: header 中注明其支持的格式。除非手动设置,否则 libcurl 会自动添加 Accept: application/sdp。如果使用了 CURLOPT_TIMECONDITION 选项,时间条件(Time-condition)header 将添加到 DESCRIBE 请求中。自 cURL 7.20.0 起可用。
CURL_RTSPREQ_GET_PARAMETER (int) 从服务器检索参数。默认情况下,libcurl 会在所有非空请求中添加 Content-Type: text/parameters header,除非设置了自定义标头。GET_PARAMETER 的作用与 HTTP 的 PUT 或 POST 相同。希望发送心跳消息的应用程序应使用空的 GET_PARAMETER 请求。自 cURL 7.20.0 起可用。
CURL_RTSPREQ_OPTIONS (int) 用于检索服务器的可用方法。自 cURL 7.20.0 起可用。
CURL_RTSPREQ_PAUSE (int) 向服务器发送 PAUSE 命令。使用 CURLOPT_RANGE 选项以及单个值来指示何时应停止流(例如 npt=25)。自 cURL 7.20.0 起可用。
CURL_RTSPREQ_PLAY (int) 向服务器发送 PLAY 命令。使用 CURLOPT_RANGE 选项来修改播放时间(例如 npt=10-15)。自 cURL 7.20.0 起可用。
CURL_RTSPREQ_RECEIVE (int) 将 RTSP 请求类型设置为此值以接收交替 RTP 数据。自 cURL 7.20.0 起可用。
CURL_RTSPREQ_RECORD (int) 用于告诉服务器记录会话。使用 CURLOPT_RANGE 选项修改记录时间。自 cURL 7.20.0 起可用。
CURL_RTSPREQ_SETUP (int) 用于初始化会话的传输层。自 cURL 7.20.0 起可用。
CURL_RTSPREQ_SET_PARAMETER (int) 在服务器上设置参数。自 cURL 7.20.0 起可用。
CURL_RTSPREQ_TEARDOWN (int) 终止 RTSP 会话。简单地关闭连接不会终止 RTSP 会话,因为通过不同的连接控制 RTSP 会话是有效的。自 cURL 7.20.0 起可用。
CURL_SSLVERSION_DEFAULT (int)
CURL_SSLVERSION_MAX_DEFAULT (int) 自 PHP 7.3.0 和 cURL 7.54.0 起可用
CURL_SSLVERSION_MAX_NONE (int) 自 PHP 7.3.0 和 cURL 7.54.0 起可用
CURL_SSLVERSION_MAX_TLSv1_0 (int) 自 PHP 7.3.0 和 cURL 7.54.0 起可用
CURL_SSLVERSION_MAX_TLSv1_1 (int) 自 PHP 7.3.0 和 cURL 7.54.0 起可用
CURL_SSLVERSION_MAX_TLSv1_2 (int) 自 PHP 7.3.0 和 cURL 7.54.0 起可用
CURL_SSLVERSION_MAX_TLSv1_3 (int) 自 PHP 7.3.0 和 cURL 7.54.0 起可用
CURL_SSLVERSION_SSLv2 (int)
CURL_SSLVERSION_SSLv3 (int)
CURL_SSLVERSION_TLSv1 (int)
CURL_SSLVERSION_TLSv1_0 (int)
CURL_SSLVERSION_TLSv1_1 (int)
CURL_SSLVERSION_TLSv1_2 (int)
CURL_SSLVERSION_TLSv1_3 (int) 自 PHP 7.3.0 和 cURL 7.52.0 起可用
CURL_TIMECOND_IFMODSINCE (int)
CURL_TIMECOND_IFUNMODSINCE (int)
CURL_TIMECOND_LASTMOD (int)
CURL_TIMECOND_NONE (int)
CURL_TLSAUTH_SRP (int) 自 cURL 7.21.4 起可用。
CURL_VERSION_ALTSVC (int) 自 PHP 7.3.6 和 cURL 7.64.1 起可用
CURL_VERSION_ASYNCHDNS (int) 异步 DNS 解析。自 PHP 7.3.0 和 cURL 7.10.7 起可用
CURL_VERSION_BROTLI (int) 自 PHP 7.3.0 和 cURL 7.57.0 起可用
CURL_VERSION_CONV (int) 字符转换支持。自 PHP 7.3.0 和 cURL 7.15.4 起可用
CURL_VERSION_CURLDEBUG (int) 调试内存跟踪支持。自 PHP 7.3.6 和 cURL 7.19.6 起可用
CURL_VERSION_DEBUG (int) 内置调试功能。自 PHP 7.3.0 和 cURL 7.10.6 起可用
CURL_VERSION_GSASL (int) 自 PHP 8.2.0 和 cURL 7.76.0 起可用
CURL_VERSION_GSSAPI (int) 基于 GSS-API 库编译。自 PHP 7.3.0 和 cURL 7.38.0 起可用
CURL_VERSION_GSSNEGOTIATE (int) 支持协商(Negotiate)身份验证。自 PHP 7.3.0 和 cURL 7.10.6 起可用(自 cURL 7.38.0 起弃用)
CURL_VERSION_HSTS (int) 自 PHP 8.2.0 和 cURL 7.74.0 起可用
CURL_VERSION_HTTP2 (int) 内置 HTTP2 支持。自 cURL 7.33.0 起可用
CURL_VERSION_HTTP3 (int) 自 PHP 8.2.0 和 cURL 7.66.0 起可用
CURL_VERSION_HTTPS_PROXY (int) 自 PHP 7.3.0 和 cURL 7.52.0 起可用
CURL_VERSION_IDN (int) 国际化域名支持。自 PHP 7.3.0 和 cURL 7.12.0 起可用
CURL_VERSION_IPV6 (int) 启用 IPv6。
CURL_VERSION_KERBEROS4 (int) Kerberos V4 身份验证支持。
CURL_VERSION_KERBEROS5 (int) Kerberos V5 身份验证支持。自 PHP 7.0.7 和 cURL 7.40.0 起可用
CURL_VERSION_LARGEFILE (int) 支持大于 2GB 的文件。自 cURL 7.33.0 起可用
CURL_VERSION_LIBZ (int) 存在 libz 功能。
CURL_VERSION_MULTI_SSL (int) 自 PHP 7.3.0 和 cURL 7.56.0 起可用
CURL_VERSION_NTLM (int) NTLM 身份验证支持。自 PHP 7.3.0 和 cURL 7.10.6 起可用
CURL_VERSION_NTLM_WB (int) 支持 NTLM 委派给 winbind 助手。自 PHP 7.3.0 和 cURL 7.22.0 起可用
CURL_VERSION_PSL (int) Mozilla 的公共后缀列表,用于 cookie 域验证。自 PHP 7.3.6 和 cURL 7.47.0 起可用
CURL_VERSION_SPNEGO (int) SPNEGO 身份验证支持。自 PHP 7.3.0 和 cURL 7.10.8 起可用
CURL_VERSION_SSL (int) 存在 SSL 选项。
CURL_VERSION_SSPI (int) 基于 Windows SSPI 编译。 自 PHP 7.3.0 和 cURL 7.13.2 起可用
CURL_VERSION_TLSAUTH_SRP (int) TLS-SRP 身份验证支持。自 PHP 7.3.0 和 cURL 7.21.4 起可用
CURL_VERSION_UNICODE (int) 自 PHP 8.2.0 和 cURL 7.72.0 起可用
CURL_VERSION_UNIX_SOCKETS (int) Unix 域套接字支持。自 PHP 7.0.7 和 cURL 7.40.0 起可用
CURL_VERSION_ZSTD (int) 自 PHP 8.2.0 和 cURL 7.72.0 起可用
CURL_WRITEFUNC_PAUSE (int) 自 cURL 7.18.0 起可用。
CURL_PREREQFUNC_OK (int) 自 PHP 8.4.0 和 cURL 7.80.0 起可用。
CURL_PREREQFUNC_ABORT (int) 自 PHP 8.4.0 和 cURL 7.80.0 起可用。
curl_setopt()
常量 描述
CURLOPT_ABSTRACT_UNIX_SOCKET (int)

允许使用抽象 Unix 域套接字而不是与主机建立 TCP 连接,并将路径设置为指定 string。此选项与 CURLOPT_UNIX_SOCKET_PATH 具有相同的语义。这两个选项共享相同的存储,因此每个句柄只能设置其中一个。自 PHP 7.3.0 和 cURL 7.53.0 起可用。

CURLOPT_ACCEPT_ENCODING (int)

设置 string,其中包含 HTTP 请求中发送的 Accept-Encoding: 标头的内容。设置为 null 可禁用发送 Accept-Encoding: 标头。默认为 null。自 cURL 7.21.6 起可用。

CURLOPT_ACCEPTTIMEOUT_MS (int)

使用活跃 FTP 连接时等待服务器连接回 cURL 的最大毫秒数。此选项接受任何可以转换为有效 int 的值。默认为 60000 毫秒。自 cURL 7.24.0 起可用。

CURLOPT_ADDRESS_SCOPE (int)

连接到 IPv6 地址时使用的范围 ID 值。此选项接受任何可以转换为有效 int 的值。默认为 0。自 cURL 7.19.0 起可用。

CURLOPT_ALTSVC (int)

传递 string,其中包含 cURL 的文件名,用作 Alt-Svc 缓存文件,从中读取现有缓存内容,并可能在传输后将其写回,除非通过 CURLOPT_ALTSVC_CTRL 设置了 CURLOPT_ALTSVC_CTRL。自 PHP 8.2.0 和 cURL 7.64.1 起可用。

CURLOPT_ALTSVC_CTRL (int)

Populate the bitmask with the correct set of features to instruct cURL how to handle Alt-Svc for the transfers using this handle. cURL only accepts Alt-Svc headers over HTTPS. It will also only complete a request to an alternative origin if that origin is properly hosted over HTTPS. Setting any bit will enable the alt-svc engine. Set to any of the CURLALTSVC_* constants. Defaults to Alt-Svc handling being disabled. Available as of PHP 8.2.0 and cURL 7.64.1.

CURLOPT_APPEND (int)

Setting this option to 1 will cause FTP uploads to append to the remote file instead of overwriting it. Defaults to 0. Available as of cURL 7.17.0.

CURLOPT_AUTOREFERER (int)

true 时将根据 Location: 重定向时,自动设置 header 中的 Referer: 信息。默认是 0。自 cURL 7.1.0 起可用。

CURLOPT_AWS_SIGV4 (int)

Provides AWS V4 signature authentication on HTTP(S) header as a string. This option overrides any other authentication types that have been set in CURLOPT_HTTPAUTH. This method cannot be combined with other authentication types. Available as of PHP 8.2.0 and cURL 7.75.0.

CURLOPT_BINARYTRANSFER (int)

This constant is no longer used as of PHP 5.5.0. Deprecated as of PHP 8.4.0.

CURLOPT_BUFFERSIZE (int)

每次读取要使用的缓冲区大小。但不能保证此请求一定会得到满足。此选项接受任何可以转换为有效 int 的值。默认为 CURL_MAX_WRITE_SIZE(当前为 16kB)。自 cURL 7.10 起可用。

CURLOPT_CAINFO (int)

包含一个或多个证书的文件名称的string,用于验证对等方。这仅在与 CURLOPT_SSL_VERIFYPEER 结合使用时才有意义。可能需要绝对路径。自 cURL 7.4.2 起可用。

CURLOPT_CAINFO_BLOB (int)

A string with the name of a PEM file holding one or more certificates to verify the peer with. This option overrides CURLOPT_CAINFO. Available as of PHP 8.2.0 and cURL 7.77.0.

CURLOPT_CAPATH (int)

A string with a directory that holds multiple CA certificates. Use this option alongside CURLOPT_SSL_VERIFYPEER. Available as of cURL 7.9.8.

CURLOPT_CA_CACHE_TIMEOUT (int)

Sets the maximum time in seconds any in memory cached CA certificate store may be kept and reused for new connections. This option accepts any value that can be cast to a valid int. Defaults to 86400 (24 hours). Available as of PHP 8.3.0 and cURL 7.87.0

CURLOPT_CERTINFO (int)

true 将在安全传输时输出 SSL 证书信息到 STDERR。需要开启 CURLOPT_VERBOSE 才有效。默认为 false。自 cURL 7.19.1 起可用。

CURLOPT_CONNECTTIMEOUT (int)

在尝试连接时等待的秒数。设置为 0,则无限等待。此选项接受任何可以转换为有效 int 的值。默认 300。自 cURL 7.7.0 起可用。

CURLOPT_CONNECTTIMEOUT_MS (int)

尝试连接等待的时间,以毫秒为单位。设置为 0,则无限等待。如果 cURL 编译时使用系统标准的名称解析器(standard system name resolver),那部分的连接仍旧使用以秒计的超时解决方案,最小超时时间还是一秒钟。此选项接受任何可以转换为有效 int 的值。默认 300000。自 cURL 7.16.2 起可用。

CURLOPT_CONNECT_ONLY (int)

true 将让库执行所有需要的代理、验证、连接过程,但不传输数据。此选项用于 HTTP、SMTP 和 POP3。默认是 false。自 cURL 7.15.2 起可用。

CURLOPT_CONNECT_TO (int)

连接到指定主机和端口,从而替换 URL 中的主机和端口。接受 string 格式的 arrayHOST:PORT:CONNECT-TO-HOST:CONNECT-TO-PORT。自 PHP 7.0.7 和 cURL 7.49.0 起可用。

包含 HTTP 请求中使用的 Cookie: header 内容的 string。请注意,多个 Cookie 之间用分号分隔,后跟一个空格(例如,fruit=apple; colour=red)。自 cURL 7.1.0 起可用。

CURLOPT_COOKIEFILE (int)

包含 cookie 数据的文件的名称 string。cookie 文件可以是 Netscape 格式,也可以只是转储到文件中的纯 HTTP 样式标头。如果名称为空 string,则不会加载任何 cookie,但仍启用 cookie 处理。自 cURL 7.1.0 起可用。

CURLOPT_COOKIEJAR (int)

string,包含调用句柄的析构函数时用于保存所有内部 cookie 的文件的名称。自 cURL 7.9.0 起可用。

警告

自 PHP 8.0.0 起,curl_close() 为空操作(什么都不做),不会销毁句柄。如果需要在句柄自动销毁之前写入 cookie,在句柄上调用 unset()

CURLOPT_COOKIELIST (int)

cookie string(即 Netscape/Mozilla 的单行格式,或常规 HTTP 样式的 Set-Cookie header)将单个 cookie 添加到内部 cookie 存储中。 ALL 擦除内存中保存的所有 cookie , SESS 擦除内存中保存的所有会话 cookie , FLUSH 将所有已知的 cookie 写入到 CURLOPT_COOKIEJAR 指定的文件 , RELOADCURLOPT_COOKIEFILE 指定的文件中加载所有 cookie . 自 cURL 7.14.1 起可用。

CURLOPT_COOKIESESSION (int)

设为 true 时将开启新的 cookie“会话”。将强制 cURL 忽略之前会话时存的其他 cookie。cURL 在默认情况下无论是否为会话,都会储存、加载所有 cookie。会话 cookie 是指没有过期时间,只存活在会话之中。自 cURL 7.9.7 起可用。

CURLOPT_CRLF (int)

true 表示将 Unix 换行符转换成 CRLF 换行符。自 cURL 7.1.0 起可用。

CURLOPT_CRLFILE (int)

Pass a string naming a file with the concatenation of CRL (Certificate Revocation List) (in PEM format) to use in the certificate validation that occurs during the SSL exchange. When cURL is built to use GnuTLS, there is no way to influence the use of CRL passed to help in the verification process. When cURL is built with OpenSSL support, X509_V_FLAG_CRL_CHECK and X509_V_FLAG_CRL_CHECK_ALL are both set, requiring CRL check against all the elements of the certificate chain if a CRL file is passed. Also note that CURLOPT_CRLFILE implies CURLSSLOPT_NO_PARTIALCHAIN as of cURL 7.71.0 due to an OpenSSL bug. Available as of cURL 7.19.0.

CURLOPT_CUSTOMREQUEST (int)

HTTP 请求时,使用自定义的请求方法来代替 GETHEAD。对 DELETE 或者其他更隐蔽的 HTTP 请求有用。有效值如 GETPOSTCONNECT 等等;也就是说,不要在这里输入整行 HTTP 请求。例如输入 GET /index.html HTTP/1.0\r\n\r\n 是不正确的。此选项接受 stringnull。自 cURL 7.1.0 起可用。

注意:

在没有首先确保服务器支持自定义请求方法的情况下,不要执行此操作。

CURLOPT_DEFAULT_PROTOCOL (int)

URL 缺少协议的时候,使用 string 格式的默认协议。自 PHP 7.0.7 和 cURL 7.45.0 起可用。

CURLOPT_DIRLISTONLY (int)

Setting this option to 1 will have different effects based on the protocol it is used with. FTP and SFTP based URLs will list only the names of files in a directory. POP3 will list the email message or messages on the POP3 server. For FILE, this option has no effect as directories are always listed in this mode. Using this option with CURLOPT_WILDCARDMATCH will prevent the latter from having any effect. Defaults to 0. Available as of cURL 7.17.0.

CURLOPT_DISALLOW_USERNAME_IN_URL (int)

true to not allow URLs that include a username. Usernames are allowed by default. Available as of PHP 7.3.0 and cURL 7.61.0.

CURLOPT_DNS_CACHE_TIMEOUT (int)

设置在内存中缓存 DNS 的时间,默认为 120 秒(2 分钟)。此选项接受任何可以转换为有效 int 的值。自 cURL 7.9.3 起可用。

CURLOPT_DNS_INTERFACE (int)

Set the name of the network interface that the DNS resolver should bind to. This must be an interface name (not an address). This option accepts a string or null. Available as of PHP 7.0.7 and cURL 7.33.0

CURLOPT_DNS_LOCAL_IP4 (int)

Set the local IPv4 address that the resolver should bind to. The argument should contain a single numerical IPv4 address. This option accepts a string or null. Available as of PHP 7.0.7 and cURL 7.33.0.

CURLOPT_DNS_LOCAL_IP6 (int)

Set the local IPv6 address that the resolver should bind to. The argument should contain a single numerical IPv6 address. This option accepts a string or null. Available as of PHP 7.0.7 and cURL 7.33.0.

CURLOPT_DNS_SERVERS (int)

Pass a string with a comma-separated list of DNS servers to be used instead of the system default (e.g.: 192.168.1.100,192.168.1.101:8080). Available as of cURL 7.24.0.

CURLOPT_DNS_SHUFFLE_ADDRESSES (int)

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. Available as of PHP 7.3.0 and cURL 7.60.0.

CURLOPT_DNS_USE_GLOBAL_CACHE (int)

true 表示使用全局 DNS 缓存。此选项非线程安全。如果 PHP 是为非线程使用(CLI、FCGI、Apache2-Prefork 等)构建的,则默认情况下会有条件性的启用此选项。自 cURL 7.9.3 起可用,自 cURL 7.11.1 起弃用。自 PHP 8.4 起,此选项不再有效。

CURLOPT_DOH_SSL_VERIFYHOST (int)

Set to 2 to verify the DNS-over-HTTPS server's SSL certificate name fields against the host name. Available as of PHP 8.2.0 and cURL 7.76.0.

CURLOPT_DOH_SSL_VERIFYPEER (int)

Set to 1 to enable and 0 to disable verification of the authenticity of the DNS-over-HTTPS server's SSL certificate. Available as of PHP 8.2.0 and cURL 7.76.0.

CURLOPT_DOH_SSL_VERIFYSTATUS (int)

Set to 1 to enable and 0 to disable the verification of the status of the DNS-over-HTTPS server certificate using the "Certificate Status Request" TLS extension (OCSP stapling). Available as of PHP 8.2.0 and cURL 7.76.0.

CURLOPT_DOH_URL (int)

Provides the DNS-over-HTTPS URL. This option accepts a string or null. Available as of PHP 8.1.0 and cURL 7.62.0.

CURLOPT_EGDSOCKET (int)

Like CURLOPT_RANDOM_FILE, except a filename to an Entropy Gathering Daemon socket. Available as of cURL 7.7.0 and deprecated as of cURL 7.84.0.

CURLOPT_ENCODING (int)

The contents of the Accept-Encoding: header as a string. This enables decoding of the response. Supported encodings are: identity, deflate, gzip. If an empty string is set, a header containing all supported encoding types is sent. Available as of cURL 7.10 and deprecated as of cURL 7.21.6.

CURLOPT_EXPECT_100_TIMEOUT_MS (int)

Expect: 100-continue 响应的超时时间,以毫秒为单位。默认为 1000 毫秒。此选项接受任何可以转换为有效 int 的值。自 PHP 7.0.7 和 cURL 7.36.0 起可用。

CURLOPT_FAILONERROR (int)

当 HTTP 状态码大于等于 400true 将显示错误详情。默认情况下将返回页面,忽略 HTTP 代码。自 cURL 7.1.0 起可用。

CURLOPT_FILE (int)

Accepts a file handle resource to the file that the transfer should be written to. The default is STDOUT (the browser window). Available as of cURL 7.1.0 and deprecated as of cURL 7.9.7.

CURLOPT_FILETIME (int)

设置为 true 时,会尝试获取远程文档中的修改时间信息。此值可通过 curl_getinfo() 函数的 CURLINFO_FILETIME 选项获取。自 cURL 7.5.0 起可用。

CURLOPT_FNMATCH_FUNCTION (int)

Pass a callable that will be used for wildcard matching. The signature of the callback should be:

callback(resource $curlHandle, string $pattern, string $string): int
curlHandle
The cURL handle.
pattern
The wildcard pattern.
string
The string to run the wildcard pattern matching on.
The callback should return CURL_FNMATCHFUNC_MATCH if pattern matches the string, CURL_FNMATCHFUNC_NOMATCH if not or CURL_FNMATCHFUNC_FAIL if an error occurred. Available as of cURL 7.21.0.

CURLOPT_FOLLOWLOCATION (int)

设置为 true 时将会根据服务器返回 HTTP header 中的 Location: 重定向。参 CURLOPT_MAXREDIRS。当 open_basedir 启用时,此常量无效。自 cURL 7.1.0 起可用。

CURLOPT_FORBID_REUSE (int)

设置为 true 后,在完成交互以后强制断开连接,不能在连接池中重用。自 cURL 7.7.0 起可用。

CURLOPT_FRESH_CONNECT (int)

设置为 true 强制获取新连接,而不是缓存中的连接。自 cURL 7.7.0 起可用。

CURLOPT_FTPAPPEND (int)

设置为 true 时为追加写入文件,而不是覆盖。自 cURL 7.1.0 起可用并于 cURL 7.16.4 起弃用。

CURLOPT_FTPASCII (int)

CURLOPT_TRANSFERTEXT 的别名。请改用 CURLOPT_TRANSFERTEXT。自 cURL 7.1 起可用,自 cURL 7.11.1 起弃用,最后在 cURL 7.15.5 中可用。自 PHP 7.3.0 起移除。

CURLOPT_FTPLISTONLY (int)

设置为 true 时只列出 FTP 目录的名称。自 cURL 7.1.0 起可用并于 cURL 7.16.4 起弃用。

CURLOPT_FTPPORT (int)

A string 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 system's default IP address. This option accepts a string or null. Available as of cURL 7.1.0.

CURLOPT_FTPSSLAUTH (int)

将 FTP over SSL 身份验证方法(如果已启用)设置为任何 CURLFTPAUTH_* 常量。默认 CURLFTPAUTH_DEFAULT。自 cURL 7.12.2 起可用。

CURLOPT_FTP_ACCOUNT (int)

Pass a string that will be sent as account information over FTP (using the ACCT command) after username and password has been provided to the server. Set to null to disable sending the account information. Defaults to null. Available as of cURL 7.13.0.

CURLOPT_FTP_ALTERNATIVE_TO_USER (int)

Pass a string that will be used to try to authenticate over FTP if the USER/PASS negotiation fails. Available as of cURL 7.15.5.

CURLOPT_FTP_CREATE_MISSING_DIRS (int)

设置为 true 时在 FTP 操作遇到当前不存在的路径时会创建缺失的目录。自 cURL 7.10.7 起可用。

CURLOPT_FTP_FILEMETHOD (int)

Tell cURL which method to use to reach a file on a FTP(S) server. Possible values are any of the CURLFTPMETHOD_* constants. Defaults to CURLFTPMETHOD_MULTICWD. Available as of cURL 7.15.1.

CURLOPT_FTP_RESPONSE_TIMEOUT (int)

A timeout in seconds cURL will wait for a response from an FTP server. This option overrides CURLOPT_TIMEOUT. This option accepts any value that can be cast to a valid int. This option name is replaced with CURLOPT_SERVER_RESPONSE_TIMEOUT, available as of PHP 8.4.0. Available as of cURL 7.10.8 and deprecated as of cURL 7.85.0.

CURLOPT_FTP_SKIP_PASV_IP (int)

If this option is set to 1 cURL will not use the IP address the server suggests in its 227-response to cURL's PASV command but will use the IP address it used for the connection. The port number received from the 227-response will not be ignored by cURL. Defaults to 1 as of cURL 7.74.0 and 0 prior to that. Available as of cURL 7.15.0.

CURLOPT_FTP_SSL (int)

Available as of cURL 7.11.0 and deprecated as of cURL 7.16.4.

CURLOPT_FTP_SSL_CCC (int)

This option makes cURL use CCC (Clear Command Channel) which shuts down the SSL/TLS layer after authenticating making the rest of the control channel communication unencrypted. Use one of the CURLFTPSSL_CCC_* constants. Defaults to CURLFTPSSL_CCC_NONE. Available as of cURL 7.16.1.

CURLOPT_FTP_USE_EPRT (int)

设置为 true 时,当 FTP 下载时,使用 EPRT (和 LPRT)命令。设置为 false 时禁用 EPRTLPRT,仅仅使用 PORT 命令。自 cURL 7.10.5 起可用。

CURLOPT_FTP_USE_EPSV (int)

设置为 true 时,在 FTP 传输过程中,回到 PASV 模式前,先尝试 EPSV 命令。设置为 false 时禁用 EPSV。自 cURL 7.9.2 起可用。

CURLOPT_FTP_USE_PRET (int)

Set to 1 to send a PRET command before PASV (and EPSV). Has no effect when using the active FTP transfers mode. Defaults to 0. Available as of cURL 7.20.0.

CURLOPT_GSSAPI_DELEGATION (int)

Set to CURLGSSAPI_DELEGATION_FLAG to allow unconditional GSSAPI credential delegation. Set to CURLGSSAPI_DELEGATION_POLICY_FLAG to delegate only if the OK-AS-DELEGATE flag is set in the service ticket. Defaults to CURLGSSAPI_DELEGATION_NONE. Available as of cURL 7.22.0.

CURLOPT_HAPPY_EYEBALLS_TIMEOUT_MS (int)

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. This option accepts any value that can be cast to a valid int. Available as of PHP 7.3.0 and cURL 7.59.0

CURLOPT_HAPROXYPROTOCOL (int)

true to send an HAProxy PROXY protocol v1 header at the start of the connection. The default action is not to send this header. Available as of PHP 7.3.0 and cURL 7.60.0.

CURLOPT_HEADER (int)

设置为 true 以将 header 包含在发送到 CURLOPT_WRITEFUNCTION 定义的回调的输出中。自 cURL 7.1.0 起可用。

CURLOPT_HEADERFUNCTION (int)

A callable with the following signature:

callback(resource $curlHandle, string $headerData): int
curlHandle
The cURL handle.
headerData
The header data which must be written by the callback.
The callback should return the number of bytes written. Available as of cURL 7.7.2.

CURLOPT_HEADEROPT (int)

将 HTTP header 同时发送到代理和主机或单独发送。可能的值是 CURLHEADER_* 常量。自 cURL 7.42.1 起默认 CURLHEADER_SEPARATE,在此之前默认为 CURLHEADER_UNIFIED。自 PHP 7.0.7 和 cURL 7.37.0 起可用。

CURLOPT_HSTS (int)

string with HSTS (HTTP Strict Transport Security) cache file name or null to allow HSTS without reading from or writing to any file and clear the list of files to read HSTS data from. Available as of PHP 8.2.0 and cURL 7.74.0.

CURLOPT_HSTS_CTRL (int)

Accepts a bitmask of HSTS (HTTP Strict Transport Security) features defined by the CURLHSTS_* constants. Available as of PHP 8.2.0 and cURL 7.74.0.

CURLOPT_HTTP09_ALLOWED (int)

是否允许 HTTP/0.9 响应。从 cURL 7.66.0 起默认为 false;以前默认为 true。分别自 PHP 7.3.15 和 7.4.3 以及 cURL 7.64.0 起可用。

CURLOPT_HTTP200ALIASES (int)

An array of HTTP 200 responses that will be treated as valid responses and not as errors. Available as of cURL 7.10.3.

CURLOPT_HTTPAUTH (int)

使用的 HTTP 验证方法。选项有: CURLAUTH_BASIC, CURLAUTH_DIGEST, CURLAUTH_GSSNEGOTIATE, CURLAUTH_NTLM, CURLAUTH_AWS_SIGV4, CURLAUTH_ANY, CURLAUTH_ANYSAFE。如果使用多种方法,cURL 将轮询服务器以查看它支持哪些方法并选择最佳方法。CURLAUTH_ANY 设置所有的位。cURL 将自动选择它认为最安全的一个。CURLAUTH_ANYSAFE 设置了除 CURLAUTH_BASIC 以外所有的位。cURL 将自动选择它认为最安全的一个。自 cURL 7.10.6 起可用。

CURLOPT_HTTPGET (int)

设置为 true 时会设置 HTTP 方法为 GET,由于默认是 GET,所以只有修改请求方法时才需要这个选项。自 cURL 7.8.1 起可用。

CURLOPT_HTTPHEADER (int)

An array of HTTP header fields to set, in the format array('Content-type: text/plain', 'Content-length: 100') Available as of cURL 7.1.0.

CURLOPT_HTTPPROXYTUNNEL (int)

true 会通过指定 HTTP 代理来传输。自 cURL 7.3.0 起可用。

CURLOPT_HTTP_CONTENT_DECODING (int)

false 时获取原始 HTTP 响应主体。自 cURL 7.16.2 起可用。

CURLOPT_HTTP_TRANSFER_DECODING (int)

If set to 0, transfer decoding is disabled. If set to 1, transfer decoding is enabled. cURL does chunked transfer decoding by default unless this option is set to 0. Defaults to 1. Available as of cURL 7.16.2.

CURLOPT_HTTP_VERSION (int)

设置为 CURL_HTTP_VERSION_* 常量中的一个,以便 cURL 使用指定的 HTTP 版本。自 cURL 7.9.1 起可用。

CURLOPT_IGNORE_CONTENT_LENGTH (int)

If set to 1, ignore the Content-Length header in the HTTP response and ignore asking for or relying on it for FTP transfers. Defaults to 0. Available as of cURL 7.14.1.

CURLOPT_INFILE (int)

Accepts a file handle resource to the file that the transfer should be read from when uploading. Available as of cURL 7.1.0 and deprecated as of cURL 7.9.7. Use CURLOPT_READDATA instead.

CURLOPT_INFILESIZE (int)

希望传给远程站点的文件字节大小。注意无法用这个选项阻止 cURL 发送更多的数据,确切发送什么取决于 CURLOPT_READFUNCTION。此选项接受任何可以转换为有效 int 的值。自 cURL 7.1.0 起可用。

CURLOPT_INTERFACE (int)

Set to a string with the name of the outgoing network interface to use. This can be an interface name, an IP address or a host name. Available as of cURL 7.1.0.

CURLOPT_IPRESOLVE (int)

允许应用程序选择在解析主机名时使用哪种 IP 地址。这仅在使用解析使用多个 IP 版本的地址的主机名时才有意义。设置为 CURL_IPRESOLVE_* 常量中的一个。默认为 CURL_IPRESOLVE_WHATEVER。自 cURL 7.10.8 起可用。

CURLOPT_ISSUERCERT (int)

If set to a string naming a file holding a CA certificate in PEM format, an additional check against the peer certificate is performed to verify the issuer is indeed the one associated with the certificate provided by the option. For the result of the check to be considered a failure, this option should be used in combination with the CURLOPT_SSL_VERIFYPEER option. Available as of cURL 7.19.0.

CURLOPT_ISSUERCERT_BLOB (int)

Pass a string with binary data of a CA SSL certificate in PEM format. If set, an additional check against the peer certificate is performed to verify the issuer is the one associated with the certificate provided by the option. Available as of PHP 8.1.0 and cURL 7.71.0.

CURLOPT_KEEP_SENDING_ON_ERROR (int)

设置为 true 时,如果返回的 HTTP 代码等于或大于 300,则继续发送请求主体。默认操作是停止发送并关闭流或连接。适用于手动 NTLM 身份验证。大多数应用程序不需要此选项。自 PHP 7.3.0 和 cURL 7.51.0 起可用。

CURLOPT_KEYPASSWD (int)

Set to a string with the password required to use the CURLOPT_SSLKEY or CURLOPT_SSH_PRIVATE_KEYFILE private key. Setting this option to null disables using a password for these options. Available as of cURL 7.17.0.

CURLOPT_KRB4LEVEL (int)

The KRB4 (Kerberos 4) security level. Any of the following string values (in order from least to most powerful) are valid: clear, safe, confidential, private. If the string does not match one of these, private is used. Setting this option to null will disable KRB4 security. Currently KRB4 security only works with FTP transactions. Available as of cURL 7.3.0 and deprecated as of cURL 7.17.0.

CURLOPT_KRBLEVEL (int)

Set the kerberos security level for FTP and also enables kerberos awareness. This should be set to one of the following strings: clear, safe, confidential, private. If the string is set but does not match one of these, private is used. Setting this option to null will disable kerberos support for FTP. Defaults to null. Available as of cURL 7.16.4.

CURLOPT_LOCALPORT (int)

Sets the local port number of the socket used for the connection. This option accepts any value that can be cast to a valid int. Defaults to 0. Available as of cURL 7.15.2.

CURLOPT_LOCALPORTRANGE (int)

The number of attempts cURL makes to find a working local port number, starting with the one set with CURLOPT_LOCALPORT. This option accepts any value that can be cast to a valid int. Defaults to 1. Available as of cURL 7.15.2.

CURLOPT_LOGIN_OPTIONS (int)

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 CURLOPT_USERNAME option. Available as of PHP 7.0.7 and cURL 7.34.0.

CURLOPT_LOW_SPEED_LIMIT (int)

传输速度,每秒字节数,根据 CURLOPT_LOW_SPEED_TIME 秒数统计是否因太慢而取消传输。此选项接受任何可以转换为有效 int 的值。自 cURL 7.1.0 起可用。

CURLOPT_LOW_SPEED_TIME (int)

当传输速度小于 CURLOPT_LOW_SPEED_LIMIT 时(bytes/sec),PHP 会判断是否因太慢而取消传输。此选项接受任何可以转换为有效 int 的值。自 cURL 7.1.0 起可用。

CURLOPT_MAIL_AUTH (int)

Set a string with the authentication address (identity) of a submitted message that is being relayed to another server. The address should not be specified within a pair of angled brackets (><). If an empty string is used then a pair of brackets are sent by cURL as required by RFC 2554. Available as of cURL 7.25.0.

CURLOPT_MAIL_FROM (int)

Set a string with the sender's email address when sending SMTP mail. The email address should be specified with angled brackets (><) around it, which if not specified are added automatically. If this parameter is not specified then an empty address is sent to the SMTP server which might cause the email to be rejected. Available as of cURL 7.20.0.

CURLOPT_MAIL_RCPT (int)

Set to an array of strings with the recipients to pass to the server in an SMTP mail request. Each recipient should be specified within a pair of angled brackets (><). If an angled bracket is not used as the first character, cURL assumes a single email address has been provided and encloses that address within brackets. Available as of cURL 7.20.0.

CURLOPT_MAIL_RCPT_ALLLOWFAILS (int)

设置为 1 以允许 RCPT TO 命令对某些收件人失败,这会使 cURL 忽略个别收件人的错误并继续处理其余已接受的收件人。如果所有收件人触发失败并且设置了此 flag,cURL 将中止 SMTP 对话并返回从最后一个 RCPT TO 命令收到的错误。自 cURL 8.2.0 起由 CURLOPT_MAIL_RCPT_ALLOWFAILS 取代。自 PHP 8.2.0 和 cURL 7.69.0 起可用。自 cURL 8.2.0 起弃用。

CURLOPT_MAXAGE_CONN (int)

重新使用已存在连接时允许的最大空闲时间。默认最大时间设置为 118 秒。此选项接受任何可以转换为有效 int 的值。自 PHP 8.2.0 和 cURL 7.65.0 起可用。

CURLOPT_MAXCONNECTS (int)

允许的最大持久连接数。当达到限制时,将会关闭缓存中最早的连接,以防止增加已打开的连接数。此选项接受任何可以转换为有效 int 的值。自 cURL 7.7.0 起可用。

CURLOPT_MAXFILESIZE (int)

Sets the maximum accepted size (in bytes) of a file to download. If the file requested is found larger than this value, the transfer is aborted and CURLE_FILESIZE_EXCEEDED is returned. Passing 0 disables this option, and passing a negative size returns a CURLE_BAD_FUNCTION_ARGUMENT. If the file size is not known prior to the start of download, this option has no effect. For setting a size limit above 2GB, CURLOPT_MAXFILESIZE_LARGE should be used. As of cURL 8.4.0, this option also stops ongoing transfers if they reach this threshold. This option accepts any value that can be cast to a valid int. Defaults to 0. Available as of cURL 7.10.8.

CURLOPT_MAXFILESIZE_LARGE (int)

The maximum file size in bytes allowed to download. If the file requested is found larger than this value, the transfer will not start and CURLE_FILESIZE_EXCEEDED will be returned. The file size is not always known prior to download, and for such files this option has no effect even if the file transfer ends up being larger than this given limit. This option accepts any value that can be cast to a valid int. Available as of PHP 8.2.0 and cURL 7.11.0.

CURLOPT_MAXLIFETIME_CONN (int)

The maximum time in seconds, since the creation of the connection, that is allowed for an existing connection to have for it to be considered for reuse. If a connection is found in the cache that is older than this value, it will instead be closed once any in-progress transfers are complete. Default is 0 seconds, meaning the option is disabled and all connections are eligible for reuse. This option accepts any value that can be cast to a valid int. Available as of PHP 8.2.0 and cURL 7.80.0.

CURLOPT_MAXREDIRS (int)

指定最多的 HTTP 重定向次数,这个选项是和 CURLOPT_FOLLOWLOCATION 一起使用的。默认值 20 是为了防止无限重定向。设置为 -1 允许无限重定向,0 拒绝所有重定向。自 cURL 7.5.0 起可用。

CURLOPT_MAX_RECV_SPEED_LARGE (int)

如果下载速度超过了此速度(以每秒字节数来统计),即传输过程中累计的平均数,传输就会降速到这个参数的值。默认不限速。 This option accepts any value that can be cast to a valid int. Available as of cURL 7.15.5.

CURLOPT_MAX_SEND_SPEED_LARGE (int)

如果上传的速度超过了此速度(以每秒字节数来统计),即传输过程中累计的平均数,传输就会降速到这个参数的值。默认不限速。 This option accepts any value that can be cast to a valid int. Available as of cURL 7.15.5.

CURLOPT_MIME_OPTIONS (int)

Set to a bitmask of CURLMIMEOPT_* constants. Currently there is only one available option: CURLMIMEOPT_FORMESCAPE. Available as of PHP 8.3.0 and cURL 7.81.0.

CURLOPT_MUTE (int)

设置 true 时将完全静默,无论是何 cURL 函数。使用 CURLOPT_RETURNTRANSFER 代替。自 cURL 7.1.0 起可用,自 cURL 7.8.0 起弃用,最后在 cURL 7.15.5 中可用。自 PHP 7.3.0 起移除。

CURLOPT_NETRC (int)

设置为 true 时,在连接建立时,访问 ~/.netrc 文件获取用户名和密码来连接远程站点。自 cURL 7.1.0 起可用。

CURLOPT_NETRC_FILE (int)

Set a string containing the full path name to a .netrc file. If this option is omitted and CURLOPT_NETRC is set, cURL checks for a .netrc file in the current user's home directory. Available as of cURL 7.11.0.

CURLOPT_NEW_DIRECTORY_PERMS (int)

Sets the value of the permissions (int) that is set on newly created directories on the remote server. The default value is 0755. The only protocols that can use this are sftp://, scp:// and file://. Available as of cURL 7.16.4.

CURLOPT_NEW_FILE_PERMS (int)

Sets the value of the permissions (as an int) that are set on newly created files on the remote server. The default value is 0644. The only protocols that can use this are sftp://, scp:// and file://. Available as of cURL 7.16.4.

CURLOPT_NOBODY (int)

设置为 true 可从输出中排除正文。对于 HTTP(S),cURL 会发出 HEAD 请求。对于大多数其他协议,cURL 根本不会要求正文数据。将其更改为 false 将导致正文数据包含在输出中。自 cURL 7.1.0 起可用。

CURLOPT_NOPROGRESS (int)

设置为 true 时关闭 cURL 的传输进度。

注意:

PHP 自动设置此选项为 true,只有用于调试才需要改变设置。

自 cURL 7.1.0 起可用。

CURLOPT_NOPROXY (int)

Set a string consisting of a comma separated list of hostnames that do not require a proxy to get reached. Each name in this list is matched as either a domain which contains the hostname or the hostname itself. The only wildcard available in the string is a single * character which matches all hosts, effectively disabling the proxy. Setting this option to an empty string enables the proxy for all hostnames. Since cURL 7.86.0, IP addresses set with this option can be provided using CIDR notation. Available as of cURL 7.19.4.

CURLOPT_NOSIGNAL (int)

true 时忽略所有的 cURL 函数传递给 PHP 进程的信号。在 SAPI 多线程传输时默认启用此选项,所以超时选项仍能使用。自 cURL 7.10 起可用。

CURLOPT_PASSWDFUNCTION (int)

A callable with the following signature:

callback(resource $curlHandle, string $passwordPrompt, int $maximumPasswordLength): string
curlHandle
The cURL handle.
passwordPrompt
A password prompt.
maximumPasswordLength
The maximum length of the password.
The callback should return a string containing the password. Available as of cURL 7.4.2, deprecated as of cURL 7.11.1 and last available in cURL 7.15.5. Removed as of PHP 7.3.0.

CURLOPT_PASSWORD (int)

Set to a string with the password to use in authentication. Available as of cURL 7.19.1.

CURLOPT_PATH_AS_IS (int)

Set to true for cURL not alter URL paths before passing them on to the server. Defaults to false, which squashes sequences of /../ or /./ that may exist in the URL's path part which is supposed to be removed according to RFC 3986 section 5.2.4. Available as of PHP 7.0.7 and cURL 7.42.0.

CURLOPT_PINNEDPUBLICKEY (int)

Set a string with the pinned public key. The string can be the file name of the pinned public key in a PEM or DER file format. The string can also be any number of base64 encoded sha256 hashes preceded by sha256// and separated by ;. Available as of PHP 7.0.7 and cURL 7.39.0.

CURLOPT_PIPEWAIT (int)

Set to true to wait for an existing connection to confirm whether it can do multiplexing and use it if it can before creating and using a new connection. Available as of PHP 7.0.7 and cURL 7.43.0.

CURLOPT_PORT (int)

An int with an alternative port number to connect to instead of the one specified in the URL or the default port for the used protocol. Available as of cURL 7.1.0.

CURLOPT_POST (int)

设置为 true 用于执行 HTTP POST 请求。此请求使用 application/x-www-form-urlencoded header。默认为 false。自 cURL 7.1.0 起可用。

CURLOPT_POSTFIELDS (int)

The full data to post in a HTTP POST operation. This parameter can either be passed as a urlencoded string like 'para1=val1&para2=val2&...' or as an array with the field name as key and field data as value. If value is an array, the Content-Type header will be set to multipart/form-data. Files can be sent using CURLFile or CURLStringFile, in which case value must be an array. Available as of cURL 7.1.0.

CURLOPT_POSTQUOTE (int)

An array of FTP command strings to execute on the server after the FTP request has been performed. Available as of cURL 7.1.0.

CURLOPT_POSTREDIR (int)

位掩码,CURL_REDIR_POST_301CURL_REDIR_POST_302CURL_REDIR_POST_303。当设置 CURLOPT_FOLLOWLOCATION 并发生了特定类型的重定向时,是否需要再次 HTTP POST 到重定向网址。自 cURL 7.19.1 起可用。

CURLOPT_PRE_PROXY (int)

Set a string 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 CURLOPT_PROXY option for the upcoming request. The preproxy can only be a SOCKS proxy and it should be prefixed with [scheme]:// 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 :[port] to the end of the host name. The proxy's port number may optionally be specified with the separate option CURLOPT_PROXYPORT. Defaults to using port 1080 for proxies if a port is not specified. Available as of PHP 7.3.0 and cURL 7.52.0.

CURLOPT_PREQUOTE (int)

Set an array of FTP command strings to pass to the server after the transfer type is set. These commands are not performed when a directory listing is performed, only for file transfers. Available as of cURL 7.9.5.

CURLOPT_PRIVATE (int)

Any data that should be associated with this cURL handle. This data can subsequently be retrieved with the CURLINFO_PRIVATE option of curl_getinfo(). 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. Available as of cURL 7.10.3.

CURLOPT_PROGRESSFUNCTION (int)

A callable with the following signature:

callback(
    resource $curlHandle,
    int $bytesToDownload,
    int $bytesDownloaded,
    int $bytesToUpload,
    int $bytesUploaded
): int
curlHandle
The cURL handle.
bytesToDownload
The total number of bytes expected to be downloaded in this transfer.
bytesDownloaded
The number of bytes downloaded so far.
bytesToUpload
The total number of bytes expected to be uploaded in this transfer.
bytesUploaded
The number of bytes uploaded so far.
The callback should return an int with a non-zero value to abort the transfer and set a CURLE_ABORTED_BY_CALLBACK error.

注意:

The callback is only called when the CURLOPT_NOPROGRESS option is set to false.

Available as of cURL 7.1.0 and deprecated as of cURL 7.32.0. Use CURLOPT_XFERINFOFUNCTION instead.

CURLOPT_PROTOCOLS (int)

Bitmask of CURLPROTO_* values. If used, this bitmask limits what protocols cURL may use in the transfer. Defaults to CURLPROTO_ALL, ie. cURL will accept all protocols it supports. See also CURLOPT_REDIR_PROTOCOLS. Available as of cURL 7.19.4 and deprecated as of cURL 7.85.0.

CURLOPT_PROTOCOLS_STR (int)

Set to a string with a comma separated list of case insensitive protocol names (URL schemes) to allow in the transfer. Set to ALL to enable all protocols. By default, cURL accepts all protocols it was built with support for. Available protocols are: DICT, FILE, FTP, FTPS, GOPHER, GOPHERS, HTTP, HTTPS, IMAP, IMAPS, LDAP, LDAPS, MQTT, POP3, POP3S, RTMP, RTMPE, RTMPS, RTMPT, RTMPTE, RTMPTS, RTSP, SCP, SFTP, SMB, SMBS, SMTP, SMTPS, TELNET, TFTP, WS, WSS. Available as of PHP 8.3.0 and cURL 7.85.0.

CURLOPT_PROXY (int)

A string with the HTTP proxy to tunnel requests through. This should be the hostname, the dotted numerical IP address or a numerical IPv6 address written within [brackets]. Available as of cURL 7.1.0.

CURLOPT_PROXYAUTH (int)

A bitmask of the HTTP authentication method(s) (CURLAUTH_* constants) to use for the proxy connection. For proxy authentication, only CURLAUTH_BASIC and CURLAUTH_NTLM are currently supported. Defaults to CURLAUTH_BASIC. Available as of cURL 7.10.7.

CURLOPT_PROXYHEADER (int)

An array of custom HTTP header strings to pass to proxies. Available as of PHP 7.0.7 and cURL 7.37.0.

CURLOPT_PROXYPASSWORD (int)

Set a string with the password to be used for authentication with the proxy. Available as of cURL 7.19.1.

CURLOPT_PROXYPORT (int)

An int with the port number of the proxy to connect to. This port number can also be set in CURLOPT_PROXY. Setting this to zero makes cURL use the default proxy port number or the port number specified in the proxy URL string. Available as of cURL 7.1.0.

CURLOPT_PROXYTYPE (int)

Sets the type of the proxy to one of the CURLPROXY_* constants. Defaults to CURLPROXY_HTTP. Available as of cURL 7.10.

CURLOPT_PROXYUSERNAME (int)

Set a string with the username to be used for authentication with the proxy. Available as of cURL 7.19.1.

CURLOPT_PROXYUSERPWD (int)

A string with a username and password formatted as [username]:[password] to use for the connection to the proxy. Available as of cURL 7.1.0.

CURLOPT_PROXY_CAINFO (int)

The path to proxy Certificate Authority (CA) bundle. Set the path as a string 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 cURL's cacert bundle is assumed to be stored. Available as of PHP 7.3.0 and cURL 7.52.0.

CURLOPT_PROXY_CAINFO_BLOB (int)

A string with the name of a PEM 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 cURL's cacert bundle is assumed to be stored. Available as of PHP 8.2.0 and cURL 7.77.0.

CURLOPT_PROXY_CAPATH (int)

A string with the directory holding multiple CA certificates to verify the HTTPS proxy with. Available as of PHP 7.3.0 and cURL 7.52.0.

CURLOPT_PROXY_CRLFILE (int)

Set to a string with 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. Available as of PHP 7.3.0 and cURL 7.52.0.

CURLOPT_PROXY_ISSUERCERT (int)

Proxy issuer SSL certificate filename string. Available as of PHP 8.1.0 and cURL 7.71.0.

CURLOPT_PROXY_ISSUERCERT_BLOB (int)

A string with the proxy issuer SSL certificate. Available as of PHP 8.1.0 and cURL 7.71.0.

CURLOPT_PROXY_KEYPASSWD (int)

Set the string be used as the password required to use the CURLOPT_PROXY_SSLKEY private key. A passphrase is not needed to load a certificate but one is needed to load a private key. This option is for connecting to an HTTPS proxy, not an HTTPS server. Available as of PHP 7.3.0 and cURL 7.52.0.

CURLOPT_PROXY_PINNEDPUBLICKEY (int)

Set the pinned public key for HTTPS proxy. The string can be the file name of the pinned public key which is expected to be in a PEM or DER file format. The string can also be any number of base64 encoded sha256 hashes preceded by sha256// and separated by ;. Available as of PHP 7.3.0 and cURL 7.52.0.

CURLOPT_PROXY_SERVICE_NAME (int)

A string with the proxy authentication service name. Available as of PHP 7.0.7, cURL 7.43.0 (for HTTP proxies) and cURL 7.49.0 (for SOCKS5 proxies).

CURLOPT_PROXY_SSLCERT (int)

A string with the file name of the 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 CURLOPT_PROXY_SSLCERTTYPE. With NSS or Secure Transport, this can also be the nickname of the certificate used for authentication as it is named in the security database. If a file from the current directory is to be used, it must be prefixed with ./ in order to avoid confusion with a nickname. Available as of PHP 7.3.0 and cURL 7.52.0.

CURLOPT_PROXY_SSLCERTTYPE (int)

A string with the format of the 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. Available as of PHP 7.3.0 and cURL 7.52.0.

CURLOPT_PROXY_SSLCERT_BLOB (int)

A string with the SSL proxy client certificate. Available as of PHP 8.1.0 and cURL 7.71.0.

CURLOPT_PROXY_SSLKEY (int)

A string with the file name of the private key used for connecting to the HTTPS proxy. The default format is PEM and can be changed with CURLOPT_PROXY_SSLKEYTYPE. (iOS and Mac OS X only) This option is ignored if cURL was built against Secure Transport. Available if built with TLS enabled. Available as of PHP 7.3.0 and cURL 7.52.0.

CURLOPT_PROXY_SSLKEYTYPE (int)

A string with the format of the private key. Supported formats are: PEM, DER, ENG. Available as of PHP 7.3.0 and cURL 7.52.0.

CURLOPT_PROXY_SSLKEY_BLOB (int)

A string with the private key for connecting to the HTTPS proxy. Available as of PHP 8.1.0 and cURL 7.71.0.

CURLOPT_PROXY_SSLVERSION (int)

Set the preferred HTTPS proxy TLS version to one of the CURL_SSLVERSION_* constants. Defaults to CURL_SSLVERSION_DEFAULT.

警告

最好不要设置此选项并使用默认的 CURL_SSLVERSION_DEFAULT,这将尝试找出远程 SSL 协议版本。

Available as of PHP 7.3.0 and cURL 7.52.0.

CURLOPT_PROXY_SSL_CIPHER_LIST (int)

A string with a colon-separated list of ciphers to use for the connection to the HTTPS proxy. When used with OpenSSL commas and spaces are also acceptable as separators, and !, - and + can be used as operators. Available as of PHP 7.3.0 and cURL 7.52.0.

CURLOPT_PROXY_SSL_OPTIONS (int)

Set proxy SSL behavior options, which is a bitmask of the CURLSSLOPT_* constants. Available as of PHP 7.3.0 and cURL 7.52.0.

CURLOPT_PROXY_SSL_VERIFYHOST (int)

设置为 2 以根据代理名称验证 HTTPS 代理的证书名称字段。设置为 0 时,无论证书中使用的名称如何,连接都会成功。谨慎使用该能力!在 cURL 7.28.0 及更早版本中将其设置为 1 作为调试选项。在 cURL 7.28.1 到 7.65.3 中设置为 1,则返回 CURLE_BAD_FUNCTION_ARGUMENT。自 cURL 7.66.0 起,视 12 为相同的值。默认为 2。在生产环境中,此选项的值应保持为 2。从 PHP 7.3.0 和 cURL 7.52.0 开始可用。

CURLOPT_PROXY_SSL_VERIFYPEER (int)

false 时阻止 CURL 验证对等证书(peer's certificate)。可以使用 CURLOPT_CAINFO 选项指定要验证的备用证书,或者使用 CURLOPT_CAPATH 选项指定证书目录。设置为 false 时,无论如何验证对等证书都会成功。默认为 true。自 PHP 7.3.0 和 cURL 7.52.0 起可用。

CURLOPT_PROXY_TLS13_CIPHERS (int)

A string with a colon-separated list of ciphers to use for the connection to the TLS 1.3 connection to a proxy. This option is currently used only when cURL is built to use OpenSSL 1.1.1 or later. When using a different SSL backend the TLS 1.3 cipher suites can be set with the CURLOPT_PROXY_SSL_CIPHER_LIST option. Available as of PHP 7.3.0 and cURL 7.61.0.

CURLOPT_PROXY_TLSAUTH_PASSWORD (int)

A string with the password to use for the TLS authentication method specified with the CURLOPT_PROXY_TLSAUTH_TYPE option. Requires that the CURLOPT_PROXY_TLSAUTH_USERNAME option to also be set. Available as of PHP 7.3.0 and cURL 7.52.0.

CURLOPT_PROXY_TLSAUTH_TYPE (int)

The method of the TLS authentication used for the HTTPS connection. Supported method is SRP.

注意:

Secure Remote Password (SRP) authentication for TLS provides mutual authentication if both sides have a shared secret. To use TLS-SRP, the CURLOPT_PROXY_TLSAUTH_USERNAME and CURLOPT_PROXY_TLSAUTH_PASSWORD options must also be set.

Available as of PHP 7.3.0 and cURL 7.52.0.

CURLOPT_PROXY_TLSAUTH_USERNAME (int)

The username to use for the HTTPS proxy TLS authentication method specified with the CURLOPT_PROXY_TLSAUTH_TYPE option. Requires that the CURLOPT_PROXY_TLSAUTH_PASSWORD option to also be set. Available as of PHP 7.3.0 and cURL 7.52.0.

CURLOPT_PROXY_TRANSFER_MODE (int)

Set to 1 to set the transfer mode (binary or ASCII) for FTP transfers done via an HTTP proxy, by appending type=a or type=i to the URL. Without this setting or it being set to 0, CURLOPT_TRANSFERTEXT has no effect when doing FTP via a proxy. Defaults to 0. Available as of cURL 7.18.0.

CURLOPT_PUT (int)

true 时允许 HTTP 发送文件。要被 PUT 的文件必须在 CURLOPT_READDATACURLOPT_INFILESIZE 中设置。自 cURL 7.1.0 起可用并于 cURL 7.12.1 弃用。

CURLOPT_QUICK_EXIT (int)

Set to true for cURL to skip cleanup of resources when recovering from a timeout. This allows for a swift termination of the cURL process at the expense of a possible leak of associated resources. Available as of PHP 8.3.0 and cURL 7.87.0.

CURLOPT_QUOTE (int)

An array of FTP command strings to execute on the server prior to the FTP request. Available as of cURL 7.1.0.

CURLOPT_RANDOM_FILE (int)

A string with a filename to be used to seed the random number generator for SSL. Available as of cURL 7.7.0 and deprecated as of cURL 7.84.0.

CURLOPT_RANGE (int)

A string with the range(s) of data to retrieve in the format X-Y where X or Y are optional. HTTP transfers also support several intervals, separated with commas in the format X-Y,N-M. Set to null to disable requesting a byte range. Available as of cURL 7.1.0.

CURLOPT_READDATA (int)

Sets a file pointer resource that will be used by the file read function set with CURLOPT_READFUNCTION. Available as of cURL 7.9.7.

CURLOPT_READFUNCTION (int)

A callable with the following signature:

callback(resource $curlHandle, resource $streamResource, int $maxAmountOfDataToRead): string
curlHandle
The cURL handle.
streamResource
Stream resource provided to cURL through the option CURLOPT_READDATA.
maxAmountOfDataToRead
The maximum amount of data to be read.
The callback should 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 EOF. Available as of cURL 7.1.0.

CURLOPT_REDIR_PROTOCOLS (int)

Bitmask of CURLPROTO_* values which limit what protocols cURL may use in a transfer that it follows to in a redirect when CURLOPT_FOLLOWLOCATION is enabled. This allows limiting specific transfers to only be allowed to use a subset of protocols in redirections. As of cURL 7.19.4, by default cURL will allow all protocols except for FILE and SCP. Prior to cURL 7.19.4, cURL would unconditionally follow to all supported protocols. See also CURLOPT_PROTOCOLS for protocol constant values. Available as of cURL 7.19.4 and deprecated as of cURL 7.85.0.

CURLOPT_REDIR_PROTOCOLS_STR (int)

Set to a string with a comma separated list of case insensitive protocol names (URL schemes) to allow to follow to in a redirect when CURLOPT_FOLLOWLOCATION is enabled. Set to ALL to enable all protocols. As of cURL 7.65.2 it defaults to FTP, FTPS, HTTP and HTTPS. From cURL 7.40.0 to 7.65.1, this defaults to all protocols except FILE, SCP, SMB and SMBS. Prior to cURL 7.40.0, this defaults to all protocols except FILE and SCP. Available protocols are: DICT, FILE, FTP, FTPS, GOPHER, GOPHERS, HTTP, HTTPS, IMAP, IMAPS, LDAP, LDAPS, MQTT, POP3, POP3S, RTMP, RTMPE, RTMPS, RTMPT, RTMPTE, RTMPTS, RTSP, SCP, SFTP, SMB, SMBS, SMTP, SMTPS, TELNET, TFTP, WS, WSS. Available as of PHP 8.3.0 and cURL 7.85.0.

CURLOPT_REFERER (int)

A string with the contents of the Referer: header to be used in a HTTP request. Available as of cURL 7.1.0.

CURLOPT_REQUEST_TARGET (int)

A string to use in the upcoming request instead of the path as extracted from the URL. Available as of PHP 7.3.0 and cURL 7.55.0.

CURLOPT_RESOLVE (int)

Provide an array of colon-separated strings with custom addresses for specific host and port pairs in the following format: array( "example.com:80:127.0.0.1", "example2.com:443:127.0.0.2", ) Available as of cURL 7.21.3.

CURLOPT_RESUME_FROM (int)

恢复传输时,传递字节为单位的偏移量(以字节为单位)。此选项接受任何可以转换为有效 int 的值。自 cURL 7.1.0 起可用。

CURLOPT_RETURNTRANSFER (int)

truecurl_exec() 获取的信息以 string 返回,而不是直接输出。

CURLOPT_RTSP_CLIENT_CSEQ (int)

Set an int with the CSEQ number to issue for the next RTSP request. Useful if the application is resuming a previously broken connection. The CSEQ increments from this new number henceforth. Defaults to 0. Available as of cURL 7.20.0.

CURLOPT_RTSP_REQUEST (int)

Sets the kind of RTSP request to make. Must be one of the CURL_RTSPREQ_* constants. Available as of cURL 7.20.0.

CURLOPT_RTSP_SERVER_CSEQ (int)

Set an int with the CSEQ number to expect for the next RTSP Server to Client request. This feature (listening for Server requests) is unimplemented. Defaults to 0. Available as of cURL 7.20.0.

CURLOPT_RTSP_SESSION_ID (int)

Set a string with the value of the current RTSP Session ID for the handle. Once this value is set to any non-null value, cURL returns CURLE_RTSP_SESSION_ERROR if the ID received from the server does not match. If set to null, cURL automatically sets the ID the first time the server sets it in a response. Defaults to null Available as of cURL 7.20.0.

CURLOPT_RTSP_STREAM_URI (int)

Sets a string with the stream URI to operate on. If not set, cURL defaults to operating on generic server options by passing * in the place of the RTSP Stream URI. When working with RTSP, CURLOPT_RTSP_STREAM_URI indicates what URL to send to the server in the request header while the CURLOPT_URL indicates where to make the connection to. Available as of cURL 7.20.0.

CURLOPT_RTSP_TRANSPORT (int)

Set the Transport: header for this RTSP session. Available as of cURL 7.20.0.

CURLOPT_SAFE_UPLOAD (int)

始终为 true,在 CURLOPT_POSTFIELDS 中禁用了对上传文件的 @ 前缀的支持,这意味着以 @ 开头的值可以作为字段安全地传递。上传可使用 CURLFile 替代。

CURLOPT_SASL_AUTHZID (int)

The authorization identity (authzid) string for the transfer. Only applicable to the PLAIN SASL authentication mechanism where it is optional. When not specified, only the authentication identity (authcid) as specified by the username will be sent to the server, along with the password. The server will derive the authzid from the authcid when not provided, which it will then use internally. Available as of PHP 8.2.0 and cURL 7.66.0.

CURLOPT_SASL_IR (int)

true 时开启,收到首包(first packet)后发送初始的响应(initial response)。自 PHP 7.0.7 和 cURL 7.31.0 起可用。

CURLOPT_SERVICE_NAME (int)

A string with the authentication service name. Available as of PHP 7.0.7 and cURL 7.43.0.

CURLOPT_SHARE (int)

curl_share_init() 的结果。使 cURL 可以使用共享句柄中的数据。自 cURL 7.10 起可用。

CURLOPT_SOCKS5_AUTH (int)

用于 SOCKS5 验证方法。选项是: CURLAUTH_BASIC, CURLAUTH_GSSAPI, CURLAUTH_NONE。当设置了多种方法时,cURL 将轮询服务器以查看其支持哪些方法并选择最佳方法。默认为 CURLAUTH_BASIC|CURLAUTH_GSSAPI。使用 CURLOPT_PROXYUSERPWD 选项设置真实的用户名和密码。自 PHP 7.3.0 和 cURL 7.55.0 起可用。

CURLOPT_SOCKS5_GSSAPI_NEC (int)

Set to 1 to enable and 0 to disable the unprotected exchange of the protection mode negotiation as part of the GSSAPI negotiation. Available as of cURL 7.19.4.

CURLOPT_SOCKS5_GSSAPI_SERVICE (int)

Set a string holding the name of the SOCKS5 service. Defaults to rcmd. Available as of cURL 7.19.4 and deprecated as of cURL 7.49.0. Use CURLOPT_PROXY_SERVICE_NAME instead.

CURLOPT_SSH_AUTH_TYPES (int)

A bitmask consisting of one or more of the following constants: CURLSSH_AUTH_PUBLICKEY, CURLSSH_AUTH_PASSWORD, CURLSSH_AUTH_HOST, CURLSSH_AUTH_KEYBOARD, CURLSSH_AUTH_AGENT, CURLSSH_AUTH_ANY. Defaults to CURLSSH_AUTH_ANY. Available as of cURL 7.16.1.

CURLOPT_SSH_COMPRESSION (int)

true to enable, false to disable built-in SSH compression. Note that the server can disregard this request. Defaults to false. Available as of PHP 7.3.0 and cURL 7.56.0.

CURLOPT_SSH_HOSTKEYFUNCTION (int)

A callable that will be called when SSH host key verification is needed. The callback must have the following signature:

callback(
    resource $curlHandle,
    int $keyType,
    string $key,
    int $keyLength
): int
curlHandle
The cURL handle.
keyType
One of the CURLKHTYPE_* key types.
key
The key to check.
keyLength
The length of the key in bytes.
This callback overrides CURLOPT_SSH_KNOWNHOSTS. Available as of PHP 8.3.0 and cURL 7.84.0.

CURLOPT_SSH_HOST_PUBLIC_KEY_MD5 (int)

A string containing 32 hexadecimal digits which should contain the MD5 checksum of the remote host's public key, and cURL will reject the connection to the host unless the md5sums match. This option is only for SCP and SFTP transfers. Available as of cURL 7.17.1.

CURLOPT_SSH_HOST_PUBLIC_KEY_SHA256 (int)

A string with the base64-encoded SHA256 hash of the remote host's public key. The transfer will fail if the given hash does not match the hash the remote host provides. Available as of PHP 8.2.0 and cURL 7.80.0.

CURLOPT_SSH_KNOWNHOSTS (int)

Set to the filename of the known_host file to use which should use the OpenSSH file format as supported by libssh2. Available as of cURL 7.19.6.

CURLOPT_SSH_PRIVATE_KEYFILE (int)

The file name for a private key. If not used, cURL 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 CURLOPT_KEYPASSWD. Available as of cURL 7.16.1.

CURLOPT_SSH_PUBLIC_KEYFILE (int)

The file name for a public key. If not used, cURL 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. Available as of cURL 7.16.1.

CURLOPT_SSLCERT (int)

The name of a file containing a PEM formatted certificate. Available as of cURL 7.1.0.

CURLOPT_SSLCERTPASSWD (int)

The password required to use the CURLOPT_SSLCERT certificate. Available as of cURL 7.1.0 and deprecated as of cURL 7.17.0.

CURLOPT_SSLCERTTYPE (int)

A string with the format of the certificate. Supported formats are: PEM, DER, ENG, P12. P12 (for PKCS#12-encoded files) is available as of OpenSSL 0.9.3. Defaults to PEM. Available as of cURL 7.9.3.

CURLOPT_SSLCERT_BLOB (int)

A string with the SSL client certificate. Available as of PHP 8.1.0 and cURL 7.71.0.

CURLOPT_SSLENGINE (int)

The string identifier for the crypto engine of the private SSL key specified in CURLOPT_SSLKEY. Available as of cURL 7.9.3.

CURLOPT_SSLENGINE_DEFAULT (int)

The string identifier for the crypto engine used for asymmetric crypto operations. Available as of cURL 7.9.3.

CURLOPT_SSLKEY (int)

The name of a file containing a private SSL key. Available as of cURL 7.9.3.

CURLOPT_SSLKEYPASSWD (int)

The secret password needed to use the private SSL key specified in CURLOPT_SSLKEY.

注意:

Since this option contains a sensitive password, remember to keep the PHP script it is contained within safe.

Available as of cURL 7.9.3 and deprecated as of cURL 7.17.0.

CURLOPT_SSLKEYTYPE (int)

The key type of the private SSL key specified in CURLOPT_SSLKEY. Supported key types are: PEM, DER, ENG. Defaults to PEM. Available as of cURL 7.9.3.

CURLOPT_SSLKEY_BLOB (int)

A string private key for client cert. Available as of PHP 8.1.0 and cURL 7.71.0.

CURLOPT_SSLVERSION (int)

One of the CURL_SSLVERSION_* constants.

警告

最好不要设置此选项并使用默认值。因为考虑到 SSLv2 和 SSLv3 中已知的漏洞,将其设置为 CURL_SSLVERSION_SSLv2CURL_SSLVERSION_SSLv3 非常危险。

Defaults to CURL_SSLVERSION_DEFAULT. Available as of cURL 7.1.0.

CURLOPT_SSL_CIPHER_LIST (int)

A colon-separated string of ciphers to use for the TLS 1.2 (1.1, 1.0) connection. Available as of cURL 7.9.

CURLOPT_SSL_EC_CURVES (int)

A colon delimited list of elliptic curve algorithms. For example, X25519:P-521 is a valid list of two elliptic curves. This option defines the client's key exchange algorithms in the SSL handshake, if the SSL backend cURL is built to use supports it. Available as of PHP 8.2.0 and cURL 7.73.0.

CURLOPT_SSL_ENABLE_ALPN (int)

false 时禁用 SSL 握手中的 ALPN(如果 SSL 后端的 cURL 内建支持)用于协商到 http2。自 PHP 7.0.7 和 cURL 7.36.0 起可用。

CURLOPT_SSL_ENABLE_NPN (int)

false 时禁用 SSL 握手中的 NPN(如果 SSL 后端的 libcurl 内建支持),用于协商到 http2。自 PHP 7.0.7 和 cURL 7.36.0 起可用,并且自 cURL 7.86.0 起弃用。

CURLOPT_SSL_FALSESTART (int)

true 表示启用,false 表示禁用 TLS 错误启动,这是 TLS 客户端在验证服务器 Finished 消息之前开始发送应用程序数据的模式。自 PHP 7.0.7 和 cURL 7.42.0 起可用。

CURLOPT_SSL_OPTIONS (int)

Set SSL behavior options, which is a bitmask of the CURLSSLOPT_* constants. Defaults to none of the bits being set. Available as of PHP 7.0.7. and cURL 7.25.0.

CURLOPT_SSL_SESSIONID_CACHE (int)

Set to 0 to disable and 1 to enable SSL session-ID caching. By default all transfers are done using the cache enabled. Available as of cURL 7.16.0.

CURLOPT_SSL_VERIFYHOST (int)

2 时验证 SSL 对等证书中的公用名称字段或主题备用名称(Subject Alternate Name,简称 SNA)字段是否与提供的主机名匹配。0 时不检查名称。不应使用 1。在生产环境中,此选项的值应保持为 2(默认值)。自 cURL 7.8.1 起可用。

CURLOPT_SSL_VERIFYPEER (int)

false 时禁止 cURL 验证对等证书(peer's certificate)。要验证的交换证书可以在 CURLOPT_CAINFO 选项中设置,或在 CURLOPT_CAPATH 中设置证书目录。自 cURL 7.10 起默认为 true。自 cURL 7.10 起安装默认的 CA 证书包。自 cURL 7.4.2 起可用。

CURLOPT_SSL_VERIFYSTATUS (int)

true 时启用或者 false 时禁用验证证书状态。自 PHP 7.0.7 和 cURL 7.41.0 起可用。

CURLOPT_STDERR (int)

Accepts a file handle resource pointing to an alternative location to output errors to instead of STDERR. Available as of cURL 7.1.0.

CURLOPT_STREAM_WEIGHT (int)

设置 stream weight 数值(1256 之间的数字)。自 PHP 7.0.7 和 cURL 7.46.0 起可用。

CURLOPT_SUPPRESS_CONNECT_HEADERS (int)

true to suppress proxy CONNECT response headers from the user callback functions CURLOPT_HEADERFUNCTION and CURLOPT_WRITEFUNCTION, when CURLOPT_HTTPPROXYTUNNEL is used and a CONNECT request is made. Defaults to false. Available as of PHP 7.3.0 and cURL 7.54.0.

CURLOPT_TCP_FASTOPEN (int)

true 时启用或者 false 时禁用 TCP Fast Open。自 PHP 7.0.7 和 cURL 7.49.0 起可用。

CURLOPT_TCP_KEEPALIVE (int)

如果设置为 1,将发送 TCP keepalive 探针。这些探针的延迟和频率可以通过 CURLOPT_TCP_KEEPIDLECURLOPT_TCP_KEEPINTVL 选项来控制,前提是操作系统支持它们。如果设置为 0(默认值),将禁用 keepalive 探针。 The maximum number of probes can be set with the CURLOPT_TCP_KEEPCNT option. Available as of cURL 7.25.0.

CURLOPT_TCP_KEEPIDLE (int)

设置延迟秒数,如果启用了 CURLOPT_TCP_KEEPALIVE,操作系统将在连接空闲时等待,然后再发送 keepalive 探针。并非所有操作系统都支持此选项。默认值为 60。自 cURL 7.25.0 起可用。

CURLOPT_TCP_KEEPINTVL (int)

设置间隔(以秒为单位),如果启用了 CURLOPT_TCP_KEEPALIVE,操作系统将在发送 keepalive 探针之间等待。并非所有操作系统都支持此选项。默认值为 60。自 cURL 7.25.0 起可用。

CURLOPT_TCP_KEEPCNT (int)

Sets the maximum number of TCP keep-alive probes. The default is 9. Available as of PHP 8.4.0 and cURL 8.9.0.

CURLOPT_TCP_NODELAY (int)

true 时禁用 TCP 的 Nagle 算法,就是减少网络上的小数据包数量。默认是 true。自 cURL 7.11.2 起可用。

CURLOPT_TELNETOPTIONS (int)

Set an array of strings to pass to the telnet negotiations. The variables should be in the format >option=value<. cURL supports the options TTYPE, XDISPLOC and NEW_ENV. Available as of cURL 7.7.0.

CURLOPT_TFTP_BLKSIZE (int)

Set the blocksize to use for TFTP data transmission. Valid range is 8-65464 bytes. The default of 512 bytes is used if this option is not specified. The specified block size is only used if supported by the remote server. If the server does not return an option acknowledgment or returns an option acknowledgment with no block size, the default of 512 bytes is used. Available as of cURL 7.19.4.

CURLOPT_TFTP_NO_OPTIONS (int)

true 时不发送 TFTP 的 options 请求。默认为 false。自 PHP 7.0.7 和 cURL 7.48.0 起可用。

CURLOPT_TIMECONDITION (int)

设置如何对待 CURLOPT_TIMEVALUE。使用 CURL_TIMECOND_IFMODSINCE,仅在页面 CURLOPT_TIMEVALUE 之后修改,才返回页面。没有修改则返回 304 Not Modified header,假设设置了 CURLOPT_HEADERtrueCURL_TIMECOND_IFUNMODSINCE 则起相反的效果。使用 CURL_TIMECOND_NONE 忽略 CURLOPT_TIMEVALUE 并始终返回页面。默认为 CURL_TIMECOND_IFMODSINCE。在 cURL 7.46.0 之前,默认值为 CURL_TIMECOND_IFMODSINCE。自 cURL 7.1.0 起可用。

CURLOPT_TIMEOUT (int)

允许 cURL 函数执行的最长秒数。 Defaults to 0, meaning that functions never time out during transfer. Available as of cURL 7.1.0.

CURLOPT_TIMEOUT_MS (int)

允许 cURL 允许执行的最长毫秒数。如果 cURL 编译时使用系统标准的名称解析器( standard system name resolver),那部分的连接仍旧使用以秒计的超时解决方案,最小超时时间还是一秒钟。 Defaults to 0, meaning that functions never time out during transfer. Available as of cURL 7.16.2.

CURLOPT_TIMEVALUE (int)

秒数,从 1970 年 1 月 1 日开始。这个时间将由 CURLOPT_TIMECONDITION 使用。默认 0。自 cURL 7.1.0 起可用。

CURLOPT_TIMEVALUE_LARGE (int)

The time in seconds since January 1st, 1970. The time will be used by CURLOPT_TIMECONDITION. Defaults to zero. The difference between this option and CURLOPT_TIMEVALUE 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. Available as of PHP 7.3.0 and cURL 7.59.0.

CURLOPT_TLS13_CIPHERS (int)

A string with a colon-separated list of ciphers to use for the connection to the TLS 1.3 connection. This option is currently used only when cURL is built to use OpenSSL 1.1.1 or later. When using a different SSL backend the TLS 1.3 cipher suites can be set with the CURLOPT_SSL_CIPHER_LIST option. Available as of PHP 7.3.0 and cURL 7.61.0.

CURLOPT_TLSAUTH_PASSWORD (int)

Set a password to use for the TLS authentication method specified with the CURLOPT_TLSAUTH_TYPE option. Requires that the CURLOPT_TLSAUTH_USERNAME option also be set. This feature relies on TLS SRP which does not work with TLS 1.3. Available as of cURL 7.21.4.

CURLOPT_TLSAUTH_TYPE (int)

Set a string with the method of the TLS authentication. Supported method is SRP (TLS Secure Remote Password authentication). Available as of cURL 7.21.4.

CURLOPT_TLSAUTH_USERNAME (int)

Set a string with the username to use for the TLS authentication method specified with the CURLOPT_TLSAUTH_TYPE option. Requires that the CURLOPT_TLSAUTH_PASSWORD option also be set. This feature relies on TLS SRP which does not work with TLS 1.3. Available as of cURL 7.21.4.

CURLOPT_TRANSFER_ENCODING (int)

Set to 1 to enable and 0 to disable requesting compressed Transfer Encoding in the outgoing HTTP request. If the server responds with a compressed Transfer Encoding, cURL will automatically uncompress it on reception. Defaults to 0. Available as of cURL 7.21.6.

CURLOPT_TRANSFERTEXT (int)

true 时 FTP 传输使用 ASCII 模式。对于 LDAP,会检索纯文本信息而非 HTML。在 Windows 系统上,系统不会把 STDOUT 设置成二进制模式。默认是 false。自 cURL 7.1.1 起可用。

CURLOPT_UNIX_SOCKET_PATH (int)

Enables the use of Unix domain sockets as connection endpoint and sets the path to the given string. Set to null to disable. Defaults to null. Available as of PHP 7.0.7 and cURL 7.40.0.

CURLOPT_UNRESTRICTED_AUTH (int)

true 时在使用 CURLOPT_FOLLOWLOCATION 重定向 header 中的多个 location 时继续发送用户名和密码信息,哪怕主机名已改变。默认为 false。自 cURL 7.10.4 起可用。

CURLOPT_UPKEEP_INTERVAL_MS (int)

Some protocols have "connection upkeep" mechanisms. These mechanisms usually send some traffic on existing connections in order to keep them alive. This option defines the connection upkeep interval. Currently, the only protocol with a connection upkeep mechanism is HTTP/2. When the connection upkeep interval is exceeded, an HTTP/2 PING frame is sent on the connection. Defaults to CURL_UPKEEP_INTERVAL_DEFAULT which is currently 60 seconds. Available as of PHP 8.2.0 and cURL 7.62.0.

CURLOPT_UPLOAD (int)

true 时准备执行上传。默认 false。自 cURL 7.1.0 起可用。

CURLOPT_UPLOAD_BUFFERSIZE (int)

Preferred buffer size in bytes for the cURL upload buffer. The upload buffer size by default is 64 kilobytes. The maximum buffer size allowed to be set is 2 megabytes. The minimum buffer size allowed to be set is 16 kilobytes. Available as of PHP 8.2.0 and cURL 7.62.0.

CURLOPT_URL (int)

The URL to fetch. This can also be set when initializing a session with curl_init(). Available as of cURL 7.1.0.

CURLOPT_USE_SSL (int)

Sets the desired level of SSL/TLS for the transfer when using FTP, SMTP, POP3, IMAP, etc. These are all protocols that start out plain text and get "upgraded" to SSL using the STARTTLS command. Set to one of the CURLUSESSL_* constants. Available as of cURL 7.17.0.

CURLOPT_USERAGENT (int)

The contents of the User-Agent: header to be used in a HTTP request. Available as of cURL 7.1.0.

CURLOPT_USERNAME (int)

The user name to use in authentication. Available as of cURL 7.19.1.

CURLOPT_USERPWD (int)

A username and password formatted as [username]:[password] to use for the connection. Available as cURL 7.1.0.

CURLOPT_VERBOSE (int)

true 时输出所有的信息,写入到 STDERR,或在 CURLOPT_STDERR 中指定的文件。默认 false。自 cURL 7.1.0 起可用。

CURLOPT_WILDCARDMATCH (int)

Set to 1 to transfer multiple files according to a filename pattern. The pattern can be specified as part of the CURLOPT_URL option, using an fnmatch-like pattern (Shell Pattern Matching) in the last part of URL (filename). Available as of cURL 7.21.0.

CURLOPT_WRITEFUNCTION (int)

A callable with the following signature:

callback(resource $curlHandle, string $data): int
curlHandle
The cURL handle.
data
The data to be written.
The data must be saved by the callback and the callback must return the exact number of bytes written or the transfer will be aborted with an error. Available as of cURL 7.1.0.

CURLOPT_WRITEHEADER (int)

接受文件句柄 resource,将传输的 header 部分写入该文件。自 cURL 7.1.0 起可用。

CURLOPT_WS_OPTIONS (int)

接受位掩码设置 WebSocket 行为选项。唯一可用的选项是 CURLWS_RAW_MODE。默认为 0。自 PHP 8.3.0 和 cURL 7.86.0 起可用。

CURLOPT_XFERINFOFUNCTION (int)

具有以下签名的 callable

callback(
    resource $curlHandle,
    int $bytesToDownload,
    int $bytesDownloaded,
    int $bytesToUpload,
    int $bytesUploaded
): int
curlHandle
cURL 句柄。
bytesToDownload
本次传输预计下载的总字节数。
bytesDownloaded
迄今已下载的字节数。
bytesToUpload
本次传输预计上传的总字节数。
bytesUploaded
迄今已上传的字节数。
返回 1 可中止传输并设置 CURLE_ABORTED_BY_CALLBACK 错误。自 PHP 8.2.0 和 cURL 7.32.0 起可用。

CURLOPT_SERVER_RESPONSE_TIMEOUT (int)

cURL 将等待来自 FTPSFTPIMAPSCPSMTPPOP3 服务器响应的超时秒数。此选项取代了现有的 CURLOPT_FTP_RESPONSE_TIMEOUT 选项,该选项在 cURL 7.85.0 中已弃用。自 PHP 8.4.0 起可用。

CURLOPT_XOAUTH2_BEARER (int)

指定 OAuth 2.0 访问 token。设置为 null 以禁用。默认为 null。自 PHP 7.0.7 和 cURL 7.33.0 起可用。

CURLOPT_PREREQFUNCTION (int)

具有以下签名的 callable,在建立连接之后但在发送请求负载(例如,HTTP 连接的 GET/POST/DELETE 请求)之前调用,可用于根据源和目标 IP 地址和端口号中止或允许连接:

callback(
    CurlHandle $curlHandle,
    string $destination_ip,
    string $local_ip,
    int $destination_port,
    int $local_port
): int
curlHandle
cURL 句柄。
destination_ip
使用此连接建立的远程服务器的主 IP。对于 FTP,这是控制连接的 IP。IPv6 地址不带括号。
local_ip
此连接的原始 IP。IPv6 地址不带括号。
destination_port
使用此连接建立的远程服务器上的主端口号。对于 FTP,这是控制连接的端口。根据协议的不同,这可能是 TCPUDP 端口号。
local_port
此连接的发起端口号。根据协议的不同,这可能是 TCPUDP 端口号。
返回 CURL_PREREQFUNC_OK 以允许请求,或返回 CURL_PREREQFUNC_ABORT 以中止传输。自 PHP 8.4.0 和 cURL 7.80.0 起可用。

CURLOPT_DEBUGFUNCTION (int)

自 PHP 8.4.0 起可用。此选项需要启用 CURLOPT_VERBOSE 选项。callable 来替换标准 cURL 详细输出。此回调在请求的各个阶段使用详细调试信息进行调用。回调应与以下签名匹配:

callback(CurlHandle $curlHandle, int $type, string $data): void
curlHandle
cURL 句柄。
type
下列常量之一表示 data 值的类型:
常量 描述
CURLINFO_TEXT (int) 信息文本。
CURLINFO_HEADER_IN (int) 从对等方接受的 header(或者类似 header)值。
CURLINFO_HEADER_OUT (int) header(或者类 header) 数据发送给对等方。
CURLINFO_DATA_IN (int) 从对等方接收到的未处理协议数据。即使数据已编码或压缩,也不会向此回调提供解码或解压缩后的数据。
CURLINFO_DATA_OUT (int) 发送给对等方的协议数据。
CURLINFO_SSL_DATA_IN (int) 从对等方接收的 SSL/TLS(二进制)数据。
CURLINFO_SSL_DATA_OUT (int) 发送给对等方的 SSL/TLS(二进制)数据。
data
type 参数表示的类型的详细调试数据。

curl_share_setopt()
常量 描述
CURL_LOCK_DATA_CONNECT (int) 共享/取消共享连接缓存。自 PHP 7.3.0 和 cURL 7.10.0 起可用。
共享/取消共享 cookie 数据。自 cURL 7.10.3 起可用。
CURL_LOCK_DATA_DNS (int) 共享/取消共享 DNS 缓存。注意,当使用 cURL 多句柄时,默认情况下添加到同一个多句柄的所有句柄将共享 DNS 缓存。自 cURL 7.10.3 起可用。
CURL_LOCK_DATA_PSL (int) 共享/取消共享公共后缀列表。自 PHP 7.3.0 和 cURL 7.61.0 起可用。
CURL_LOCK_DATA_SSL_SESSION (int) 共享/取消共享 SSL 的 session ID,从而在重新连接到同一服务器时减少 SSL 握手所需的时间。请注意,默认情况下在同一句柄内会重用 SSL 会话 ID。自 cURL 7.10.3 起可用。
CURLSHOPT_NONE (int) 自 cURL 7.10.3 起可用。
CURLSHOPT_SHARE (int) 指定应共享的数据类型。自 cURL 7.10.3 起可用。
CURLSHOPT_UNSHARE (int) 指定不应共享的数据类型。自 cURL 7.10.3 起可用。
curl_getinfo()
常量 描述
CURLINFO_APPCONNECT_TIME (int) 从建立 SSL/SSH 连接/握手起,到与远程主机完成连接所花费的秒数
CURLINFO_APPCONNECT_TIME_T (int) 从建立 SSL/SSH 连接/握手起,到与远程主机完成连接所花费的微秒数。自 PHP 7.3.0 和 cURL 7.61.0 起可用
CURLINFO_CAINFO (int) 默认内置 CA 证书位置。自 PHP 8.3.0 和 cURL 7.84.0 起可用
CURLINFO_CAPATH (int) 默认内置 CA 证书路径。自 PHP 8.3.0 和 cURL 7.84.0 起可用
CURLINFO_CERTINFO (int) TLS 证书链
CURLINFO_CONDITION_UNMET (int) 不满足时间条件的信息
CURLINFO_CONNECT_TIME (int) 建立连接所花费的秒数
CURLINFO_CONNECT_TIME_T (int) 从开始到完成连接远程主机(或代理)所花费的总微秒数。自 PHP 7.3.0 和 cURL 7.61.0 起可用
CURLINFO_CONTENT_LENGTH_DOWNLOAD (int) 从 "Content-Length:" 字段读取的下载内容长度 (单位:字节)
CURLINFO_CONTENT_LENGTH_DOWNLOAD_T (int) 下载的 content-length。该值从 "Content-Length:" 字段读取。如果无法得知大小,则为 -1。自 PHP 7.3.0 和 cURL 7.55.0 起可用
CURLINFO_CONTENT_LENGTH_UPLOAD (int) 指定上传大小
CURLINFO_CONTENT_LENGTH_UPLOAD_T (int) 指定上传大小。如果大小未知,则为 -1。自 PHP 7.3.0 和 cURL 7.55.0 起可用
CURLINFO_CONTENT_TYPE (int) 已请求的文档的 Content-Type。NULL 表示服务器未发送有效的 Content-Type header。
CURLINFO_COOKIELIST (int) 所以已知的 cookie
CURLINFO_EFFECTIVE_METHOD (int) 获取最后使用的 HTTP 方法。
CURLINFO_EFFECTIVE_URL (int) 最后有效的 URL
CURLINFO_FILETIME (int) 启用 CURLOPT_FILETIME 时,检索文档的远程时间;如果返回 -1,则表示文档的时间未知。
CURLINFO_FILETIME_T (int) 检索文档的远程时间 (Unix 时间戳),它是 CURLINFO_FILETIME 的替代方案,允许 32 位长整型的系统提取超出 32 位时间戳范围的日期。自 PHP 7.3.0 和 cURL 7.59.0 起可用
CURLINFO_FTP_ENTRY_PATH (int) FTP 服务器中的条目路径
CURLINFO_HEADER_OUT (int) 已发送的请求字符串。如果要生效,需要调用 curl_setopt() 函数将 CURLINFO_HEADER_OUT 选项添加到句柄中
CURLINFO_HEADER_SIZE (int) 所有检索到的 header 总大小
CURLINFO_HTTPAUTH_AVAIL (int) 之前的响应中,用位掩码表示对应可用的身份验证方法
CURLINFO_HTTP_CODE (int) 最后的响应码。自 cURL 7.10.8 起,这是 CURLINFO_RESPONSE_CODE 的遗留别名。
CURLINFO_HTTP_CONNECTCODE (int) CONNECT 响应码
CURLINFO_HTTP_VERSION (int) 上次 HTTP 连接中使用的版本。返回值将是定义的 CURL_HTTP_VERSION_* 常量中的一个,或者如果无法确定版本,则返回 0。自 PHP 7.3.0 和 cURL 7.50.0 起可用
CURLINFO_LASTONE (int) libcurl 中底层 CURLINFO 枚举中的最后一个枚举值。
CURLINFO_LOCAL_IP (int) 最近连接的本地 (源) IP 地址
CURLINFO_LOCAL_PORT (int) 最近连接的本地 (源) 端口
CURLINFO_NAMELOOKUP_TIME (int) 域名解析完成所需秒数
CURLINFO_NAMELOOKUP_TIME_T (int) 域名解析完成所需的微秒数。自 PHP 7.3.0 和 cURL 7.61.0 起可用
CURLINFO_NUM_CONNECTS (int) 为完成上次传输,cURL 创建的连接数
CURLINFO_OS_ERRNO (int) 连接失败的错误码 (Errno)。该数字与操作系统和系统相关。
CURLINFO_PRETRANSFER_TIME (int) 从开始到文件传输开始之前的秒数
CURLINFO_PRETRANSFER_TIME_T (int) 从开始到文件传输即将开始为止所花费的微秒数。自 PHP 7.3.0 和 cURL 7.61.0 起可用
CURLINFO_PRIMARY_IP (int) 最近连接的目标 IP 地址
CURLINFO_PRIMARY_PORT (int) 最近连接的目标端口
CURLINFO_PRIVATE (int) 与 CURL 句柄相关的私有数据,先前使用 curl_setopt()CURLOPT_PRIVATE 选项设置
CURLINFO_PROTOCOL (int) 上次 HTTP 连接使用的协议。返回值将是 CURLPROTO_* 值之一。自 PHP 7.3.0 和 cURL 7.52.0 起可用
CURLINFO_PROXYAUTH_AVAIL (int) 之前的响应中,用位掩码表示对应可用的代理身份验证方法
CURLINFO_PROXY_ERROR (int) 详细的 (SOCKS) 代理错误代码。当最近传输返回 CURLE_PROXY 错误时,该代码会提供更多信息。返回值将是 CURLPX_* 值之一。如果没有可用的响应代码,则错误代码将是 CURLPX_OK。自 PHP 8.2.0 和 cURL 7.73.0 起可用
CURLINFO_PROXY_SSL_VERIFYRESULT (int) 请求(使用 CURLOPT_PROXY_SSL_VERIFYPEER 选项)时,证书的验证结果。仅 HTTPS 代理有效。自 PHP 7.3.0 和 cURL 7.52.0 起可用
CURLINFO_REDIRECT_COUNT (int) 启用 CURLOPT_FOLLOWLOCATION 时的重定向次数。
CURLINFO_REDIRECT_TIME (int) 启用 CURLOPT_FOLLOWLOCATION 选项后,最终事务开始前所有重定向步骤花费的秒数。
CURLINFO_REDIRECT_TIME_T (int) 最终事务开始前所有重定向步骤(包含域名解析、连接、传输前预处理、传输)花费的秒数。自 PHP 7.3.0 和 cURL 7.61.0 起可用
CURLINFO_REDIRECT_URL (int) 禁用 CURLOPT_FOLLOWLOCATION 选项:在上一次事务中找到的重定向 URL,接下来应手动请求。启用 CURLOPT_FOLLOWLOCATION 选项:此为空。此情况下的重定向 URL 可在 CURLINFO_EFFECTIVE_URL 中找到。
CURLINFO_REFERER (int) Referer header。自 PHP 8.2.0 和 cURL 7.76.0 起可用
CURLINFO_REQUEST_SIZE (int) 发出的请求总大小,目前仅适用于 HTTP 请求
CURLINFO_RESPONSE_CODE (int) 最后一个响应代码。自 cURL 7.10.8 起可用
CURLINFO_RETRY_AFTER (int) Retry-After header 中的信息,如果没有有效的 header 则为零。自 PHP 8.2.0 和 cURL 7.66.0 起可用
CURLINFO_RTSP_CLIENT_CSEQ (int) 下一个 RTSP 客户端 CSeq
CURLINFO_RTSP_CSEQ_RECV (int) 最近检索的 CSeq
CURLINFO_RTSP_SERVER_CSEQ (int) 下一个 RTSP 服务器 CSeq
CURLINFO_RTSP_SESSION_ID (int) RTSP session ID
CURLINFO_SCHEME (int) 用于最近连接的 URL scheme。自 PHP 7.3.0 和 cURL 7.52.0 起可用
CURLINFO_SIZE_DOWNLOAD (int) 下载的总字节数
CURLINFO_SIZE_DOWNLOAD_T (int) 已下载的总字节数。该数字仅适用于最近一次传输,每次新传输都会重新设置。自 PHP 7.3.0 和 cURL 7.50.0 起可用
CURLINFO_SIZE_UPLOAD (int) 上传的总字节数
CURLINFO_SIZE_UPLOAD_T (int) 上传的总字节数。自 PHP 7.3.0 和 cURL 7.50.0 起可用
CURLINFO_SPEED_DOWNLOAD (int) 平均下载速度
CURLINFO_SPEED_DOWNLOAD_T (int) curl 测量的完整下载的平均下载速度(以字节/秒为单位)。自 PHP 7.3.0 和 cURL 7.50.0 开始可用
CURLINFO_SPEED_UPLOAD (int) 平均上传速度
CURLINFO_SPEED_UPLOAD_T (int) curl 测量的完整上传过程的平均上传速度(以字节/秒为单位)。自 PHP 7.3.0 和 cURL 7.50.0 开始可用
CURLINFO_SSL_ENGINES (int) 支持 OpenSSL 加密引擎
CURLINFO_SSL_VERIFYRESULT (int) 通过设置 CURLOPT_SSL_VERIFYPEER 请求 SSL 认证验证的结果
CURLINFO_STARTTRANSFER_TIME (int) 第一个字节即将被传输的时间(以秒为单位)
CURLINFO_STARTTRANSFER_TIME_T (int) 从开始到接收到第一个字节时所花费的时间(以微秒为单位)。自 PHP 7.3.0 和 cURL 7.61.0 开始可用
CURLINFO_TOTAL_TIME (int) 上次传输的总事务时间(秒)
CURLINFO_TOTAL_TIME_T (int) 上次传输的总时间(以微秒为单位),包括名称解析、TCP 连接等。自 PHP 7.3.0 和 cURL 7.61.0 开始可用
CURLINFO_POSTTRANSFER_TIME_T (int) 从开始到发送最后一个字节所花费的微秒数。自 PHP 8.4.0 和 cURL 8.10.0 起可用
curl_multi_setopt()
常量 描述
CURLMOPT_CHUNK_LENGTH_PENALTY_SIZE (int) 指定用于管道处理的块长度阈值(以字节为单位)。自 PHP 7.0.7 和 cURL 7.30.0 起可用
CURLMOPT_CONTENT_LENGTH_PENALTY_SIZE (int) 指定用于管道惩罚(pipelining penalty)的长度阈值(以字节为单位)。自 PHP 7.0.7 和 cURL 7.30.0 起可用
CURLMOPT_MAXCONNECTS (int) 指定 libcurl 可以缓存的最大同时打开的连接数。默认情况下,这个大小会自动扩展到通过 curl_multi_add_handle() 添加的句柄数的四倍。当缓存已满时,cURL 会关闭缓存中最旧的一个连接,以防止打开的连接数继续增加。自 cURL 7.16.3 起可用
CURLMOPT_MAX_CONCURRENT_STREAMS (int) 指定 cURL 在使用 HTTP/2 连接中应支持的最大并发流数量。有效值范围是从 121474836472^31 - 1)。这里设置的值将根据其他系统资源属性来确定是否执行。默认值是 100。自 PHP 8.2.0 和 cURL 7.67.0 起可用。
CURLMOPT_MAX_HOST_CONNECTIONS (int) 指定单个主机的最大连接数。自 PHP 7.0.7 和 cURL 7.30.0 起可用
CURLMOPT_MAX_PIPELINE_LENGTH (int) 指定管道中的最大请求数。自 PHP 7.0.7 和 cURL 7.30.0 起可用
CURLMOPT_MAX_TOTAL_CONNECTIONS (int) 指定同时打开的最大连接数。自 PHP 7.0.7 和 cURL 7.30.0 起可用
CURLMOPT_PIPELINING (int) 传递 1 启用或传递 0 禁用。在多句柄上启用管道将使其尝试对使用此句柄的传输尽可能执行 HTTP 管道操作。这意味着如果添加的第二个请求可以使用已有连接,则第二个请求将在同一连接上使用“管道”。自 cURL 7.43.0 起,该值是位掩码,传递 2 将尝试在现有的 HTTP/2 连接上多路复用新传输。传递 3 指示 cURL 请求彼此独立的管道和多路复用。自 cURL 7.62.0 起,设置管道 bit 没有效果。除了整数文字,还可以使用 CURLPIPE_* 常量。自 cURL 7.16.0 起可用。
CURLMOPT_PUSHFUNCTION (int)

传递 callable 以注册处理服务器推送且应具有以下签名:

pushfunction(resource $parent_ch, resource $pushed_ch, array $headers): int
parent_ch
父级 cURL 句柄(客户端发出的请求)。
pushed_ch
推送请求的新 cURL 句柄。
headers
推送 promise header。
推送函数如果可以处理推送应该返回 CURL_PUSH_OK,或者返回 CURL_PUSH_DENY 拒绝。自 PHP 7.1.0 和 cURL 7.44.0 起可用。

cURL 协议常量
常量 描述
CURLPROTO_ALL (int) 自 cURL 7.19.4 起可用。
CURLPROTO_DICT (int) 自 cURL 7.19.4 起可用。
CURLPROTO_FILE (int) 自 cURL 7.19.4 起可用。
CURLPROTO_FTP (int) 自 cURL 7.19.4 起可用。
CURLPROTO_FTPS (int) 自 cURL 7.19.4 起可用。
CURLPROTO_GOPHER (int) 自 cURL 7.21.2 起可用。
CURLPROTO_HTTP (int) 自 cURL 7.19.4 起可用。
CURLPROTO_HTTPS (int) 自 cURL 7.19.4 起可用。
CURLPROTO_IMAP (int) 自 cURL 7.20.0 起可用。
CURLPROTO_IMAPS (int) 自 cURL 7.20.0 起可用。
CURLPROTO_LDAP (int) 自 cURL 7.19.4 起可用。
CURLPROTO_LDAPS (int) 自 cURL 7.19.4 起可用。
CURLPROTO_MQTT (int) 自 PHP 8.2.0 和 cURL 7.71.0 起可用。
CURLPROTO_POP3 (int) 自 cURL 7.20.0 起可用。
CURLPROTO_POP3S (int) 自 cURL 7.20.0 起可用。
CURLPROTO_RTMP (int) 自 cURL 7.21.0 起可用。
CURLPROTO_RTMPE (int) 自 cURL 7.21.0 起可用。
CURLPROTO_RTMPS (int) 自 cURL 7.21.0 起可用。
CURLPROTO_RTMPT (int) 自 cURL 7.21.0 起可用。
CURLPROTO_RTMPTE (int) 自 cURL 7.21.0 起可用。
CURLPROTO_RTMPTS (int) 自 cURL 7.21.0 起可用。
CURLPROTO_RTSP (int) 自 cURL 7.20.0 起可用。
CURLPROTO_SCP (int) 自 cURL 7.19.4 起可用。
CURLPROTO_SFTP (int) 自 cURL 7.19.4 起可用。
CURLPROTO_SMB (int) 自 PHP 7.0.7 和 cURL 7.40.0 起可用。
CURLPROTO_SMBS (int) 自 PHP 7.0.7 和 cURL 7.40.0 起可用。
CURLPROTO_SMTP (int) 自 cURL 7.20.0 起可用。
CURLPROTO_SMTPS (int) 自 cURL 7.20.0 起可用。
CURLPROTO_TELNET (int) 自 cURL 7.19.4 起可用。
CURLPROTO_TFTP (int) 自 cURL 7.19.4 起可用。
cURL 错误常量
常量 描述
CURLE_ABORTED_BY_CALLBACK (int) 回调已中止。回调向 libcurl 返回“abort”。
CURLE_BAD_CALLING_ORDER (int)
CURLE_BAD_CONTENT_ENCODING (int) 无法识别传输编码。
CURLE_BAD_DOWNLOAD_RESUME (int) 由于指定的偏移量超出了文件边界,因此无法恢复下载。
CURLE_BAD_FUNCTION_ARGUMENT (int) 调用的函数带有错误的参数。
CURLE_BAD_PASSWORD_ENTERED (int)
CURLE_COULDNT_CONNECT (int) 无法连接到主机或代理。
CURLE_COULDNT_RESOLVE_HOST (int) 无法解析主机。指定的远程主机无法解析。
CURLE_COULDNT_RESOLVE_PROXY (int) 无法解析代理。无法解析给定的代理主机。
CURLE_FAILED_INIT (int) 初始化代码失败。这可能是内部错误或程序,或者是资源问题,导致在初始化时无法完成一些基本操作。
CURLE_FILESIZE_EXCEEDED (int) 超出最大文件大小。
CURLE_FILE_COULDNT_READ_FILE (int) 无法打开 FILE:// 指定的文件。很可能是因为文件路径未识别现有文件或由于缺乏适当的文件权限。
CURLE_FTP_ACCESS_DENIED (int)
CURLE_FTP_BAD_DOWNLOAD_RESUME (int)
CURLE_FTP_CANT_GET_HOST (int) 用于查找新连接的主机发生内部故障。
CURLE_FTP_CANT_RECONNECT (int)
CURLE_FTP_COULDNT_GET_SIZE (int)
CURLE_FTP_COULDNT_RETR_FILE (int) 这要么是对“RETR”命令的意外回复,要么是零字节传输完成。
CURLE_FTP_COULDNT_SET_ASCII (int)
CURLE_FTP_COULDNT_SET_BINARY (int)
CURLE_FTP_COULDNT_STOR_FILE (int)
CURLE_FTP_COULDNT_USE_REST (int) FTP REST 命令返回错误。如果服务器正常,这种情况绝不会发生。
CURLE_FTP_PARTIAL_FILE (int)
CURLE_FTP_PORT_FAILED (int) FTP PORT 命令返回错误。这种情况大多发生在为 libcurl 指定的地址没有足够好。参阅 CURLOPT_FTPPORT
CURLE_FTP_QUOTE_ERROR (int)
CURLE_FTP_SSL_FAILED (int)
CURLE_FTP_USER_PASSWORD_INCORRECT (int)
CURLE_FTP_WEIRD_227_FORMAT (int) FTP 服务器返回 227-line 作为对 PASV 命令的响应。如果 libcurl 无法解析该行,则会传回此返回代码。
CURLE_FTP_WEIRD_PASS_REPLY (int) 将 FTP 密码发送到服务器后,libcurl 需要收到正确的回复。此错误代码表示返回了意外代码。
CURLE_FTP_WEIRD_PASV_REPLY (int) libcurl 无法从服务器获取合理的结果作为对 PASV 或 EPSV 命令的响应。服务器存在缺陷。
CURLE_FTP_WEIRD_SERVER_REPLY (int) 服务器发送了 libcurl 无法解析的数据。自 cURL 7.51.0 起,此错误代码为 CURLE_WEIRD_SERVER_REPLY
CURLE_FTP_WEIRD_USER_REPLY (int)
CURLE_FTP_WRITE_ERROR (int)
CURLE_FUNCTION_NOT_FOUND (int) 未找到函数。未找到所需的 zlib 函数。
CURLE_GOT_NOTHING (int) 服务器没有返回任何内容,在这种情况下,没有得到任何内容视为错误。
CURLE_HTTP_NOT_FOUND (int)
CURLE_HTTP_PORT_FAILED (int)
CURLE_HTTP_POST_ERROR (int) 这是一个奇怪的错误,主要由于内部混乱而发生。
CURLE_HTTP_RANGE_ERROR (int)
CURLE_HTTP_RETURNED_ERROR (int) 如果 CURLOPT_FAILONERROR 设置为 true 并且 HTTP 服务器返回大于或等于 400 的错误代码,则返回此值。
CURLE_LDAP_CANNOT_BIND (int) LDAP 无法绑定。LDAP 绑定操作失败。
CURLE_LDAP_INVALID_URL (int)
CURLE_LDAP_SEARCH_FAILED (int) LDAP 搜索失败。
CURLE_LIBRARY_NOT_FOUND (int)
CURLE_MALFORMAT_USER (int)
CURLE_OBSOLETE (int)
CURLE_OK (int) 一切顺利。一切照常进行。
CURLE_OPERATION_TIMEDOUT (int) 操作超时。根据条件已达到指定的超时时限。
CURLE_OPERATION_TIMEOUTED (int)
CURLE_OUT_OF_MEMORY (int) 内存分配请求失败。
CURLE_PARTIAL_FILE (int) 文件传输的大小跟预期的不一致。当服务器首先报告预期的传输大小,然后提供与先前指定的大小不匹配的数据时,就会发生这种情况。
CURLE_PROXY (int) 代理握手错误。CURLINFO_PROXY_ERROR 提供有关特定问题的额外详细信息。自 PHP 8.2.0 和 cURL 7.73.0 起可用
CURLE_READ_ERROR (int) 读取本地文件时出现问题,或者读取回调返回错误。
CURLE_RECV_ERROR (int) 接收网络数据失败。
CURLE_SEND_ERROR (int) 发送网络数据失败。
CURLE_SHARE_IN_USE (int)
CURLE_SSH (int) SSH 会话期间发生未指定的错误。自 cURL 7.16.1 起可用。
CURLE_SSL_CACERT (int)
CURLE_SSL_CACERT_BADFILE (int) 读取 SSL CA 证书时出现问题。
CURLE_SSL_CERTPROBLEM (int) 本地客户端证书有问题。
CURLE_SSL_CIPHER (int) 无法使用指定的密码。
CURLE_SSL_CONNECT_ERROR (int) SSL/TLS 握手中某处出现问题。读取错误缓冲区中的消息可提供有关该问题的更多详细信息。可能是证书(文件格式、路径、权限)、密码等。
CURLE_SSL_ENGINE_NOTFOUND (int) 未找到指定的加密引擎。
CURLE_SSL_ENGINE_SETFAILED (int) 无法将选定的 SSL 加密引擎设置为默认值。
CURLE_SSL_PEER_CERTIFICATE (int)
CURLE_SSL_PINNEDPUBKEYNOTMATCH (int) 无法匹配使用 CURLOPT_PINNEDPUBLICKEY 指定的固定密钥。
CURLE_TELNET_OPTION_SYNTAX (int)
CURLE_TOO_MANY_REDIRECTS (int) 重定向次数过多。在进行重定向时,libcurl 达到最大数量。可以使用 CURLOPT_MAXREDIRS 设置最大值。
CURLE_UNKNOWN_TELNET_OPTION (int)
CURLE_UNSUPPORTED_PROTOCOL (int) 传递给 libcurl 的 URL 使用了 libcurl 不支持的协议。问题可能是未使用的编译时选项、拼写错误的协议字符串或 libcurl 没有编码的协议。
CURLE_URL_MALFORMAT (int) URL 格式不正确。
CURLE_URL_MALFORMAT_USER (int)
CURLE_WEIRD_SERVER_REPLY (int) 服务器发送的数据 libcurl 无法解析。在 cURL 7.51.0 之前,此错误代码称为 CURLE_FTP_WEIRD_SERVER_REPLY。自 PHP 7.3.0 和 cURL 7.51.0 起可用
CURLE_WRITE_ERROR (int) 将接收的数据写入本地文件时发生错误,或者从写入回调向 libcurl 返回错误。
curl_multi_* 状态常量
常量 描述
CURLM_ADDED_ALREADY (int) 重复添加句柄到多句柄。自 cURL 7.32.1 起可用。
CURLM_BAD_EASY_HANDLE (int) 句柄无效或者不正确。这可能意味着这不是句柄或者该句柄已经被自身或者其他多句柄使用了。自 cURL 7.9.6 起可用。
CURLM_BAD_HANDLE (int) 传入的句柄不是有效的多句柄。自 cURL 7.9.6 起可用。
CURLM_CALL_MULTI_PERFORM (int) 从 cURL 7.20.0 起,不再使用此常量。在 cURL 7.20.0 之前,如果在返回任何其他常量之前调用 curl_multi_select() 或类似函数时,curl_multi_exec() 可能会返回此状态。自 cURL 7.9.6 起可用。
CURLM_INTERNAL_ERROR (int) 内部 libcurl 错误。自 cURL 7.9.6 起可用。
CURLM_OK (int) 没有错误。自 cURL 7.9.6 起可用。
CURLM_OUT_OF_MEMORY (int) 处理多句柄时内存不足。自 cURL 7.9.6 起可用。
curl_pause()
常量 描述
CURLPAUSE_ALL (int) 暂停发送和接收数据。自 cURL 7.18.0 起可用。
CURLPAUSE_CONT (int) 取消暂停发送和接收数据。自 cURL 7.18.0 起可用。
CURLPAUSE_RECV (int) 暂停接收数据。自 cURL 7.18.0 起可用。
CURLPAUSE_RECV_CONT (int) 取消暂停接收数据。自 cURL 7.18.0 起可用。
CURLPAUSE_SEND (int) 暂停发送数据。自 cURL 7.18.0 起可用。
CURLPAUSE_SEND_CONT (int) 取消暂停发送数据。自 cURL 7.18.0 起可用。
添加备注

用户贡献的备注 4 notes

up
30
nimasdj [AT] yahoo [DOT] com
9 years ago
I hope this would be useful to convert error codes:

<?php
$curl_errno
= array(
1 => "CURLE_UNSUPPORTED_PROTOCOL",
2 => "CURLE_FAILED_INIT",
3 => "CURLE_URL_MALFORMAT",
4 => "CURLE_URL_MALFORMAT_USER",
5 => "CURLE_COULDNT_RESOLVE_PROXY",
6 => "CURLE_COULDNT_RESOLVE_HOST",
7 => "CURLE_COULDNT_CONNECT",
8 => "CURLE_FTP_WEIRD_SERVER_REPLY",
9 => "CURLE_FTP_ACCESS_DENIED",
10 => "CURLE_FTP_USER_PASSWORD_INCORRECT",
11 => "CURLE_FTP_WEIRD_PASS_REPLY",
12 => "CURLE_FTP_WEIRD_USER_REPLY",
13 => "CURLE_FTP_WEIRD_PASV_REPLY",
14 => "CURLE_FTP_WEIRD_227_FORMAT",
15 => "CURLE_FTP_CANT_GET_HOST",
16 => "CURLE_FTP_CANT_RECONNECT",
17 => "CURLE_FTP_COULDNT_SET_BINARY",
18 => "CURLE_FTP_PARTIAL_FILE or CURLE_PARTIAL_FILE",
19 => "CURLE_FTP_COULDNT_RETR_FILE",
20 => "CURLE_FTP_WRITE_ERROR",
21 => "CURLE_FTP_QUOTE_ERROR",
22 => "CURLE_HTTP_NOT_FOUND or CURLE_HTTP_RETURNED_ERROR",
23 => "CURLE_WRITE_ERROR",
24 => "CURLE_MALFORMAT_USER",
25 => "CURLE_FTP_COULDNT_STOR_FILE",
26 => "CURLE_READ_ERROR",
27 => "CURLE_OUT_OF_MEMORY",
28 => "CURLE_OPERATION_TIMEDOUT or CURLE_OPERATION_TIMEOUTED",
29 => "CURLE_FTP_COULDNT_SET_ASCII",
30 => "CURLE_FTP_PORT_FAILED",
31 => "CURLE_FTP_COULDNT_USE_REST",
32 => "CURLE_FTP_COULDNT_GET_SIZE",
33 => "CURLE_HTTP_RANGE_ERROR",
34 => "CURLE_HTTP_POST_ERROR",
35 => "CURLE_SSL_CONNECT_ERROR",
36 => "CURLE_BAD_DOWNLOAD_RESUME or CURLE_FTP_BAD_DOWNLOAD_RESUME",
37 => "CURLE_FILE_COULDNT_READ_FILE",
38 => "CURLE_LDAP_CANNOT_BIND",
39 => "CURLE_LDAP_SEARCH_FAILED",
40 => "CURLE_LIBRARY_NOT_FOUND",
41 => "CURLE_FUNCTION_NOT_FOUND",
42 => "CURLE_ABORTED_BY_CALLBACK",
43 => "CURLE_BAD_FUNCTION_ARGUMENT",
44 => "CURLE_BAD_CALLING_ORDER",
45 => "CURLE_HTTP_PORT_FAILED",
46 => "CURLE_BAD_PASSWORD_ENTERED",
47 => "CURLE_TOO_MANY_REDIRECTS",
48 => "CURLE_UNKNOWN_TELNET_OPTION",
49 => "CURLE_TELNET_OPTION_SYNTAX",
50 => "CURLE_OBSOLETE",
51 => "CURLE_SSL_PEER_CERTIFICATE",
52 => "CURLE_GOT_NOTHING",
53 => "CURLE_SSL_ENGINE_NOTFOUND",
54 => "CURLE_SSL_ENGINE_SETFAILED",
55 => "CURLE_SEND_ERROR",
56 => "CURLE_RECV_ERROR",
57 => "CURLE_SHARE_IN_USE",
58 => "CURLE_SSL_CERTPROBLEM",
59 => "CURLE_SSL_CIPHER",
60 => "CURLE_SSL_CACERT",
61 => "CURLE_BAD_CONTENT_ENCODING",
62 => "CURLE_LDAP_INVALID_URL",
63 => "CURLE_FILESIZE_EXCEEDED",
64 => "CURLE_FTP_SSL_FAILED",
79 => "CURLE_SSH"
);
?>
up
17
s dot coletta at unidata dot it
15 years ago
Beware of CURLE_* constants!

On the official site:

http://curl.haxx.se/libcurl/c/libcurl-errors.html

some constants are different, some missing compared to the PHP implementation.

Some examples:

in PHP the curl error number 28 is called

CURLE_OPERATION_TIMEOUTED

while in the official site is:

CURLE_OPERATION_TIMEDOUT

So if you use the second, it won't march the error 28 because in PHP it is not defined that way.

The same is for these:

CURLE_HTTP_RETURNED_ERROR
CURLE_UPLOAD_FAILED
CURLE_INTERFACE_FAILED
CURLE_SSL_CERTPROBLEM
CURLE_SEND_FAIL_REWIND
CURLE_LOGIN_DENIED
CURLE_AGAIN

that are in someway named differently or missing from PHP.
up
8
uramihsayibok, gmail, com
9 years ago
Regarding CURLE_OPERATION_TIMEDOUT vs. CURLE_OPERATION_TIMEOUTED:

Originally cURL had the constant named TIMEOUTED (read: "timeout-ed"). This was changed[1] in 2007 and v7.17.0 to be TIMEDOUT (read: "timed out") and the old constant kept in place as an alias.

PHP started off using TIMEOUTED as well. The TIMEDOUT constant was added[2] in 2012 and v5.5.0 and the old constant was *kept in place*.

If you ask me, the TIMEDOUT constant reads more nicely (not to mention is technically the correct one to use) and as long as you're using PHP 5.5+ then it is available. If you have to support older versions then I suggest you keep using the new constant and add a polyfill like

<?php
if (version_compare(PHP_VERSION, "5.5.0", "<")) {
define("CURLE_OPERATION_TIMEDOUT", CURLE_OPERATION_TIMEOUTED);
}
?>

or

<?php
// PHP <5.5.0
defined("CURLE_OPERATION_TIMEDOUT") || define("CURLE_OPERATION_TIMEDOUT", CURLE_OPERATION_TIMEOUTED);
?>

to be removed once you stop supporting them.

[1] https://github.com/bagder/curl/commit/9f44a95522162c0f4a61093efe1bf1f58b087358#diff-d8c6cb80505e0f7d5e27fca2a682aa34L119
[2] https://github.com/php/php-src/commit/9ab45d3edbafa3ee751472c3f8d1fb3f51f38cf1#diff-ac978e3de205f1d14eb960e0eb15ef24R723
up
9
Ron
17 years ago
<?
/*
* Author: Ron
* Released: August 4, 2007
* Description: An example of the disguise_curl() function in order to grab contents from a website while remaining fully camouflaged by using a fake user agent and fake headers.
*/

$url = 'http://www.ericgiguere.com/tools/http-header-viewer.html';

// disguises the curl using fake headers and a fake user agent.
function disguise_curl($url)
{
$curl = curl_init();

// Setup headers - I used the same headers from Firefox version 2.0.0.6
// below was split up because php.net said the line was too long. :/
$header[0] = "Accept: text/xml,application/xml,application/xhtml+xml,";
$header[0] .= "text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5";
$header[] = "Cache-Control: max-age=0";
$header[] = "Connection: keep-alive";
$header[] = "Keep-Alive: 300";
$header[] = "Accept-Charset: ISO-8859-1,utf-8;q=0.7,*;q=0.7";
$header[] = "Accept-Language: en-us,en;q=0.5";
$header[] = "Pragma: "; // browsers keep this blank.

curl_setopt($curl, CURLOPT_URL, $url);
curl_setopt($curl, CURLOPT_USERAGENT, 'Googlebot/2.1 (+http://www.google.com/bot.html)');
curl_setopt($curl, CURLOPT_HTTPHEADER, $header);
curl_setopt($curl, CURLOPT_REFERER, 'http://www.google.com');
curl_setopt($curl, CURLOPT_ENCODING, 'gzip,deflate');
curl_setopt($curl, CURLOPT_AUTOREFERER, true);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($curl, CURLOPT_TIMEOUT, 10);

$html = curl_exec($curl); // execute the curl command
curl_close($curl); // close the connection

return $html; // and finally, return $html
}

// uses the function and displays the text off the website
$text = disguise_curl($url);
echo $text;
?>

~Ron
To Top