CURLOPT_AUTOREFERER |
TRUE 时将根据 Location: 重定向时,自动设置 header 中的Referer:信息 。 |
|
CURLOPT_BINARYTRANSFER |
设为 TRUE ,将在启用 CURLOPT_RETURNTRANSFER 时,返回原生的(Raw)输出 。 |
从 PHP 5.1.3 开始,此选项不再有效果:使用CURLOPT_RETURNTRANSFER 后总是会返回原生的(Raw)内容 。 |
CURLOPT_COOKIESESSION |
设为 TRUE 时将开启新的一次 cookie 会话 。它将强制 libcurl 忽略之前会话时存的其他 cookie 。 libcurl 在默认状况下无论是否为会话,都会储存、加载所有 cookie 。会话 cookie 是指没有过期时间,只存活在会话之中 。 |
|
CURLOPT_CERTINFO |
TRUE 将在安全传输时输出 SSL 证书信息到 STDERR 。 |
在 cURL 7.19.1 中添加 。 PHP 5.3.2 后有效 。 需要开启 CURLOPT_VERBOSE 才有效 。 |
CURLOPT_CONNECT_ONLY |
TRUE 将让库执行所有需要的代理、验证、连接过程,但不传输数据 。此选项用于 HTTP、SMTP 和 POP3 。 |
在 7.15.2 中添加 。 PHP 5.5.0 起有效 。 |
CURLOPT_CRLF |
启用时将Unix的换行符转换成回车换行符 。 |
|
CURLOPT_DNS_USE_GLOBAL_CACHE |
TRUE 会启用一个全局的DNS缓存 。此选项非线程安全的,默认已开启 。 |
|
CURLOPT_FAILONERROR |
当 HTTP 状态码大于等于 400,TRUE 将将显示错误详情 。 默认情况下将返回页面,忽略 HTTP 代码 。 |
|
CURLOPT_SSL_FALSESTART |
TRUE 开启 TLS False Start (一种 TLS 握手优化方式) |
cURL 7.42.0 中添加 。自 PHP 7.0.7 起有效 。 |
CURLOPT_FILETIME |
TRUE 时,会尝试获取远程文档中的修改时间信息 。 信息可通过curl_getinfo()函数的CURLINFO_FILETIME 选项获取 。 |
|
CURLOPT_FOLLOWLOCATION |
TRUE 时将会根据服务器返回 HTTP 头中的 "Location: " 重定向 。(注意:这是递归的,"Location: " 发送几次就重定向几次,除非设置了 CURLOPT_MAXREDIRS,限制最大重定向次数 。) 。 |
|
CURLOPT_FORBID_REUSE |
TRUE 在完成交互以后强制明确的断开连接,不能在连接池中重用 。 |
|
CURLOPT_FRESH_CONNECT |
TRUE 强制获取一个新的连接,而不是缓存中的连接 。 |
|
CURLOPT_FTP_USE_EPRT |
TRUE 时,当 FTP 下载时,使用 EPRT (和 LPRT)命令 。 设置为 FALSE 时禁用 EPRT 和 LPRT,仅仅使用PORT 命令 。 |
|
CURLOPT_FTP_USE_EPSV |
TRUE 时,在FTP传输过程中,回到 PASV 模式前,先尝试 EPSV 命令 。设置为 FALSE 时禁用 EPSV 。 |
|
CURLOPT_FTP_CREATE_MISSING_DIRS |
TRUE 时,当 ftp 操作不存在的目录时将创建它 。 |
|
CURLOPT_FTPAPPEND |
TRUE 为追加写入文件,而不是覆盖 。 |
|
CURLOPT_TCP_NODELAY |
TRUE 时禁用 TCP 的 Nagle 算法,就是减少网络上的小包数量 。 |
PHP 5.2.1 有效,编译时需要 libcurl 7.11.2 及以上 。 |
CURLOPT_FTPASCII |
CURLOPT_TRANSFERTEXT 的别名 。 |
|
CURLOPT_FTPLISTONLY |
TRUE 时只列出 FTP 目录的名字 。 |
|
CURLOPT_HEADER |
启用时会将头文件的信息作为数据流输出 。 |
|
CURLINFO_HEADER_OUT |
TRUE 时追踪句柄的请求字符串 。 |
从 PHP 5.1.3 开始可用 。CURLINFO_ 的前缀是有意的(intentional) 。 |
CURLOPT_HTTPGET |
TRUE 时会设置 HTTP 的 method 为 GET,由于默认是 GET,所以只有 method 被修改时才需要这个选项 。 |
|
CURLOPT_HTTPPROXYTUNNEL |
TRUE 会通过指定的 HTTP 代理来传输 。 |
|
CURLOPT_MUTE |
TRUE 时将完全静默,无论是何 cURL 函数 。 |
在 cURL 7.15.5 中移出(可以使用 CURLOPT_RETURNTRANSFER 作为代替) |
CURLOPT_NETRC |
TRUE 时,在连接建立时,访问'/.netrc文件获取用户名和密码来连接远程站点 。 |
|
CURLOPT_NOBODY |
TRUE 时将不输出 BODY 部分 。同时 Mehtod 变成了 HEAD 。修改为 FALSE时不会变成 GET 。 |
|
CURLOPT_NOPROGRESS |
TRUE 时关闭 cURL 的传输进度 。 Note: PHP 默认自动设置此选项为 TRUE,只有为了调试才需要改变设置 。 |
|
CURLOPT_NOSIGNAL |
TRUE 时忽略所有的 cURL 传递给 PHP 进行的信号 。在 SAPI 多线程传输时此项被默认启用,所以超时选项仍能使用 。 |
cURL 7.10时被加入 。 |
CURLOPT_PATH_AS_IS |
TRUE 不处理 dot dot sequences (即 ../ ) |
cURL 7.42.0 时被加入 。 PHP 7.0.7 起有效 。 |
CURLOPT_PIPEWAIT |
TRUE 则等待 pipelining/multiplexing 。 |
cURL 7.43.0 时被加入 。 PHP 7.0.7 起有效 。 |
CURLOPT_POST |
TRUE 时会发送 POST 请求,类型为:application/x-www-form-urlencoded,是 HTML 表单提交时最常见的一种 。 |
|
CURLOPT_PUT |
TRUE 时允许 HTTP 发送文件 。要被 PUT 的文件必须在 CURLOPT_INFILE和CURLOPT_INFILESIZE 中设置 。 |
|
CURLOPT_RETURNTRANSFER |
TRUE 将curl_exec()获取的信息以字符串返回,而不是直接输出 。 |
|
CURLOPT_SAFE_UPLOAD |
TRUE 禁用 @ 前缀在 CURLOPT_POSTFIELDS 中发送文件 。 意味着 @ 可以在字段中安全得使用了 。 可使用 CURLFile 作为上传的代替 。 |
PHP 5.5.0 中添加,默认值 FALSE 。 PHP 5.6.0 改默认值为 TRUE 。. PHP 7 删除了此选项, 必须使用 CURLFile interface 来上传文件 。 |
CURLOPT_SASL_IR |
TRUE 开启,收到首包(first packet)后发送初始的响应(initial response) 。 |
cURL 7.31.10 中添加,自 PHP 7.0.7 起有效 。 |
CURLOPT_SSL_ENABLE_ALPN |
FALSE 禁用 SSL 握手中的 ALPN (如果 SSL 后端的 libcurl 内建支持) 用于协商到 http2 。 |
cURL 7.36.0 中增加, PHP 7.0.7 起有效 。 |
CURLOPT_SSL_ENABLE_NPN |
FALSE 禁用 SSL 握手中的 NPN(如果 SSL 后端的 libcurl 内建支持),用于协商到 http2 。 |
cURL 7.36.0 中增加, PHP 7.0.7 起有效 。 |
CURLOPT_SSL_VERIFYPEER |
FALSE 禁止 cURL 验证对等证书(peer's certificate) 。要验证的交换证书可以在 CURLOPT_CAINFO 选项中设置,或在 CURLOPT_CAPATH中设置证书目录 。 |
自cURL 7.10开始默认为 TRUE 。从 cURL 7.10开始默认绑定安装 。 |
CURLOPT_SSL_VERIFYSTATUS |
TRUE 验证证书状态 。 |
cURL 7.41.0 中添加, PHP 7.0.7 起有效 。 |
CURLOPT_TCP_FASTOPEN |
TRUE 开启 TCP Fast Open 。 |
cURL 7.49.0 中添加, PHP 7.0.7 起有效 。 |
CURLOPT_TFTP_NO_OPTIONS |
TRUE 不发送 TFTP 的 options 请求 。 |
自 cURL 7.48.0 添加, PHP 7.0.7 起有效 。 |
CURLOPT_TRANSFERTEXT |
TRUE 对 FTP 传输使用 ASCII 模式 。对于LDAP,它检索纯文本信息而非 HTML 。在 Windows 系统上,系统不会把 STDOUT 设置成二进制 模式 。 |
|
CURLOPT_UNRESTRICTED_AUTH |
TRUE 在使用CURLOPT_FOLLOWLOCATION重定向 header 中的多个 location 时继续发送用户名和密码信息,哪怕主机名已改变 。 |
|
CURLOPT_UPLOAD |
TRUE 准备上传 。 |
|
CURLOPT_VERBOSE |
TRUE 会输出所有的信息,写入到STDERR,或在CURLOPT_STDERR中指定的文件 。 |
|