CURL

Posted 2020-09-25

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 = 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类型的数据。

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

5. PHP中的CURL函数库（Client URL Library Function）
7. curl_close — 关闭一个curl会话；
9. curl_copy_handle — 拷贝一个curl连接资源的所有内容和参数；
11. curl_errno — 返回一个包含当前会话错误信息的数字编号；
13. curl_error — 返回一个包含当前会话错误信息的字符串；
15. curl_exec — 执行一个curl会话；
17. curl_getinfo — 获取一个curl连接资源句柄的信息；
19. curl_init — 初始化一个curl会话；
21. curl_multi_add_handle — 向curl批处理会话中添加单独的curl句柄资源；
23. curl_multi_close — 关闭一个批处理句柄资源；
25. curl_multi_exec — 解析一个curl批处理句柄；
27. curl_multi_getcontent — 返回获取的输出的文本流；
29. curl_multi_info_read — 获取当前解析的curl的相关传输信息；
31. curl_multi_init — 初始化一个curl批处理句柄资源；
33. curl_multi_remove_handle — 移除curl批处理句柄资源中的某个句柄资源；
35. curl_multi_select — Get all the sockets associated with the cURL extension, which can then be "selected"；
37. curl_setopt_array — 以数组的形式为一个curl设置会话参数；
39. curl_setopt — 为一个curl设置会话参数；
41. curl_version — 获取curl相关的版本信息；
43. curl_init()函数的作用初始化一个curl会话，curl_init()函数唯一的一个参数是可选的，表示一个url地址；
45. curl_exec()函数的作用是执行一个curl会话，唯一的参数是curl_init()函数返回的句柄；
47. curl_close()函数的作用是关闭一个curl会话，唯一的参数是curl_init()函数返回的句柄；
48.  
49. curl_version()函数的作用是获取curl相关的版本信息，curl_version()函数有一个参数，不清楚是做什么的；
50.  
51. curl_getinfo()函数的作用是获取一个curl连接资源句柄的信息，curl_getinfo()函数有两个参数，第一个参数是curl的资源句柄，第二个参数是下面一些常量：
52.  
54.  可选的常量包括：
56. CURLINFO_EFFECTIVE_URL：最后一个有效的url地址；
58. CURLINFO_HTTP_CODE：最后一个收到的HTTP代码；
60. CURLINFO_FILETIME：远程获取文档的时间，如果无法获取，则返回值为“-1”；
62. CURLINFO_TOTAL_TIME：最后一次传输所消耗的时间；
64. CURLINFO_NAMELOOKUP_TIME：名称解析所消耗的时间；
66. CURLINFO_CONNECT_TIME：建立连接所消耗的时间；
68. CURLINFO_PRETRANSFER_TIME：从建立连接到准备传输所使用的时间；
70. CURLINFO_STARTTRANSFER_TIME：从建立连接到传输开始所使用的时间；
72. CURLINFO_REDIRECT_TIME：在事务传输开始前重定向所使用的时间；
74. CURLINFO_SIZE_UPLOAD：上传数据量的总值；
76. CURLINFO_SIZE_DOWNLOAD：下载数据量的总值；
78. CURLINFO_SPEED_DOWNLOAD：平均下载速度；
80. CURLINFO_SPEED_UPLOAD：平均上传速度；
82. CURLINFO_HEADER_SIZE：header部分的大小；
84. CURLINFO_HEADER_OUT：发送请求的字符串；
86. CURLINFO_REQUEST_SIZE：在HTTP请求中有问题的请求的大小；
88. CURLINFO_SSL_VERIFYRESULT：Result of SSL certification verification requested by setting CURLOPT_SSL_VERIFYPEER；
90. CURLINFO_CONTENT_LENGTH_DOWNLOAD：从Content-Length: field中读取的下载内容长度；
92. CURLINFO_CONTENT_LENGTH_UPLOAD：上传内容大小的说明；
94. CURLINFO_CONTENT_TYPE：下载内容的“Content-type”值，NULL表示服务器没有发送有效的“Content-Type: header”；
96. curl_setopt()函数的作用是为一个curl设置会话参数。curl_setopt_array()函数的作用是以数组的形式为一个curl设置会话参数；
98.  可设置的参数有：
100. CURLOPT_AUTOREFERER：自动设置header中的referer信息；
102. CURLOPT_BINARYTRANSFER：在启用CURLOPT_RETURNTRANSFER时候将获取数据返回；
104. CURLOPT_COOKIESESSION：启用时curl会仅仅传递一个session cookie，忽略其他的cookie，默认状况下curl会将所有的cookie返回给服务端。session cookie是指那些用来判断服务器端的session是否有效而存在的cookie；
106. CURLOPT_CRLF：启用时将Unix的换行符转换成回车换行符；
108. CURLOPT_DNS_USE_GLOBAL_CACHE：启用时会启用一个全局的DNS缓存，此项为线程安全的，并且默认为true；
110. CURLOPT_FAILONERROR：显示HTTP状态码，默认行为是忽略编号小于等于400的HTTP信息；
112. CURLOPT_FILETIME：启用时会尝试修改远程文档中的信息。结果信息会通过curl_getinfo()函数的CURLINFO_FILETIME选项返回；
114. CURLOPT_FOLLOWLOCATION：启用时会将服务器服务器返回的“Location:”放在header中递归的返回给服务器，使用CURLOPT_MAXREDIRS可以限定递归返回的数量；
116. CURLOPT_FORBID_REUSE：在完成交互以后强迫断开连接，不能重用；
118. CURLOPT_FRESH_CONNECT：强制获取一个新的连接，替代缓存中的连接；
120. CURLOPT_HEADER：启用时会将头文件的信息作为数据流输出；
122. CURLOPT_HTTPGET：启用时会设置HTTP的method为GET，因为GET是默认是，所以只在被修改的情况下使用；
124. CURLOPT_HTTPPROXYTUNNEL：启用时会通过HTTP代理来传输；
126. CURLOPT_MUTE：讲curl函数中所有修改过的参数恢复默认值；
128. CURLOPT_NETRC：在连接建立以后，访问~/.netrc文件获取用户名和密码信息连接远程站点；
130. CURLOPT_NOBODY：启用时将不对HTML中的body部分进行输出；
132. CURLOPT_NOPROGRESS：启用时关闭curl传输的进度条，此项的默认设置为true；
134. CURLOPT_NOSIGNAL：启用时忽略所有的curl传递给php进行的信号。在SAPI多线程传输时此项被默认打开；
136. CURLOPT_POST：启用时会发送一个常规的POST请求，类型为：application/x-www-form-urlencoded，就像表单提交的一样；
138. CURLOPT_PUT：启用时允许HTTP发送文件，必须同时设置CURLOPT_INFILE和CURLOPT_INFILESIZE
140. CURLOPT_RETURNTRANSFER：将curl_exec()获取的信息以文件流的形式返回，而不是直接输出；
142. CURLOPT_UNRESTRICTED_AUTH：在使用CURLOPT_FOLLOWLOCATION产生的header中的多个locations中持续追加用户名和密码信息，即使域名已发生改变；
144. CURLOPT_UPLOAD：启用时允许文件传输；
146. CURLOPT_VERBOSE：启用时会汇报所有的信息，存放在STDERR或指定的CURLOPT_STDERR中；
148. CURLOPT_BUFFERSIZE：每次获取的数据中读入缓存的大小，这个值每次都会被填满；
150. CURLOPT_CLOSEPOLICY：不是CURLCLOSEPOLICY_LEAST_RECENTLY_USED就是CURLCLOSEPOLICY_OLDEST，还存在另外三个，但是curl暂时还不支持；
152. CURLOPT_CONNECTTIMEOUT：在发起连接前等待的时间，如果设置为0，则不等待；
154. CURLOPT_DNS_CACHE_TIMEOUT：设置在内存中保存DNS信息的时间，默认为120秒；
156. 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）；
158. 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
160. CURLOPT_INFILESIZE：设定上传文件的大小； 
162. CURLOPT_LOW_SPEED_LIMIT：当传输速度小于CURLOPT_LOW_SPEED_LIMIT时，PHP会根CURLOPT_LOW_SPEED_TIME来判断是否因太慢而取消传输；
164. 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；
166.  当传输速度小于CURLOPT_LOW_SPEED_LIMIT时，PHP会根据CURLOPT_LOW_SPEED_TIME来判断是否因太慢而取消传输；
168. CURLOPT_MAXCONNECTS：允许的最大连接数量，超过是会通过CURLOPT_CLOSEPOLICY决定应该停止哪些连接；
170. CURLOPT_MAXREDIRS：指定最多的HTTP重定向的数量，这个选项是和CURLOPT_FOLLOWLOCATION一起使用的；
172. CURLOPT_PORT：一个可选的用来指定连接端口的量；
175. CURLOPT_RESUME_FROM：在恢复传输时传递一个字节偏移量（用来断点续传）
177. CURLOPT_SSL_VERIFYHOST：
179.  1 to check the existence of a common name in the SSL peer certificate.
181.  2 to check the existence of a common name and also verify that it matches the hostname provided.
183. CURLOPT_SSLVERSION：The 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.
185. CURLOPT_TIMECONDITION：如果在CURLOPT_TIMEVALUE指定的某个时间以后被编辑过，则使用CURL_TIMECOND_IFMODSINCE返回页面，如果没有被修改过，并且CURLOPT_HEADER为true，则返回一个"304 Not Modified"的header，CURLOPT_HEADER为false，则使用CURL_TIMECOND_ISUNMODSINCE，默认值为CURL_TIMECOND_IFMODSINCE
187. CURLOPT_TIMEOUT：设置curl允许执行的最长秒数
189. CURLOPT_TIMEVALUE：设置一个CURLOPT_TIMECONDITION使用的时间戳，在默认状态下使用的是CURL_TIMECOND_IFMODSINCE
191. CURLOPT_CAINFO：The 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.
193. CURLOPT_CAPATH：A directory that holds multiple CA certificates. Use this option alongside CURLOPT_SSL_VERIFYPEER.
195. CURLOPT_COOKIE：设定HTTP请求中“Set-Cookie:”部分的内容。
197. CURLOPT_COOKIEFILE：包含cookie信息的文件名称，这个cookie文件可以是Netscape格式或者HTTP风格的header信息。
199. CURLOPT_COOKIEJAR：连接关闭以后，存放cookie信息的文件名称
201. CURLOPT_ENCODING：header中“Accept-Encoding: ”部分的内容，支持的编码格式为："identity"，"deflate"，"gzip"。如果设置为空字符串，则表示支持所有的编码格式
203. CURLOPT_INTERFACE：在外部网络接口中使用的名称，可以是一个接口名，IP或者主机名。
205. CURLOPT_KRB4LEVEL：KRB4(Kerberos 4)安全级别的设置，可以是一下几个值之一："clear"，"safe"，"confidential"，"private"。默认的值为"private"，设置为null的时候表示禁用KRB4，现在KRB4安全仅能在FTP传输中使用。
207. CURLOPT_POSTFIELDS：在HTTP中的“POST”操作。如果要传送一个文件，需要一个@开头的文件名
209. CURLOPT_PROXY：设置通过的HTTP代理服务器
211. CURLOPT_PROXYUSERPWD：连接到代理服务器的，格式为“[username]:[password]”的用户名和密码。
213. CURLOPT_RANDOM_FILE：设定存放SSL用到的随机数种子的文件名称
215. CURLOPT_RANGE：设置HTTP传输范围，可以用“X-Y”的形式设置一个传输区间，如果有多个HTTP传输，则使用逗号分隔多个值，形如："X-Y,N-M"。
217. CURLOPT_REFERER：设置header中"Referer: " 部分的值。
219. CURLOPT_SSL_CIPHER_LIST：A list of ciphers to use for SSL. For example, RC4-SHA and TLSv1 are valid cipher lists.
221. CURLOPT_SSLCERT：传递一个包含PEM格式证书的字符串。
223. CURLOPT_SSLCERTPASSWD：传递一个包含使用CURLOPT_SSLCERT证书必需的密码。
225. CURLOPT_URL：需要获取的URL地址，也可以在PHP的curl_init()函数中设置。
227. CURLOPT_USERAGENT：在HTTP请求中包含一个”user-agent”头的字符串。
229. CURLOPT_USERPWD：传递一个连接中需要的用户名和密码，格式为：“[username]:[password]”。
231. CURLOPT_HTTP200ALIASES：设置不再以error的形式来处理HTTP 200的响应，格式为一个数组。
233. CURLOPT_HTTPHEADER：设置一个header中传输内容的数组。
235. CURLOPT_POSTQUOTE：An array of FTP commands to execute on the server after the FTP request has been performed.
237. CURLOPT_QUOTE：An array of FTP commands to execute on the server prior to the FTP request.
239. CURLOPT_FILE：设置输出文件的位置，值是一个资源类型，默认为STDOUT (浏览器)。
241. CURLOPT_INFILE：在上传文件的时候需要读取的文件地址，值是一个资源类型。
243. CURLOPT_STDERR：设置一个错误输出地址，值是一个资源类型，取代默认的STDERR。
245. CURLOPT_WRITEHEADER：设置header部分内容的写入的文件地址，值是一个资源类型。
247. CURLOPT_HEADERFUNCTION：设置一个回调函数，这个函数有两个参数，第一个是curl的资源句柄，第二个是输出的header数据。header数据的输出必须依赖这个函数，返回已写入的数据大小。
249. CURLOPT_PASSWDFUNCTION：设置一个回调函数，有三个参数，第一个是curl的资源句柄，第二个是一个密码提示符，第三个参数是密码长度允许的最大值。返回密码的值。
251. CURLOPT_READFUNCTION：设置一个回调函数，有两个参数，第一个是curl的资源句柄，第二个是读取到的数据。数据读取必须依赖这个函数。返回读取数据的大小，比如0或者EOF。
253. CURLOPT_WRITEFUNCTION：设置一个回调函数，有两个参数，第一个是curl的资源句柄，第二个是写入的数据。数据写入必须依赖这个函数。返回精确的已写入数据的大小
255. curl_copy_handle()函数的作用是拷贝一个curl连接资源的所有内容和参数
257. curl_error()函数的作用是返回一个包含当前会话错误信息的字符串。
259. curl_errno()函数的作用是返回一个包含当前会话错误信息的数字编号。
261. curl_multi_init()函数的作用是初始化一个curl批处理句柄资源。
263. curl_multi_add_handle()函数的作用是向curl批处理会话中添加单独的curl句柄资源。curl_multi_add_handle()函数有两个参数，第一个参数表示一个curl批处理句柄资源，第二个参数表示一个单独的curl句柄资源。
265. curl_multi_exec()函数的作用是解析一个curl批处理句柄，curl_multi_exec()函数有两个参数，第一个参数表示一个批处理句柄资源，第二个参数是一个引用值的参数，表示剩余需要处理的单个的curl句柄资源数量。
267. curl_multi_remove_handle()函数表示移除curl批处理句柄资源中的某个句柄资源，curl_multi_remove_handle()函数有两个参数，第一个参数表示一个curl批处理句柄资源，第二个参数表示一个单独的curl句柄资源。
269. curl_multi_close()函数的作用是关闭一个批处理句柄资源。
271. curl_multi_getcontent()函数的作用是在设置了CURLOPT_RETURNTRANSFER的情况下，返回获取的输出的文本流。
273. curl_multi_info_read()函数的作用是获取当前解析的curl的相关传输信息。
275. curl_multi_select()：Get all the sockets associated with the cURL extension, which can then be "selected"