PHP CURL 中文说明

1.CURL是利用URL语法在命令行方式下工作的开源文件传输工具。

2.它被广泛应用在Unix、多种Linux发行版中。而且有DOS和Win32、Win64下的移植版本号。

3.它支持非常多协议：FTP, FTPS, HTTP, HTTPS, GOPHER, TELNET, DICT, FILE 以及 LDAP。

4.CURL是瑞典CURLl组织开发的，您能够訪问: http://curl.haxx. se 获取它的源码和相关说明。

5.PHP CURL函数列表：

函数	描写叙述
curl_close()	关闭一个cURL会话。
curl_copy_handle()	复制一个cURL句柄和它的全部选项。
curl_errno()	返回最后一次的错误号。
curl_error()	返回一个保护当前会话近期一次错误的字符串。
curl_escape()	返回转义字符串。对给定的字符串进行URL编码。
curl_exec()	运行一个cURL会话。
curl_file_create()	创建一个 CURLFile 对象。
curl_getinfo()	获取一个cURL连接资源句柄的信息。
curl_init()	初始化一个cURL会话。
curl_multi_add_handle()	向curl批处理会话中加入单独的curl句柄。
curl_multi_close()	关闭一组cURL句柄。
curl_multi_exec()	执行当前 cURL 句柄的子连接。
curl_multi_getcontent()	假设设置了CURLOPT_RETURNTRANSFER，则返回获取的输出的文本流。
curl_multi_info_read()	获取当前解析的cURL的相关传输信息。
curl_multi_init()	返回一个新cURL批处理句柄。
curl_multi_remove_handle()	移除curl批处理句柄资源中的某个句柄资源。
curl_multi_select()	等待全部cURL批处理中的活动连接。
curl_multi_setopt()	设置一个批处理cURL传输选项。
curl_multi_strerror()	返回描写叙述错误码的字符串文本。
curl_pause()	暂停及恢复连接。
curl_reset()	重置libcurl的会话句柄的全部选项。
curl_setopt_array()	为cURL传输会话批量设置选项。
curl_setopt()	设置一个cURL传输选项。
curl_share_close()	关闭cURL共享句柄。
curl_share_init()	初始化cURL共享句柄。
curl_share_setopt()	设置一个共享句柄的cURL传输选项。
curl_strerror()	返回错误代码的字符串描写叙述。
curl_unescape()	解码URL编码后的字符串。
curl_version()	获取cURL版本号信息。

6.CURL开发基本步骤

（1）初始化：curl_init()

（2）设置变量：curl_setopt()或curl_setopt_array()

（3）运行并获取结果：curl_exec()

（4）释放CURL句柄：curl_close()

7.CURLOPT參数总结：

CURLOPT_AUTOREFERER

自己主动设置header中的referer信息



CURLOPT_BINARYTRANSFER

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



CURLOPT_COOKIESESSION

启用时curl会只传递一个session cookie，忽略其它的cookie，默认状况下curl会将全部的cookie返回给服务端。session cookie是指那些用来推断server端的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

启用时会将serverserver返回的“Location:”放在header中递归的返回给server，使用CURLOPT_MAXREDIRS能够限定递归返回的数量。



CURLOPT_FORBID_REUSE

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



CURLOPT_FRESH_CONNECT

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



CURLOPT_FTP_USE_EPRT



CURLOPT_FTP_USE_EPSV



CURLOPT_FTPAPPEND



CURLOPT_FTPASCII



CURLOPT_FTPLISTONLY



CURLOPT_HEADER

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



CURLOPT_HTTPGET

启用时会设置HTTP的method为GET。由于GET是默认是，所以仅仅在被改动的情况下使用。

CURLOPT_HTTPPROXYTUNNEL

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



CURLOPT_MUTE

讲curl函数中全部改动过的參数恢复默认值。



CURLOPT_NETRC

在连接建立以后，訪问~/.netrc文件获取username和password信息连接远程网站。



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



CURLOPT_TRANSFERTEXT



CURLOPT_UNRESTRICTED_AUTH

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



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



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让server选择一个支持最好的值，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

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



CURLOPT_PROXYAUTH



CURLOPT_PROXYPORT



CURLOPT_PROXYTYPE



CURLOPT_RESUME_FROM

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



CURLOPT_SSL_VERIFYHOST



CURLOPT_SSLVERSION



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_CAPATH



CURLOPT_COOKIE

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



CURLOPT_COOKIEFILE

包括cookie信息的文件名，这个cookie文件能够是Netscape格式或者HTTP风格的header信息。

CURLOPT_COOKIEJAR

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



CURLOPT_CUSTOMREQUEST



CURLOPT_EGBSOCKET



CURLOPT_ENCODING

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




CURLOPT_FTPPORT



CURLOPT_INTERFACE

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



CURLOPT_KRB4LEVEL

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




CURLOPT_POSTFIELDS

在HTTP中的“POST”操作。

假设要传送一个文件，须要一个@开头的文件名称



CURLOPT_PROXY

设置通过的HTTP代理server



CURLOPT_PROXYUSERPWD

连接到代理server的，格式为“[username]:[password]”的username与password。



CURLOPT_RANDOM_FILE

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



CURLOPT_RANGE

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



CURLOPT_REFERER

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



CURLOPT_SSL_CIPHER_LIST



CURLOPT_SSLCERT

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



CURLOPT_SSLCERTPASSWD

传递一个包括使用CURLOPT_SSLCERT证书必需的password。



CURLOPT_SSLCERTTYPE



CURLOPT_SSLENGINE



CURLOPT_SSLENGINE_DEFAULT



CURLOPT_SSLKEY



CURLOPT_SSLKEYPASSWD



CURLOPT_SSLKEYTYPE



CURLOPT_URL

须要获取的URL地址，也能够在PHP的curl_init()函数中设置。

CURLOPT_USERAGENT

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



CURLOPT_USERPWD

传递一个连接中须要的username与password。格式为：“[username]:[password]”。



CURLOPT_HTTP200ALIASES

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



CURLOPT_HTTPHEADER

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

CURLOPT_POSTQUOTE



CURLOPT_QUOTE



CURLOPT_FILE

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



CURLOPT_INFILE

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

CURLOPT_STDERR

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

CURLOPT_WRITEHEADER

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



CURLOPT_HEADERFUNCTION

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



CURLOPT_PASSWDFUNCTION

设置一个回调函数，有三个參数。第一个是curl的资源句柄，第二个是一个password提示符，第三个參数是password长度同意的最大值。

返回password的值。

CURLOPT_READFUNCTION

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

CURLOPT_WRITEFUNCTION

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

8.CURLINFO參数总结：

CURLINFO_EFFECTIVE_URL

最后一个有效的url地址



CURLINFO_HTTP_CODE

最后一个收到的HTTP代码



CURLINFO_FILETIME

远程获取文档的时间，假设无法获取，则返回值为“-1”



CURLINFO_TOTAL_TIME

最后一次传输所消耗的时间



CURLINFO_NAMELOOKUP_TIME

名称解析所消耗的时间



CURLINFO_CONNECT_TIME

建立连接所消耗的时间



CURLINFO_PRETRANSFER_TIME

从建立连接到准备传输所使用的时间



CURLINFO_STARTTRANSFER_TIME

从建立连接到传输開始所使用的时间



CURLINFO_REDIRECT_TIME

在事务传输開始前重定向所使用的时间



CURLINFO_SIZE_UPLOAD

上传数据量的总值



CURLINFO_SIZE_DOWNLOAD

下载数据量的总值



CURLINFO_SPEED_DOWNLOAD

平均下载速度



CURLINFO_SPEED_UPLOAD

平均上传速度



CURLINFO_HEADER_SIZE

header部分的大小



CURLINFO_HEADER_OUT

发送请求的字符串



CURLINFO_REQUEST_SIZE

在HTTP请求中有问题的请求的大小



CURLINFO_SSL_VERIFYRESULT



CURLINFO_CONTENT_LENGTH_DOWNLOAD

从Content-Length: field中读取的下载内容长度



CURLINFO_CONTENT_LENGTH_UPLOAD

上传内容大小的说明



CURLINFO_CONTENT_TYPE

下载内容的“Content-type”值，NULL表示server没有发送有效的“Content-Type: header”