zoukankan      html  css  js  c++  java
  • 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”


  • 相关阅读:
    Python:字典
    Linux基础:dirname命令总结
    (三)封装与类
    (二)Java编程基础
    Ubuntu18.04 安装QQ、Tim、微信与win无差异
    (一)JDK安装和使用eclipse输出hello world
    Java复习目录
    (八)MySQL事务、视图、变量、存储过程、函数、流程控制结构
    (七)MySQL常见的数据类型、约束和标识列
    (六)MySQL数据、库、表的管理
  • 原文地址:https://www.cnblogs.com/blfbuaa/p/7252612.html
Copyright © 2011-2022 走看看