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