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-GetallthesocketsassociatedwiththecURLextension,whichcanthenbe"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()函数返回的句柄。

$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会仅仅传递一个sessioncookie,忽略其他的cookie,默认状况下curl会将所有的cookie返回给服务端。sessioncookie是指那些用来判断服务器端的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

TRUEtouseEPRT(andLPRT)whendoingactiveFTPdownloads.UseFALSEtodisableEPRTandLPRTandusePORTonly.

AddedinPHP5.0.0.

CURLOPT_FTP_USE_EPSV

TRUEtofirsttryanEPSVcommandforFTPtransfersbeforerevertingbacktoPASV.SettoFALSEtodisableEPSV.

CURLOPT_FTPAPPEND

TRUEtoappendtotheremotefileinsteadofoverwritingit.

CURLOPT_FTPASCII

AnaliasofCURLOPT_TRANSFERTEXT.Usethatinstead.

CURLOPT_FTPLISTONLY

TRUEtoonlylistthenamesofanFTPdirectory.

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

FALSEtostopcURLfromverifyingthepeer'scertificate.AlternatecertificatestoverifyagainstcanbespecifiedwiththeCURLOPT_CAINFOoptionoracertificatedirectorycanbespecifiedwiththeCURLOPT_CAPATHoption.CURLOPT_SSL_VERIFYHOSTmayalsoneedtobeTRUEorFALSEifCURLOPT_SSL_VERIFYPEERisdisabled(itdefaultsto2).TRUEbydefaultasofcURL7.10.DefaultbundleinstalledasofcURL7.10.

CURLOPT_TRANSFERTEXT

TRUEtouseASCIImodeforFTPtransfers.ForLDAP,itretrievesdatainplaintextinsteadofHTML.OnWindowssystems,itwillnotsetSTDOUTtobinarymode.

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

TheFTPauthenticationmethod(whenisactivated):CURLFTPAUTH_SSL(trySSLfirst),CURLFTPAUTH_TLS(tryTLSfirst),orCURLFTPAUTH_DEFAULT(letcURLdecide).

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

ThenumberofsecondsthetransfershouldbebelowCURLOPT_LOW_SPEED_LIMITforPHPtoconsiderthetransfertooslowandabort.

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

CURLOPT_MAXCONNECTS

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

CURLOPT_MAXREDIRS

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

CURLOPT_PORT

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

CURLOPT_PROXYAUTH

TheHTTPauthenticationmethod(s)tousefortheproxyconnection.UsethesamebitmasksasdescribedinCURLOPT_HTTPAUTH.Forproxyauthentication,onlyCURLAUTH_BASICandCURLAUTH_NTLMarecurrentlysupported.

CURLOPT_PROXYPORT

Theportnumberoftheproxytoconnectto.ThisportnumbercanalsobesetinCURLOPT_PROXY.

CURLOPT_PROXYTYPE

EitherCURLPROXY_HTTP(default)orCURLPROXY_SOCKS5.

CURLOPT_RESUME_FROM

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

CURLOPT_SSL_VERIFYHOST

1tochecktheexistenceofacommonnameintheSSLpeercertificate.

2tochecktheexistenceofacommonnameandalsoverifythatitmatchesthehostnameprovided.

CURLOPT_SSLVERSION

TheSSLversion(2or3)touse.BydefaultPHPwilltrytodeterminethisitself,althoughinsomecasesthismustbesetmanually.

CURLOPT_TIMECONDITION

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

CURLOPT_TIMEOUT

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

CURLOPT_TIMEVALUE

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

CURLOPT_CAINFO

Thenameofafileholdingoneormorecertificatestoverifythepeerwith.ThisonlymakessensewhenusedincombinationwithCURLOPT_SSL_VERIFYPEER.

CURLOPT_CAPATH

AdirectorythatholdsmultipleCAcertificates.UsethisoptionalongsideCURLOPT_SSL_VERIFYPEER.

CURLOPT_COOKIE

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

CURLOPT_COOKIEFILE

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

CURLOPT_COOKIEJAR

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

CURLOPT_CUSTOMREQUEST

Acustomrequestmethodtouseinsteadof"GET"or"HEAD"whendoingaHTTPrequest.Thisisusefulfordoing"DELETE"orother,moreobscureHTTPrequests.Validvaluesarethingslike"GET","POST","CONNECT"andsoon;i.e.DonotenterawholeHTTPrequestlinehere.Forinstance,entering"GET/index.htmlHTTP/1.0\r\n\r\n"wouldbeincorrect.

Note:Don'tdothiswithoutmakingsuretheserversupportsthecustomrequestmethodfirst.

CURLOPT_EGBSOCKET

LikeCURLOPT_RANDOM_FILE,exceptafilenametoanEntropyGatheringDaemonsocket.

CURLOPT_ENCODING

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

CURLOPT_FTPPORT

ThevaluewhichwillbeusedtogettheIPaddresstousefortheFTP"POST"instruction.The"POST"instructiontellstheremoteservertoconnecttoourspecifiedIPaddress.ThestringmaybeaplainIPaddress,ahostname,anetworkinterfacename(underUnix),orjustaplain'-'tousethesystemsdefaultIPaddress.

CURLOPT_INTERFACE

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

CURLOPT_KRB4LEVEL

KRB4(Kerberos4)安全级别的设置,可以是一下几个值之一:"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

AlistofcipherstouseforSSL.Forexample,RC4-SHAandTLSv1arevalidcipherlists.

CURLOPT_SSLCERT

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

CURLOPT_SSLCERTPASSWD

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

CURLOPT_SSLCERTTYPE

Theformatofthecertificate.Supportedformatsare"PEM"(default),"DER",and"ENG".

CURLOPT_SSLENGINE

TheidentifierforthecryptoengineoftheprivateSSLkeyspecifiedinCURLOPT_SSLKEY.

CURLOPT_SSLENGINE_DEFAULT

Theidentifierforthecryptoengineusedforasymmetriccryptooperations.

CURLOPT_SSLKEY

ThenameofafilecontainingaprivateSSLkey.

CURLOPT_SSLKEYPASSWD

ThesecretpasswordneededtousetheprivateSSLkeyspecifiedinCURLOPT_SSLKEY.

Note:Sincethisoptioncontainsasensitivepassword,remembertokeepthePHPscriptitiscontainedwithinsafe.

CURLOPT_SSLKEYTYPE

ThekeytypeoftheprivateSSLkeyspecifiedinCURLOPT_SSLKEY.Supportedkeytypesare"PEM"(default),"DER",and"ENG".

CURLOPT_URL

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

CURLOPT_USERAGENT

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

CURLOPT_USERPWD

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

CURLOPT_HTTP200ALIASES

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

CURLOPT_HTTPHEADER

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

CURLOPT_POSTQUOTE

AnarrayofFTPcommandstoexecuteontheserveraftertheFTPrequesthasbeenperformed.

CURLOPT_QUOTE

AnarrayofFTPcommandstoexecuteontheserverpriortotheFTPrequest.

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连接资源的所有内容和参数

$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()函数的作用是关闭一个批处理句柄资源。

$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()

GetallthesocketsassociatedwiththecURLextension,whichcanthenbe"selected"

相关推荐