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是指那些用来判断服务器端的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
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文件获取用户名和密码信息连接远程站点。
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中持续追加用户名和密码信息,即使域名已发生改变。
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让服务器选择一个支持最好的值,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
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代理服务器
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
curlopt_sslcert
传递一个包含pem格式证书的字符串。
curlopt_sslcertpasswd
传递一个包含使用curlopt_sslcert证书必需的密码。
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]”。
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的资源句柄,第二个是一个密码提示符,第三个参数是密码长度允许的最大值。返回密码的值。
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表示服务器没有发送有效的“content-type: header”