首页 > 代码库 > CURL

CURL

  1. 1.cURL介绍

      cURL 是一个利用URL语法规定来传输文件和数据的工具,支持很多协议,如HTTP、FTP、TELNET等。最爽的是,PHP也支持 cURL 库。本文将介绍 cURL 的一些高级特性,以及在PHP中如何运用它。

    2.基本结构

      在学习更为复杂的功能之前,先来看一下在PHP中建立cURL请求的基本步骤:

      (1)初始化


        curl_init()

      (2)设置变量


        curl_setopt() 。最为重要,一切玄妙均在此。有一长串cURL参数可供设置,它们能指定URL请求的各个细节。要一次性全部看完并理解可能比较困难,所以今天我们只试一下那些更常用也更有用的选项。

      (3)执行并获取结果


        curl_exec()

      (4)释放cURL句柄


        curl_close()

    3.cURL实现Get和Post

    3.1 Get方式实现

    复制代码代码如下:

      //初始化
      $ch = curl_init();

     

      //设置选项,包括URL
      curl_setopt($ch, CURLOPT_URL, "http://www.jb51.net");
      curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
      curl_setopt($ch, CURLOPT_HEADER, 0);

      //执行并获取HTML文档内容
      $output = curl_exec($ch);

      //释放curl句柄
      curl_close($ch);

      //打印获得的数据
      print_r($output);


    3.2 Post方式实现
    复制代码代码如下:

       $url = "http://localhost/web_services.php";
      $post_data = http://www.mamicode.com/array ("username" => "bob","key" => "12345");

     

      $ch = curl_init();

      curl_setopt($ch, CURLOPT_URL, $url);
      curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
      // post数据
      curl_setopt($ch, CURLOPT_POST, 1);
      // post的变量
      curl_setopt($ch, CURLOPT_POSTFIELDS, $post_data);

      $output = curl_exec($ch);
      curl_close($ch);

      //打印获得的数据
      print_r($output);

      


      以上方式获取到的数据是json格式的,使用json_decode函数解释成数组。

     

      $output_array = json_decode($output,true);

      如果使用json_decode($output)解析的话,将会得到object类型的数据。

    如对本文有疑问,请提交到交流社区,广大热心网友会为你解答!! 点击进入社区

  2. PHP中的CURL函数库(Client URL Library Function
  3. curl_close  关闭一个curl会话;
  4. curl_copy_handle  拷贝一个curl连接资源的所有内容和参数;
  5. curl_errno  返回一个包含当前会话错误信息的数字编号;
  6. curl_error  返回一个包含当前会话错误信息的字符串;
  7. curl_exec  执行一个curl会话;
  8. curl_getinfo  获取一个curl连接资源句柄的信息;
  9. curl_init  初始化一个curl会话;
  10. curl_multi_add_handle  curl批处理会话中添加单独的curl句柄资源;
  11. curl_multi_close  关闭一个批处理句柄资源;
  12. curl_multi_exec  解析一个curl批处理句柄;
  13. curl_multi_getcontent  返回获取的输出的文本流;
  14. curl_multi_info_read  获取当前解析的curl的相关传输信息;
  15. curl_multi_init  初始化一个curl批处理句柄资源;
  16. curl_multi_remove_handle  移除curl批处理句柄资源中的某个句柄资源;
  17. curl_multi_select  Get all the sockets associated with the cURL extension, which can then be "selected"
  18. curl_setopt_array  以数组的形式为一个curl设置会话参数;
  19. curl_setopt  为一个curl设置会话参数;
  20. curl_version  获取curl相关的版本信息;
  21. curl_init()函数的作用初始化一个curl会话,curl_init()函数唯一的一个参数是可选的,表示一个url地址;
  22. curl_exec()函数的作用是执行一个curl会话,唯一的参数是curl_init()函数返回的句柄;
  23. curl_close()函数的作用是关闭一个curl会话,唯一的参数是curl_init()函数返回的句柄;
  24.  
  25. curl_version()函数的作用是获取curl相关的版本信息,curl_version()函数有一个参数,不清楚是做什么的;
  26.  
  27. curl_getinfo()函数的作用是获取一个curl连接资源句柄的信息,curl_getinfo()函数有两个参数,第一个参数是curl的资源句柄,第二个参数是下面一些常量:
  28.  
  29.  可选的常量包括:
  30. CURLINFO_EFFECTIVE_URL:最后一个有效的url地址;
  31. CURLINFO_HTTP_CODE:最后一个收到的HTTP代码;
  32. CURLINFO_FILETIME:远程获取文档的时间,如果无法获取,则返回值为“-1”;
  33. CURLINFO_TOTAL_TIME:最后一次传输所消耗的时间;
  34. CURLINFO_NAMELOOKUP_TIME:名称解析所消耗的时间;
  35. CURLINFO_CONNECT_TIME:建立连接所消耗的时间;
  36. CURLINFO_PRETRANSFER_TIME:从建立连接到准备传输所使用的时间;
  37. CURLINFO_STARTTRANSFER_TIME:从建立连接到传输开始所使用的时间;
  38. CURLINFO_REDIRECT_TIME:在事务传输开始前重定向所使用的时间;
  39. CURLINFO_SIZE_UPLOAD:上传数据量的总值;
  40. CURLINFO_SIZE_DOWNLOAD:下载数据量的总值;
  41. CURLINFO_SPEED_DOWNLOAD:平均下载速度;
  42. CURLINFO_SPEED_UPLOAD:平均上传速度;
  43. CURLINFO_HEADER_SIZEheader部分的大小;
  44. CURLINFO_HEADER_OUT:发送请求的字符串;
  45. CURLINFO_REQUEST_SIZE:在HTTP请求中有问题的请求的大小;
  46. CURLINFO_SSL_VERIFYRESULTResult of SSL certification verification requested by setting CURLOPT_SSL_VERIFYPEER
  47. CURLINFO_CONTENT_LENGTH_DOWNLOAD:从Content-Length: field中读取的下载内容长度;
  48. CURLINFO_CONTENT_LENGTH_UPLOAD:上传内容大小的说明;
  49. CURLINFO_CONTENT_TYPE:下载内容的“Content-type”值,NULL表示服务器没有发送有效的“Content-Type: header”;
  50. curl_setopt()函数的作用是为一个curl设置会话参数。curl_setopt_array()函数的作用是以数组的形式为一个curl设置会话参数;
  51.  可设置的参数有:
  52. CURLOPT_AUTOREFERER:自动设置header中的referer信息;
  53. CURLOPT_BINARYTRANSFER:在启用CURLOPT_RETURNTRANSFER时候将获取数据返回;
  54. CURLOPT_COOKIESESSION:启用时curl会仅仅传递一个session cookie,忽略其他的cookie,默认状况下curl会将所有的cookie返回给服务端。session cookie是指那些用来判断服务器端的session是否有效而存在的cookie
  55. CURLOPT_CRLF:启用时将Unix的换行符转换成回车换行符;
  56. CURLOPT_DNS_USE_GLOBAL_CACHE:启用时会启用一个全局的DNS缓存,此项为线程安全的,并且默认为true
  57. CURLOPT_FAILONERROR:显示HTTP状态码,默认行为是忽略编号小于等于400HTTP信息;
  58. CURLOPT_FILETIME:启用时会尝试修改远程文档中的信息。结果信息会通过curl_getinfo()函数的CURLINFO_FILETIME选项返回;
  59. CURLOPT_FOLLOWLOCATION:启用时会将服务器服务器返回的“Location:”放在header中递归的返回给服务器,使用CURLOPT_MAXREDIRS可以限定递归返回的数量;
  60. CURLOPT_FORBID_REUSE:在完成交互以后强迫断开连接,不能重用;
  61. CURLOPT_FRESH_CONNECT:强制获取一个新的连接,替代缓存中的连接;
  62. CURLOPT_HEADER:启用时会将头文件的信息作为数据流输出;
  63. CURLOPT_HTTPGET:启用时会设置HTTPmethodGET,因为GET是默认是,所以只在被修改的情况下使用;
  64. CURLOPT_HTTPPROXYTUNNEL:启用时会通过HTTP代理来传输;
  65. CURLOPT_MUTE:讲curl函数中所有修改过的参数恢复默认值;
  66. CURLOPT_NETRC:在连接建立以后,访问~/.netrc文件获取用户名和密码信息连接远程站点;
  67. CURLOPT_NOBODY:启用时将不对HTML中的body部分进行输出;
  68. CURLOPT_NOPROGRESS:启用时关闭curl传输的进度条,此项的默认设置为true
  69. CURLOPT_NOSIGNAL:启用时忽略所有的curl传递给php进行的信号。在SAPI多线程传输时此项被默认打开;
  70. CURLOPT_POST:启用时会发送一个常规的POST请求,类型为:application/x-www-form-urlencoded,就像表单提交的一样;
  71. CURLOPT_PUT:启用时允许HTTP发送文件,必须同时设置CURLOPT_INFILECURLOPT_INFILESIZE
  72. CURLOPT_RETURNTRANSFER:将curl_exec()获取的信息以文件流的形式返回,而不是直接输出;
  73. CURLOPT_UNRESTRICTED_AUTH:在使用CURLOPT_FOLLOWLOCATION产生的header中的多个locations中持续追加用户名和密码信息,即使域名已发生改变;
  74. CURLOPT_UPLOAD:启用时允许文件传输;
  75. CURLOPT_VERBOSE:启用时会汇报所有的信息,存放在STDERR或指定的CURLOPT_STDERR中;
  76. CURLOPT_BUFFERSIZE:每次获取的数据中读入缓存的大小,这个值每次都会被填满;
  77. CURLOPT_CLOSEPOLICY:不是CURLCLOSEPOLICY_LEAST_RECENTLY_USED就是CURLCLOSEPOLICY_OLDEST,还存在另外三个,但是curl暂时还不支持;
  78. CURLOPT_CONNECTTIMEOUT:在发起连接前等待的时间,如果设置为0,则不等待;
  79. CURLOPT_DNS_CACHE_TIMEOUT:设置在内存中保存DNS信息的时间,默认为120秒;
  80. CURLOPT_HTTP_VERSION:设置curl使用的HTTP协议,CURL_HTTP_VERSION_NONE(让curl自己判断),CURL_HTTP_VERSION_1_0HTTP/1.0),CURL_HTTP_VERSION_1_1HTTP/1.1);
  81. CURLOPT_HTTPAUTH:使用的HTTP验证方法,可选的值有:CURLAUTH_BASICCURLAUTH_DIGESTCURLAUTH_GSSNEGOTIATECURLAUTH_NTLMCURLAUTH_ANYCURLAUTH_ANYSAFE,可以使用“|”操作符分隔多个值,curl让服务器选择一个支持最好的值,CURLAUTH_ANY等价于CURLAUTH_BASIC | CURLAUTH_DIGEST | CURLAUTH_GSSNEGOTIATE | CURLAUTH_NTLMCURLAUTH_ANYSAFE等价于CURLAUTH_DIGEST | CURLAUTH_GSSNEGOTIATE | CURLAUTH_NTLM
  82. CURLOPT_INFILESIZE:设定上传文件的大小; 
  83. CURLOPT_LOW_SPEED_LIMIT:当传输速度小于CURLOPT_LOW_SPEED_LIMIT时,PHP会根CURLOPT_LOW_SPEED_TIME来判断是否因太慢而取消传输;
  84. CURLOPT_LOW_SPEED_TIMEThe number of seconds the transfer should be below CURLOPT_LOW_SPEED_LIMIT for PHP to consider the transfer too slow and abort
  85.  当传输速度小于CURLOPT_LOW_SPEED_LIMIT时,PHP会根据CURLOPT_LOW_SPEED_TIME来判断是否因太慢而取消传输;
  86. CURLOPT_MAXCONNECTS:允许的最大连接数量,超过是会通过CURLOPT_CLOSEPOLICY决定应该停止哪些连接;
  87. CURLOPT_MAXREDIRS:指定最多的HTTP重定向的数量,这个选项是和CURLOPT_FOLLOWLOCATION一起使用的;
  88. CURLOPT_PORT:一个可选的用来指定连接端口的量;
  89. CURLOPT_RESUME_FROM:在恢复传输时传递一个字节偏移量(用来断点续传)
  90. CURLOPT_SSL_VERIFYHOST
  91.  1 to check the existence of a common name in the SSL peer certificate.
  92.  2 to check the existence of a common name and also verify that it matches the hostname provided.
  93. CURLOPT_SSLVERSIONThe SSL version (2 or 3) to use. By default PHP will try to determine this itself, although in some cases this must be set manually.
  94. CURLOPT_TIMECONDITION:如果在CURLOPT_TIMEVALUE指定的某个时间以后被编辑过,则使用CURL_TIMECOND_IFMODSINCE返回页面,如果没有被修改过,并且CURLOPT_HEADERtrue,则返回一个"304 Not Modified"headerCURLOPT_HEADERfalse,则使用CURL_TIMECOND_ISUNMODSINCE,默认值为CURL_TIMECOND_IFMODSINCE
  95. CURLOPT_TIMEOUT:设置curl允许执行的最长秒数
  96. CURLOPT_TIMEVALUE:设置一个CURLOPT_TIMECONDITION使用的时间戳,在默认状态下使用的是CURL_TIMECOND_IFMODSINCE
  97. CURLOPT_CAINFOThe name of a file holding one or more certificates to verify the peer with. This only makes sense when used in combination with CURLOPT_SSL_VERIFYPEER.
  98. CURLOPT_CAPATHA directory that holds multiple CA certificates. Use this option alongside CURLOPT_SSL_VERIFYPEER.
  99. CURLOPT_COOKIE:设定HTTP请求中“Set-Cookie:”部分的内容。
  100. CURLOPT_COOKIEFILE:包含cookie信息的文件名称,这个cookie文件可以是Netscape格式或者HTTP风格的header信息。
  101. CURLOPT_COOKIEJAR:连接关闭以后,存放cookie信息的文件名称
  102. CURLOPT_ENCODINGheader中“Accept-Encoding: ”部分的内容,支持的编码格式为:"identity""deflate""gzip"。如果设置为空字符串,则表示支持所有的编码格式
  103. CURLOPT_INTERFACE:在外部网络接口中使用的名称,可以是一个接口名,IP或者主机名。
  104. CURLOPT_KRB4LEVELKRB4(Kerberos 4)安全级别的设置,可以是一下几个值之一:"clear""safe""confidential""private"。默认的值为"private",设置为null的时候表示禁用KRB4,现在KRB4安全仅能在FTP传输中使用。
  105. CURLOPT_POSTFIELDS:在HTTP中的“POST”操作。如果要传送一个文件,需要一个@开头的文件名
  106. CURLOPT_PROXY:设置通过的HTTP代理服务器
  107. CURLOPT_PROXYUSERPWD:连接到代理服务器的,格式为“[username]:[password]”的用户名和密码。
  108. CURLOPT_RANDOM_FILE:设定存放SSL用到的随机数种子的文件名称
  109. CURLOPT_RANGE:设置HTTP传输范围,可以用“X-Y”的形式设置一个传输区间,如果有多个HTTP传输,则使用逗号分隔多个值,形如:"X-Y,N-M"
  110. CURLOPT_REFERER:设置header"Referer: " 部分的值。
  111. CURLOPT_SSL_CIPHER_LISTA list of ciphers to use for SSL. For example, RC4-SHA and TLSv1 are valid cipher lists.
  112. CURLOPT_SSLCERT:传递一个包含PEM格式证书的字符串。
  113. CURLOPT_SSLCERTPASSWD:传递一个包含使用CURLOPT_SSLCERT证书必需的密码。
  114. CURLOPT_URL:需要获取的URL地址,也可以在PHPcurl_init()函数中设置。
  115. CURLOPT_USERAGENT:在HTTP请求中包含一个”user-agent”头的字符串。
  116. CURLOPT_USERPWD:传递一个连接中需要的用户名和密码,格式为:“[username]:[password]”。
  117. CURLOPT_HTTP200ALIASES:设置不再以error的形式来处理HTTP 200的响应,格式为一个数组。
  118. CURLOPT_HTTPHEADER:设置一个header中传输内容的数组。
  119. CURLOPT_POSTQUOTEAn array of FTP commands to execute on the server after the FTP request has been performed.
  120. CURLOPT_QUOTEAn array of FTP commands to execute on the server prior to the FTP request.
  121. CURLOPT_FILE:设置输出文件的位置,值是一个资源类型,默认为STDOUT (浏览器)。
  122. CURLOPT_INFILE:在上传文件的时候需要读取的文件地址,值是一个资源类型。
  123. CURLOPT_STDERR:设置一个错误输出地址,值是一个资源类型,取代默认的STDERR
  124. CURLOPT_WRITEHEADER:设置header部分内容的写入的文件地址,值是一个资源类型。
  125. CURLOPT_HEADERFUNCTION:设置一个回调函数,这个函数有两个参数,第一个是curl的资源句柄,第二个是输出的header数据。header数据的输出必须依赖这个函数,返回已写入的数据大小。
  126. CURLOPT_PASSWDFUNCTION:设置一个回调函数,有三个参数,第一个是curl的资源句柄,第二个是一个密码提示符,第三个参数是密码长度允许的最大值。返回密码的值。
  127. CURLOPT_READFUNCTION:设置一个回调函数,有两个参数,第一个是curl的资源句柄,第二个是读取到的数据。数据读取必须依赖这个函数。返回读取数据的大小,比如0或者EOF
  128. CURLOPT_WRITEFUNCTION:设置一个回调函数,有两个参数,第一个是curl的资源句柄,第二个是写入的数据。数据写入必须依赖这个函数。返回精确的已写入数据的大小
  129. curl_copy_handle()函数的作用是拷贝一个curl连接资源的所有内容和参数
  130. curl_error()函数的作用是返回一个包含当前会话错误信息的字符串。
  131. curl_errno()函数的作用是返回一个包含当前会话错误信息的数字编号。
  132. curl_multi_init()函数的作用是初始化一个curl批处理句柄资源。
  133. curl_multi_add_handle()函数的作用是向curl批处理会话中添加单独的curl句柄资源。curl_multi_add_handle()函数有两个参数,第一个参数表示一个curl批处理句柄资源,第二个参数表示一个单独的curl句柄资源。
  134. curl_multi_exec()函数的作用是解析一个curl批处理句柄,curl_multi_exec()函数有两个参数,第一个参数表示一个批处理句柄资源,第二个参数是一个引用值的参数,表示剩余需要处理的单个的curl句柄资源数量。
  135. curl_multi_remove_handle()函数表示移除curl批处理句柄资源中的某个句柄资源,curl_multi_remove_handle()函数有两个参数,第一个参数表示一个curl批处理句柄资源,第二个参数表示一个单独的curl句柄资源。
  136. curl_multi_close()函数的作用是关闭一个批处理句柄资源。
  137. curl_multi_getcontent()函数的作用是在设置了CURLOPT_RETURNTRANSFER的情况下,返回获取的输出的文本流。
  138. curl_multi_info_read()函数的作用是获取当前解析的curl的相关传输信息。
  139. curl_multi_select():Get all the sockets associated with the cURL extension, which can then be "selected"

CURL