PHP CURL详解

声明：补充翻译了原帖中几处未翻译处。

---------------------------------------------------- 转帖开始 -------------------------------------------------------

 

PHP中的CURL函数库（Client URL Library Function） 

 

curl_close - 关闭一个curl会话 

curl_copy_handle - 拷贝一个curl连接资源的所有内容和参数 

curl_errno - 返回一个包含当前会话错误信息的数字编号 

curl_error - 返回一个包含当前会话错误信息的字符串 

curl_exec - 执行一个curl会话 

curl_getinfo - 获取一个curl连接资源句柄的信息 

curl_init - 初始化一个curl会话 

curl_multi_add_handle - 向curl批处理会话中添加单独的curl句柄资源 

curl_multi_close - 关闭一个批处理句柄资源 

curl_multi_exec - 解析一个curl批处理句柄 

curl_multi_getcontent - 返回获取的输出的文本流 

curl_multi_info_read - 获取当前解析的curl的相关传输信息 

curl_multi_init - 初始化一个curl批处理句柄资源 

curl_multi_remove_handle - 移除curl批处理句柄资源中的某个句柄资源 

curl_multi_select - Get all the sockets associated with the cURL extension, which can then be "selected" 

curl_setopt_array - 以数组的形式为一个curl设置会话参数 

curl_setopt - 为一个curl设置会话参数 

curl_version - 获取curl相关的版本信息 

 

curl_init()函数的作用初始化一个curl会话，curl_init()函数唯一的一个参数是可选的，表示一个url地址。 

curl_exec()函数的作用是执行一个curl会话，唯一的参数是curl_init()函数返回的句柄。 

curl_close()函数的作用是关闭一个curl会话，唯一的参数是curl_init()函数返回的句柄。

 

 

<?php $ch = curl_init("http://www.baidu.com/"); curl_exec($ch); curl_close($ch); ?>  

 

curl_version()函数的作用是获取curl相关的版本信息，curl_version()函数有一个参数，不清楚是做什么的 

 

可设置的参数有： 

 

CURLOPT_AUTOREFERER 

自动设置header中的referer信息 

 

CURLOPT_BINARYTRANSFER 

在启用CURLOPT_RETURNTRANSFER时候将获取数据返回 

 

CURLOPT_COOKIESESSION 

启用时curl会仅仅传递一个session cookie，忽略其他的cookie，默认状况下curl会将所有的cookie返回给服务端。session cookie是指那些用来判断服务器端的session是否有效而存在的cookie。 

 

CURLOPT_CRLF 

启用时将Unix的换行符转换成回车换行符。 

 

CURLOPT_DNS_USE_GLOBAL_CACHE 

启用时会启用一个全局的DNS缓存，此项为线程安全的，并且默认为true。 

 

CURLOPT_FAILONERROR 

显示HTTP状态码，默认行为是忽略编号小于等于400的HTTP信息 

 

CURLOPT_FILETIME 

启用时会尝试修改远程文档中的信息。结果信息会通过curl_getinfo()函数的CURLINFO_FILETIME选项返回。 

 

CURLOPT_FOLLOWLOCATION 

启用时会将服务器服务器返回的"Location:"放在header中递归的返回给服务器，使用CURLOPT_MAXREDIRS可以限定递归返回的数量。 

 

CURLOPT_FORBID_REUSE 

在完成交互以后强迫断开连接，不能重用。 

 

CURLOPT_FRESH_CONNECT 

强制获取一个新的连接，替代缓存中的连接。 

 

CURLOPT_FTP_USE_EPRT 

TRUE：FTP下载时使用EPRT（和LPRT）

FALSE：FTP下载时只使用PORT

 

CURLOPT_FTP_USE_EPSV 

TRUE to first try an EPSV command for FTP transfers before reverting back to PASV. Set to FALSE to disable EPSV. 

 

CURLOPT_FTPAPPEND 

TRUE to append to the remote file instead of overwriting it. 

 

CURLOPT_FTPASCII 

An alias of CURLOPT_TRANSFERTEXT. Use that instead. 

 

CURLOPT_FTPLISTONLY 

TRUE：列出FTP目录列表

 

CURLOPT_HEADER 

启用时会将头文件的信息作为数据流输出。 

 

CURLOPT_HTTPGET 

启用时会设置HTTP的method为GET，因为GET是默认是，所以只在被修改的情况下使用。 

 

CURLOPT_HTTPPROXYTUNNEL 

启用时会通过HTTP代理来传输。 

 

CURLOPT_MUTE 

讲curl函数中所有修改过的参数恢复默认值。 

 

CURLOPT_NETRC 

在连接建立以后，访问~/.netrc文件获取用户名和密码信息连接远程站点。 

 

CURLOPT_NOBODY 

启用时将不对HTML中的body部分进行输出。 

 

CURLOPT_NOPROGRESS 

启用时关闭curl传输的进度条，此项的默认设置为true 

 

CURLOPT_NOSIGNAL 

启用时忽略所有的curl传递给php进行的信号。在SAPI多线程传输时此项被默认打开。 

 

CURLOPT_POST 

启用时会发送一个常规的POST请求，类型为：application/x-www-form-urlencoded，就像表单提交的一样。 

 

CURLOPT_PUT 

启用时允许HTTP发送文件，必须同时设置CURLOPT_INFILE和CURLOPT_INFILESIZE 

 

CURLOPT_RETURNTRANSFER 

将curl_exec()获取的信息以文件流的形式返回，而不是直接输出。 

 

CURLOPT_SSL_VERIFYPEER 

FALSE to stop cURL from verifying the peer's certificate. Alternate certificates to verify against can be specified with the CURLOPT_CAINFO option or a certificate directory can be specified with the CURLOPT_CAPATH option. CURLOPT_SSL_VERIFYHOST may also need to be TRUE or FALSE if CURLOPT_SSL_VERIFYPEER is disabled (it defaults to 2). TRUE by default as of cURL 7.10. Default bundle installed as of cURL 7.10. 

 

CURLOPT_TRANSFERTEXT 

TRUE to use ASCII mode for FTP transfers. For LDAP, it retrieves data in plain text instead of HTML. On Windows systems, it will not set STDOUT to binary mode. 

 

CURLOPT_UNRESTRICTED_AUTH 

在使用CURLOPT_FOLLOWLOCATION产生的header中的多个locations中持续追加用户名和密码信息，即使域名已发生改变。 

 

CURLOPT_UPLOAD 

启用时允许文件传输 

 

CURLOPT_VERBOSE 

启用时会汇报所有的信息，存放在STDERR或指定的CURLOPT_STDERR中 

 

CURLOPT_BUFFERSIZE 

每次获取的数据中读入缓存的大小，这个值每次都会被填满。 

 

CURLOPT_CLOSEPOLICY 

不是CURLCLOSEPOLICY_LEAST_RECENTLY_USED就是CURLCLOSEPOLICY_OLDEST，还存在另外三个，但是curl暂时还不支持。. 

 

CURLOPT_CONNECTTIMEOUT 

在发起连接前等待的时间，如果设置为0，则不等待。 

 

CURLOPT_DNS_CACHE_TIMEOUT 

设置在内存中保存DNS信息的时间，默认为120秒。 

 

CURLOPT_FTPSSLAUTH 

The FTP authentication method (when is activated): CURLFTPAUTH_SSL (try SSL first), CURLFTPAUTH_TLS (try TLS first), or CURLFTPAUTH_DEFAULT (let cURL decide). 

 

CURLOPT_HTTP_VERSION 

设置curl使用的HTTP协议，CURL_HTTP_VERSION_NONE（让curl自己判断），CURL_HTTP_VERSION_1_0（HTTP/1.0），CURL_HTTP_VERSION_1_1（HTTP/1.1） 

 

CURLOPT_HTTPAUTH 

使用的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_INFILESIZE 

设定上传文件的大小 

 

CURLOPT_LOW_SPEED_LIMIT 

当传输速度小于CURLOPT_LOW_SPEED_LIMIT时，PHP会根据CURLOPT_LOW_SPEED_TIME来判断是否因太慢而取消传输。 

 

CURLOPT_LOW_SPEED_TIME 

The number of seconds the transfer should be below CURLOPT_LOW_SPEED_LIMIT for PHP to consider the transfer too slow and abort. 

当传输速度小于CURLOPT_LOW_SPEED_LIMIT时，PHP会根据CURLOPT_LOW_SPEED_TIME来判断是否因太慢而取消传输。 

 

CURLOPT_MAXCONNECTS 

允许的最大连接数量，超过是会通过CURLOPT_CLOSEPOLICY决定应该停止哪些连接 

 

CURLOPT_MAXREDIRS 

指定最多的HTTP重定向的数量，这个选项是和CURLOPT_FOLLOWLOCATION一起使用的。 

 

CURLOPT_PORT 

一个可选的用来指定连接端口的量 

 

CURLOPT_PROXYAUTH 

为代理链接使用HTTP验证方法. 使用相同的位屏蔽描述在CURLOPT_HTTPAUTH。对于代理身份验证，目前只支持CURLAUTH_BASIC和CURLAUTH_NTLM。

 

CURLOPT_PROXYPORT 

要连接的代理的端口. 该端口号也能在 CURLOPT_PROXY 中设置. 

 

CURLOPT_PROXYTYPE 

CURLPROXY_HTTP (默认) 或者 CURLPROXY_SOCKS5. 

 

CURLOPT_RESUME_FROM 

在恢复传输时传递一个字节偏移量（用来断点续传） 

 

CURLOPT_SSL_VERIFYHOST 

1，检查在SSL证书存在一个共用的名字。

2，检查存在一个共用的名字，并验证它与提供的主机名匹配。

 

 

CURLOPT_SSLVERSION 

使用SSL的版本（2或3）。默认情况下PHP将试图自己确定，尽管在某些情况下必须手动设置。

 

CURLOPT_TIMECONDITION 

如果在CURLOPT_TIMEVALUE指定的某个时间以后被编辑过，则使用CURL_TIMECOND_IFMODSINCE返回页面，如果没有被修改过，并且CURLOPT_HEADER为true，则返回一个"304 Not Modified"的header，CURLOPT_HEADER为false，则使用CURL_TIMECOND_ISUNMODSINCE，默认值为 CURL_TIMECOND_IFMODSINCE 

 

CURLOPT_TIMEOUT 

设置curl允许执行的最长秒数 

 

CURLOPT_TIMEVALUE 

设置一个CURLOPT_TIMECONDITION使用的时间戳，在默认状态下使用的是CURL_TIMECOND_IFMODSINCE 

 

CURLOPT_CAINFO 

一个文件持有一个或多个证书去验证。这仅与CURLOPT_SSL_VERIFYPEER结合使用。

 

CURLOPT_CAPATH 

一个目录拥有多个CA证书。使用该选项同时使用CURLOPT_SSL_VERIFYPEER。

 

CURLOPT_COOKIE 

设定HTTP请求中"Set-Cookie:"部分的内容。 

 

CURLOPT_COOKIEFILE 

包含cookie信息的文件名称，这个cookie文件可以是Netscape格式或者HTTP风格的header信息。 

 

CURLOPT_COOKIEJAR 

连接关闭以后，存放cookie信息的文件名称 

 

CURLOPT_CUSTOMREQUEST 

HTTP请求时自定义请求方法，而不是使用“GET”或“HEAD”。这是很有用的当“DELETE”或其他更隐蔽的HTTP请求。有效的值如“GET”、“POST”、“CONNECT”等。也就是说不要输入整个HTTP请求。例如，输入“GET /index.html HTTP/1.0/r/n/r/n”的将是不正确的。

 

CURLOPT_EGBSOCKET 

Like CURLOPT_RANDOM_FILE, except a filename to an Entropy Gathering Daemon socket. 

 

CURLOPT_ENCODING 

header中"Accept-Encoding: "部分的内容，支持的编码格式为："identity"，"deflate"，"gzip"。如果设置为空字符串，则表示支持所有的编码格式 

 

CURLOPT_FTPPORT 

用于为FTP使用“POST”获取IP地址。 “POST”指令告诉远程服务器连接到我们指定的IP地址。这个字符串可以是一个IP地址，主机名，一个网络接口的名称（Unix），或者只是一个普通的' - '来使用系统默认的IP地址。

 

CURLOPT_INTERFACE 

在外部网络接口中使用的名称，可以是一个接口名，IP或者主机名。 

 

CURLOPT_KRB4LEVEL 

KRB4(Kerberos 4)安全级别的设置，可以是一下几个值之一："clear"，"safe"，"confidential"，"private"。默认的值为"private"，设置为null的时候表示禁用KRB4，现在KRB4安全仅能在FTP传输中使用。 

 

CURLOPT_POSTFIELDS 

在HTTP中的"POST"操作。如果要传送一个文件，需要一个@开头的文件名 

 

CURLOPT_PROXY 

设置通过的HTTP代理服务器 

 

CURLOPT_PROXYUSERPWD 

连接到代理服务器的，格式为"[username]:[password]"的用户名和密码。 

 

CURLOPT_RANDOM_FILE 

设定存放SSL用到的随机数种子的文件名称 

 

CURLOPT_RANGE 

设置HTTP传输范围，可以用"X-Y"的形式设置一个传输区间，如果有多个HTTP传输，则使用逗号分隔多个值，形如："X-Y,N-M"。 

 

CURLOPT_REFERER 

设置header中"Referer: " 部分的值。 

 

CURLOPT_SSL_CIPHER_LIST 

供SSL使用的加密列表。例如，RC4-SHA和TLSv1是有效的加密列表。

 

CURLOPT_SSLCERT 

传递一个包含PEM格式证书的字符串。 

 

CURLOPT_SSLCERTPASSWD 

传递一个包含使用CURLOPT_SSLCERT证书必需的密码。 

 

CURLOPT_SSLCERTTYPE 

证书的格式. 支持的格式有"PEM" (默认), "DER", 和 "ENG"。

 

CURLOPT_SSLENGINE 

The identifier for the crypto engine of the private SSL key specified in CURLOPT_SSLKEY. 

在CURLOPT_SSLKEY中为SSL私钥指定加密引擎标识。

 

CURLOPT_SSLENGINE_DEFAULT 

为非对称加密使用的加密引擎标识。

 

CURLOPT_SSLKEY 

文件包含的一个SSL私钥名。

 

CURLOPT_SSLKEYPASSWD 

密码需要在CURLOPT_SSLKEY中使用SSL私钥指定。

注意：由于此选项包含一个敏感的密码，记住保持PHP脚本是安全的（即不能非法访问）。

 

CURLOPT_SSLKEYTYPE 

在CURLOPT_SSLKEY指定的SSL私钥密钥类型。支持类型有“PEM”（默认），“DER”和“ENG”。

 

CURLOPT_URL 

需要获取的URL地址，也可以在PHP的curl_init()函数中设置。 

 

CURLOPT_USERAGENT 

在HTTP请求中包含一个"user-agent"头的字符串。 

 

CURLOPT_USERPWD 

传递一个连接中需要的用户名和密码，格式为："[username]:[password]"。 

 

CURLOPT_HTTP200ALIASES 

设置不再以error的形式来处理HTTP 200的响应，格式为一个数组。 

 

CURLOPT_HTTPHEADER 

设置一个header中传输内容的数组。 

 

CURLOPT_POSTQUOTE 

An array of FTP commands to execute on the server after the FTP request has been performed. 

 

CURLOPT_QUOTE 

An array of FTP commands to execute on the server prior to the FTP request. 

 

CURLOPT_FILE 

设置输出文件的位置，值是一个资源类型，默认为STDOUT (浏览器)。 

 

CURLOPT_INFILE 

在上传文件的时候需要读取的文件地址，值是一个资源类型。 

 

CURLOPT_STDERR 

设置一个错误输出地址，值是一个资源类型，取代默认的STDERR。 

 

CURLOPT_WRITEHEADER 

设置header部分内容的写入的文件地址，值是一个资源类型。 

 

CURLOPT_HEADERFUNCTION 

设置一个回调函数，这个函数有两个参数，第一个是curl的资源句柄，第二个是输出的header数据。header数据的输出必须依赖这个函数，返回已写入的数据大小。 

 

CURLOPT_PASSWDFUNCTION 

设置一个回调函数，有三个参数，第一个是curl的资源句柄，第二个是一个密码提示符，第三个参数是密码长度允许的最大值。返回密码的值。 

 

CURLOPT_READFUNCTION 

设置一个回调函数，有两个参数，第一个是curl的资源句柄，第二个是读取到的数据。数据读取必须依赖这个函数。返回读取数据的大小，比如0或者EOF。 

 

CURLOPT_WRITEFUNCTION 

设置一个回调函数，有两个参数，第一个是curl的资源句柄，第二个是写入的数据。数据写入必须依赖这个函数。返回精确的已写入数据的大小 

 

curl_copy_handle()函数的作用是拷贝一个curl连接资源的所有内容和参数 

 

<?php $ch = curl_init("http://www.baidu.com/"); $another = curl_copy_handle($ch); curl_exec($another); curl_close($another); ?> curl_exec($another); curl_close($another); ?>  

 

curl_error()函数的作用是返回一个包含当前会话错误信息的字符串。 

curl_errno()函数的作用是返回一个包含当前会话错误信息的数字编号。 

curl_multi_init()函数的作用是初始化一个curl批处理句柄资源。 

curl_multi_add_handle()函数的作用是向curl批处理会话中添加单独的curl句柄资源。curl_multi_add_handle()函数有两个参数，第一个参数表示一个curl批处理句柄资源，第二个参数表示一个单独的curl句柄资源。 

curl_multi_exec()函数的作用是解析一个curl批处理句柄，curl_multi_exec()函数有两个参数，第一个参数表示一个批处理句柄资源，第二个参数是一个引用值的参数，表示剩余需要处理的单个的curl句柄资源数量。 

curl_multi_remove_handle()函数表示移除curl批处理句柄资源中的某个句柄资源，curl_multi_remove_handle()函数有两个参数，第一个参数表示一个curl批处理句柄资源，第二个参数表示一个单独的curl句柄资源。 

curl_multi_close()函数的作用是关闭一个批处理句柄资源。 

 

 

<?php $ch1 = curl_init(); $ch2 = curl_init(); curl_setopt($ch1, CURLOPT_URL, "http://www.baidu.com/"); curl_setopt($ch1, CURLOPT_HEADER, 0); curl_setopt($ch2, CURLOPT_URL, "http://www.google.com/"); curl_setopt($ch2, CURLOPT_HEADER, 0); $mh = curl_multi_init(); curl_multi_add_handle($mh,$ch1); curl_multi_add_handle($mh,$ch2); do { curl_multi_exec($mh,$flag); } while ($flag > 0); curl_multi_remove_handle($mh,$ch1); curl_multi_remove_handle($mh,$ch2); curl_multi_close($mh); ?>  

 

curl_multi_getcontent()函数的作用是在设置了CURLOPT_RETURNTRANSFER的情况下，返回获取的输出的文本流。 

 

curl_multi_info_read()函数的作用是获取当前解析的curl的相关传输信息。 

 

curl_multi_select() Get all the sockets associated with the cURL extension, which can then be "selected"