本篇文章是对php中的curl选项列表进行了详细的分析介绍
需要的朋友参考下
第一类
对于下面的这些option的可选参数value应该被设置一个bool类型的值
选项
可选value值
备注
CURLOPT_AUTOREFERER
当根据Location:重定向时自动设置header中的Referer:信息
CURLOPT_BINARYTRANSFER
在启用CURLOPT_RETURNTRANSFER的时候返回原生的（Raw）输出
CURLOPT_COOKIESESSION
启用时curl会仅仅传递一个session cookie忽略其他的cookie默认状况下cURL会将所有的cookie返回给服务端session cookie是指那些用来判断服务器端的session是否有效而存在的cookie
CURLOPT_CRLF
启用时将Unix的换行符转换成回车换行符
CURLOPT_DNS_USE_GLOBAL_CACHE
启用时会启用一个全局的DNS缓存此项为线程安全的并且默认启用
CURLOPT_FAILONERROR
显示HTTP状态码默认行为是忽略编号小于等于的HTTP信息
CURLOPT_FILETIME
启用时会尝试修改远程文档中的信息结果信息会通过 curl_getinfo()函数的CURLINFO_FILETIME选项返回curl_getinfo()
CURLOPT_FOLLOWLOCATION
启用时会将服务器服务器返回的"Location: "放在header中递归的返回给服务器使用CURLOPT_MAXREDIRS可以限定递归返回的数量
CURLOPT_FORBID_REUSE
在完成交互以后强迫断开连接不能重用
CURLOPT_FRESH_CONNECT
强制获取一个新的连接替代缓存中的连接
CURLOPT_FTP_USE_EPRT
启用时当FTP下载时使用EPRT (或 LPRT)命令设置为FALSE时禁用EPRT和LPRT使用PORT命令 only
CURLOPT_FTP_USE_EPSV
启用时在FTP传输过程中回复到PASV模式前首先尝试EPSV命令设置为FALSE时禁用EPSV命令
CURLOPT_FTPAPPEND
启用时追加写入文件而不是覆盖它
CURLOPT_FTPASCII
CURLOPT_TRANSFERTEXT的别名
CURLOPT_FTPLISTONLY
启用时只列出FTP目录的名字
CURLOPT_HEADER
启用时会将头文件的信息作为数据流输出
CURLINFO_HEADER_OUT
启用时追蹤句柄的请求字符串
从 PHP 开始可用CURLINFO_前缀是故意的(intentional)
CURLOPT_HTTPGET
启用时会设置HTTP的method为GET因为GET是默认是所以只在被修改的情况下使用
CURLOPT_HTTPPROXYTUNNEL
启用时会通过HTTP代理来传输
CURLOPT_MUTE
启用时将cURL函数中所有修改过的参数恢复默认值
CURLOPT_NETRC
在连接建立以后访问~/netrc文件获取用户名和密码信息连接远程站点
CURLOPT_NOBODY
启用时将不对HTML中的BODY部分进行输出
CURLOPT_NOPROGRESS
启用时关闭curl传输的进度条此项的默认设置为启用
Note:
PHP自动地设置这个选项为TRUE这个选项仅仅应当在以调试为目的时被改变
CURLOPT_NOSIGNAL
启用时忽略所有的curl传递给php进行的信号在SAPI多线程传输时此项被默认启用
cURL 时被加入
CURLOPT_POST
启用时会发送一个常规的POST请求类型为application/xwwwformurlencoded就像表单提交的一样
CURLOPT_PUT
启用时允许HTTP发送文件必须同时设置CURLOPT_INFILE和CURLOPT_INFILESIZE
CURLOPT_RETURNTRANSFER
将 curl_exec()获取的信息以文件流的形式返回而不是直接输出
CURLOPT_SSL_VERIFYPEER
禁 用后cURL将终止从服务端进行验证使用CURLOPT_CAINFO选项设置证书使用CURLOPT_CAPATH选项设置证书目录 如果CURLOPT_SSL_VERIFYPEER(默认值为)被启用CURLOPT_SSL_VERIFYHOST需要被设置成TRUE否则设置为 FALSE
自cURL 开始默认为TRUE从cURL 开始默认绑定安装
CURLOPT_TRANSFERTEXT
启用后对FTP传输使用ASCII模式对于LDAP它检索纯文本信息而非HTML在Windows系统上系统不会把STDOUT设置成binary模式
CURLOPT_UNRESTRICTED_AUTH
在使用CURLOPT_FOLLOWLOCATION产生的header中的多个locations中持续追加用户名和密码信息即使域名已发生改变
CURLOPT_UPLOAD
启用后允许文件上传
CURLOPT_VERBOSE
启用时会汇报所有的信息存放在STDERR或指定的CURLOPT_STDERR中
第二类
对于下面的这些option的可选参数value应该被设置一个integer类型的值
选项
可选value值
备注
CURLOPT_BUFFERSIZE
每次获取的数据中读入缓存的大小但是不保证这个值每次都会被填满
在cURL 中被加入
CURLOPT_CLOSEPOLICY
不是CURLCLOSEPOLICY_LEAST_RECENTLY_USED就是CURLCLOSEPOLICY_OLDEST还存在另外三个CURLCLOSEPOLICY_但是cURL暂时还不支持
CURLOPT_CONNECTTIMEOUT
在发起连接前等待的时间如果设置为则无限等待
CURLOPT_CONNECTTIMEOUT_MS
尝试连接等待的时间以毫秒为单位如果设置为则无限等待
在cURL 中被加入从PHP 开始可用
CURLOPT_DNS_CACHE_TIMEOUT
设置在内存中保存DNS信息的时间默认为秒
CURLOPT_FTPSSLAUTH
FTP验证方式CURLFTPAUTH_SSL (首先尝试SSL)CURLFTPAUTH_TLS (首先尝试TLS)或CURLFTPAUTH_DEFAULT (让cURL自动决定)
在cURL 中被加入
CURLOPT_HTTP_VERSION
CURL_HTTP_VERSION_NONE (默认值让cURL自己判断使用哪个版本)CURL_HTTP_VERSION__ (强制使用 HTTP/)或CURL_HTTP_VERSION__ (强制使用 HTTP/)
CURLOPT_HTTPAUTH
使用的HTTP验证方法可选的值有CURLAUTH_BASICCURLAUTH_DIGESTCURLAUTH_GSSNEGOTIATECURLAUTH_NTLMCURLAUTH_ANY和CURLAUTH_ANYSAFE
可以使用|位域(或)操作符分隔多个值cURL让服务器选择一个支持最好的值
CURLAUTH_ANY等价于CURLAUTH_BASIC | CURLAUTH_DIGEST | CURLAUTH_GSSNEGOTIATE | CURLAUTH_NTLM
CURLAUTH_ANYSAFE等价于CURLAUTH_DIGEST | CURLAUTH_GSSNEGOTIATE | CURLAUTH_NTLM
CURLOPT_INFILESIZE
设定上传文件的大小限制字节(byte)为单位
CURLOPT_LOW_SPEED_LIMIT
当传输速度小于CURLOPT_LOW_SPEED_LIMIT时(bytes/sec)PHP会根据CURLOPT_LOW_SPEED_TIME来判断是否因太慢而取消传输
CURLOPT_LOW_SPEED_TIME
当传输速度小于CURLOPT_LOW_SPEED_LIMIT时(bytes/sec)PHP会根据CURLOPT_LOW_SPEED_TIME来判断是否因太慢而取消传输
CURLOPT_MAXCONNECTS
允许的最大连接数量超过是会通过CURLOPT_CLOSEPOLICY决定应该停止哪些连接
CURLOPT_MAXREDIRS
指定最多的HTTP重定向的数量这个选项是和CURLOPT_FOLLOWLOCATION一起使用的
CURLOPT_PORT
用来指定连接端口（可选项）
CURLOPT_PROTOCOLS
CURLPROTO_* 的位域指如果被启用位域值会限定libcurl在传输过程中有哪些可使用的协议这将允许你在编译libcurl时支持众多协议但是限制只是用它们 中被允许使用的一个子集默认libcurl将会使用全部它支持的协议参见CURLOPT_REDIR_PROTOCOLS
可用的协议选项 为CURLPROTO_HTTPCURLPROTO_HTTPSCURLPROTO_FTPCURLPROTO_FTPS CURLPROTO_SCPCURLPROTO_SFTPCURLPROTO_TELNETCURLPROTO_LDAP CURLPROTO_LDAPSCURLPROTO_DICTCURLPROTO_FILECURLPROTO_TFTP CURLPROTO_ALL
在cURL 中被加入
CURLOPT_PROXYAUTH
HTTP代理连接的验证方式使用在CURLOPT_HTTPAUTH中的位域标志来设置相应选项对于代理验证只有CURLAUTH_BASIC和CURLAUTH_NTLM当前被支持
在cURL 中被加入
CURLOPT_PROXYPORT
代理服务器的端口端口也可以在CURLOPT_PROXY中进行设置
CURLOPT_PROXYTYPE
不是CURLPROXY_HTTP (默认值) 就是CURLPROXY_SOCKS
在cURL 中被加入
CURLOPT_REDIR_PROTOCOLS
CURLPROTO_* 中的位域值如果被启用位域值将会限制传输线程在CURLOPT_FOLLOWLOCATION开启时跟随某个重定向时可使用的协议这将使你对重定向 时限制传输线程使用被允许的协议子集默认libcurl将会允许除FILE和SCP之外的全部协议这个和预发布版本种无条件地跟随所有支持 的协议有一些不同关于协议常量请参照CURLOPT_PROTOCOLS
在cURL 中被加入
CURLOPT_RESUME_FROM
在恢复传输时传递一个字节偏移量（用来断点续传）
CURLOPT_SSL_VERIFYHOST
检查服务器SSL证书中是否存在一个公用名(common name)译者注公用名(Common Name)一般来讲就是填写你将要申请SSL证书的域名 (domain)或子域名(sub domain) 检查公用名是否存在并且是否与提供的主机名匹配
CURLOPT_SSLVERSION
使用的SSL版本( 或 )默认情况下PHP会自己检测这个值尽管有些情况下需要手动地进行设置
CURLOPT_TIMECONDITION
如 果在CURLOPT_TIMEVALUE指定的某个时间以后被编辑过则使用CURL_TIMECOND_IFMODSINCE返回页面如果没有被修改 过并且CURLOPT_HEADER为true则返回一个" Not Modified"的header CURLOPT_HEADER为false则使用CURL_TIMECOND_IFUNMODSINCE默认值为 CURL_TIMECOND_IFUNMODSINCE
CURLOPT_TIMEOUT
设置cURL允许执行的最长秒数
CURLOPT_TIMEOUT_MS
设置cURL允许执行的最长毫秒数
在cURL 中被加入从PHP 起可使用
CURLOPT_TIMEVALUE
设置一个CURLOPT_TIMECONDITION使用的时间戳在默认状态下使用的是CURL_TIMECOND_IFMODSINCE
第三类
对于下面的这些option的可选参数value应该被设置一个string类型的值
选项
可选value值
备注
CURLOPT_CAINFO
一个保存着个或多个用来让服务端验证的证书的文件名这个参数仅仅在和CURLOPT_SSL_VERIFYPEER一起使用时才有意义
CURLOPT_CAPATH
一个保存着多个CA证书的目录这个选项是和CURLOPT_SSL_VERIFYPEER一起使用的
CURLOPT_COOKIE
设定HTTP请求中"Cookie: "部分的内容多个cookie用分号分隔分号后带一个空格(例如 "fruit=apple; colour=red")
CURLOPT_COOKIEFILE
包含cookie数据的文件名cookie文件的格式可以是Netscape格式或者只是纯HTTP头部信息存入文件
CURLOPT_COOKIEJAR
连接结束后保存cookie信息的文件
CURLOPT_CUSTOMREQUEST
使 用一个自定义的请求信息来代替"GET"或"HEAD"作为HTTP请求这对于执行"DELETE" 或者其他更隐蔽的HTTP请求有效值如"GET""POST""CONNECT"等等也就是说不要在这里输入整个HTTP请求例如输 入"GET /indexhtml HTTP/rnrn"是不正确的
Note:
在确定服务器支持这个自定义请求的方法前不要使用
CURLOPT_EGDSOCKET
类似CURLOPT_RANDOM_FILE除了一个Entropy Gathering Daemon套接字
CURLOPT_ENCODING
HTTP请求头中"AcceptEncoding: "的值支持的编码有"identity""deflate"和"gzip"如果为空字符串""请求头会发送所有支持的编码类型
在cURL 中被加入
CURLOPT_FTPPORT
这个值将被用来获取供FTP"POST"指令所需要的IP地址"POST"指令告诉远程服务器连接到我们指定的IP地址这个字符串可以是纯文本的IP地址主机名一个网络接口名（UNIX下）或者只是一个来使用默认的IP地址
CURLOPT_INTERFACE
网络发送接口名可以是一个接口名IP地址或者是一个主机名
CURLOPT_KRBLEVEL
KRB (Kerberos ) 安全级别下面的任何值都是有效的(从低到高的顺序)"clear""safe""confidential""private"如果字符串 和这些都不匹配将使用"private"这个选项设置为NULL时将禁用KRB 安全认证目前KRB 安全认证只能用于FTP传输
CURLOPT_POSTFIELDS
全 部数据使用HTTP协议中的"POST"操作来发送要发送文件在文件名前面加上@前缀并使用完整路径这个参数可以通过urlencoded后的字符 串类似para=val¶=val&或使用一个以字段名为键值字段数据为值的数组如果value是一个数 组ContentType头将会被设置成multipart/formdata
CURLOPT_PROXY
HTTP代理通道
CURLOPT_PROXYUSERPWD
一个用来连接到代理的"[username]:[password]"格式的字符串
CURLOPT_RANDOM_FILE
一个被用来生成SSL随机数种子的文件名
CURLOPT_RANGE
以"XY"的形式其中X和Y都是可选项获取数据的范围以字节计HTTP传输线程也支持几个这样的重复项中间用逗号分隔如"XYNM"
CURLOPT_REFERER
在HTTP请求头中"Referer: "的内容
CURLOPT_SSL_CIPHER_LIST
一个SSL的加密算法列表例如RCSHA和TLSv都是可用的加密列表
CURLOPT_SSLCERT
一个包含PEM格式证书的文件名
CURLOPT_SSLCERTPASSWD
使用CURLOPT_SSLCERT证书需要的密码
CURLOPT_SSLCERTTYPE
证书的类型支持的格式有"PEM" (默认值) "DER"和"ENG"
在cURL 中被加入
CURLOPT_SSLENGINE
用来在CURLOPT_SSLKEY中指定的SSL私钥的加密引擎变量
CURLOPT_SSLENGINE_DEFAULT
用来做非对称加密操作的变量
CURLOPT_SSLKEY
包含SSL私钥的文件名
CURLOPT_SSLKEYPASSWD
在CURLOPT_SSLKEY中指定了的SSL私钥的密码
Note:
由于这个选项包含了敏感的密码信息记得保证这个PHP脚本的安全
CURLOPT_SSLKEYTYPE
CURLOPT_SSLKEY中规定的私钥的加密类型支持的密钥类型为"PEM"(默认值)"DER"和"ENG"
CURLOPT_URL
需要获取的URL地址也可以在 curl_init()函数中设置
CURLOPT_USERAGENT
在HTTP请求中包含一个"UserAgent: "头的字符串
CURLOPT_USERPWD
传递一个连接中需要的用户名和密码格式为"[username]:[password]"
第四类
对于下面的这些option的可选参数value应该被设置一个数组
选项
可选value值
备注
CURLOPT_HTTPALIASES
响应码数组数组中的响应吗被认为是正确的响应否则被认为是错误的
在cURL 中被加入
CURLOPT_HTTPHEADER
一个用来设置HTTP头字段的数组使用如下的形式的数组进行设置 array(Contenttype: text/plain Contentlength: )
CURLOPT_POSTQUOTE
在FTP请求执行完成后在服务器上执行的一组FTP命令
CURLOPT_QUOTE
一组先于FTP请求的在服务器上执行的FTP命令
对于下面的这些option的可选参数value应该被设置一个流资源 （例如使用 fopen()）
选项
可选value值
CURLOPT_FILE
设置输出文件的位置值是一个资源类型默认为STDOUT (浏览器)
CURLOPT_INFILE
在上传文件的时候需要读取的文件地址值是一个资源类型
CURLOPT_STDERR
设置一个错误输出地址值是一个资源类型取代默认的STDERR
CURLOPT_WRITEHEADER
设置header部分内容的写入的文件地址值是一个资源类型
对于下面的这些option的可选参数value应该被设置为一个回调函数名
选项
可选value值
CURLOPT_HEADERFUNCTION
设置一个回调函数这个函数有两个参数第一个是cURL的资源句柄第二个是输出的header数据header数据的输出必须依赖这个函数返回已写入的数据大小
CURLOPT_PASSWDFUNCTION
设置一个回调函数有三个参数第一个是cURL的资源句柄第二个是一个密码提示符第三个参数是密码长度允许的最大值返回密码的值
CURLOPT_PROGRESSFUNCTION
设置一个回调函数有三个参数第一个是cURL的资源句柄第二个是一个文件描述符资源第三个是长度返回包含的数据
CURLOPT_READFUNCTION
拥有两个参数的回调函数第一个是参数是会话句柄第二是HTTP响应头信息的字符串使用此函数将自行处理返回的数据返回值为数据大小以字节计返回代表EOF信号
CURLOPT_WRITEFUNCTION
拥有两个参数的回调函数第一个是参数是会话句柄第二是HTTP响应头信息的字符串使用此回调函数将自行处理响应头信息响应头信息是整个字符串设置返回值为精确的已写入字符串长度发生错误时传输线程终止
