cURL 是一个利用URL语法规定来传输文件和数据的工具，PHP的curl是通过libcurl库与服务器使用各种类型的协议，如HTTP、FTP、TELNET等。
|
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版本信息。 |
使用curl操作的基本步骤：初始化->设置变量->执行并获取结果->释放curl句柄
curl函数的关键在于curl_setopt的传输选项。
CURL几种请求方式：
1、GET
根据HTTP规范，GET用户信息获取，可以理解为通过url地址访问网址，一个打开百度首页的简单例子：
<?php // 1. 初始化 $ch = curl_init(); // 2. 设置选项，包括URL curl_setopt($ch, CURLOPT_URL, "http://www.baidu.com"); // 设置url抓取地址// 3. 执行并获取HTML文档内容 $output = curl_exec($ch); // 执行 // 4. 释放curl句柄 curl_close($ch); // 关闭
有时候通过GET方式获取页面并不需要全部的数据，而需要 截取部分数据，这时候需要通过CURLOPT_RETURNTRANSFER选项将页面以文件流的形式保存，然后进行输出。
<?php $url = "https://www.baidu.com"; // 你请求的url $ch = curl_init(); curl_setopt($ch,CURLOPT_URL,$url); // 将curl_exec()获取的信息以文件流的形式返回，而不是直接输出 curl_setopt($ch,CURLOPT_RETURNTRANSFER,1); $output = curl_exec($ch); curl_close($ch); echo $output;
2、POST
根据HTTP规范，POST用于向服务器提交数据，典型的应用 为表单提交，安全性较GET方式安全。
1 $url = "http://localhost/post_output.php"; 2 $post_data = array ( 3 "name" => "tom", 4 "gender" => "男", 5 "hobby" => "papapa" 6 ); 7 $ch = curl_init(); 8 curl_setopt($ch, CURLOPT_URL, $url); 9 curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1); 10 // 设置请求为post 11 curl_setopt($ch, CURLOPT_POST, 1); 12 // 把post的变数据加上 13 curl_setopt($ch, CURLOPT_POSTFIELDS, $post_data); 14 $output = curl_exec($ch); 15 curl_close($ch); 16 echo $output;
3、DELETE
1 $url = "http://localhost/test.php"; 2 $post_data = array ( 3 "foo" => "bar", 4 "query" => "Nettuts", 5 "action" => "Submit" 6 ); 7 $ch = curl_init(); 8 curl_setopt($ch, CURLOPT_URL, $url); 9 curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1); 10 11 curl_setopt ($ch, CURLOPT_CUSTOMREQUEST, "DELETE"); 12 curl_setopt($ch, CURLOPT_POSTFIELDS,$post_data); 13 $output = curl_exec($ch); 14 curl_close($ch); 15 var_dump($output);
4、PUT
1 $url = "http://localhost/test.php"; 2 $post_data = array ( 3 "foo" => "bar", 4 "query" => "Nettuts", 5 "action" => "Submit" 6 ); 7 $ch = curl_init(); 8 curl_setopt($ch, CURLOPT_URL, $url); 9 curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1); 10 curl_setopt ($ch, CURLOPT_CUSTOMREQUEST, "PUT"); 11 curl_setopt($ch, CURLOPT_POSTFIELDS,$post_data); 12 $output = curl_exec($ch); 13 curl_close($ch); 14 echo $output;
5、PATCH
1 $url = "http://localhost/post_output.php"; 2 $post_data = array ( 3 "foo" => "bar", 4 "query" => "Nettuts", 5 "action" => "Submit" 6 ); 7 $ch = curl_init(); 8 curl_setopt($ch, CURLOPT_URL, $url); 9 curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1); 10 curl_setopt($ch, CULROPT_CUSTOMREQUEST, ‘PATCH‘); 11 curl_setopt($ch, CURLOPT_POSTFIELDS, $params); 12 $output = curl_exec($ch); 13 curl_close($ch); 14 echo $output;
总结curl常用请求工具函数
1 function callInterfaceCommon($URL,$type,$params,$headers){
2 $ch = curl_init($URL);
3 // $timeout = 5;
4 if($headers!=""){
5 curl_setopt ($ch, CURLOPT_HTTPHEADER, $headers);
6 }else {
7 curl_setopt ($ch, CURLOPT_HTTPHEADER, array(‘Content-type: application/json‘));
8 }
9 curl_setopt ($ch, CURLOPT_RETURNTRANSFER, 1);
10 // curl_setopt ($ch, CURLOPT_CONNECTTIMEOUT, $timeout);
11 switch ($type){
12 case "GET" : curl_setopt($ch, CURLOPT_HTTPGET, true);break;
13 case "POST": curl_setopt($ch, CURLOPT_POST,true);
14 curl_setopt($ch, CURLOPT_POSTFIELDS,$params);break;
15 case "PUT" : curl_setopt ($ch, CURLOPT_CUSTOMREQUEST, "PUT");
16 curl_setopt($ch, CURLOPT_POSTFIELDS,$params);break;
17 case "PATCH": curl_setopt($ch, CULROPT_CUSTOMREQUEST, ‘PATCH‘);
18 curl_setopt($ch, CURLOPT_POSTFIELDS, $params);break;
19 case "DELETE":curl_setopt ($ch, CURLOPT_CUSTOMREQUEST, "DELETE");
20 curl_setopt($ch, CURLOPT_POSTFIELDS,$params);break;
21 }
22 $file_contents = curl_exec($ch);//获得返回值
23 return $file_contents;
24 curl_close($ch);
25 }
其他：
获取信息
这是另一个可选的设置项，能够在cURL执行后获取这一请求的有关信息
curl_exec($ch); $info = curl_getinfo($ch); var_dump($info); // 数组中包含信息 “url” //资源网络地址 “content_type” //内容编码 “http_code” //HTTP状态码 “header_size” //header的大小 “request_size” //请求的大小 “filetime” //文件创建时间 “ssl_verify_result” //SSL验证结果 “redirect_count” //跳转技术 “total_time” //总耗时 “namelookup_time” //DNS查询耗时 “connect_time” //等待连接耗时 “pretransfer_time” //传输前准备耗时 “size_upload” //上传数据的大小 “size_download” //下载数据的大小 “speed_download” //下载速度 “speed_upload” //上传速度 “download_content_length”//下载内容的长度 “upload_content_length” //上传内容的长度 “starttransfer_time” //开始传输的时间 “redirect_time”//重定向耗时
基于浏览器的重定向
有些网站会根据是否是手机浏览器甚至用户来自哪个国家来重定向网页。利用 CURLOPT_HTTPHEADER 选项来设定发送出的HTTP请求头信息（http headers），包括user agent信息和默认语言。然后看一看这些特定网站会重定向到哪些不同的URL。
1 <?php
2 // 测试用的URL
3 $urls = array(
4 "http://www.sina.com",
5 "http://www.weibo.com",
6 "http://www.qq.com"
7 );
8 // 测试用的浏览器信息
9 $browsers = array(
10 "standard" => array (
11 "user_agent" => "Mozilla/5.0 (Windows; U; Windows NT 6.1; en-US; rv:1.9.1.6) Gecko/20091201 Firefox/3.5.6 (.NET CLR 3.5.30729)",
12 "language" => "en-us,en;q=0.5"
13 ),
14 "iphone" => array (
15 "user_agent" => "Mozilla/5.0 (iPhone; U; CPU like Mac OS X; en) AppleWebKit/420+ (KHTML, like Gecko) Version/3.0 Mobile/1A537a Safari/419.3",
16 "language" => "en"
17 ),
18 "french" => array (
19 "user_agent" => "Mozilla/4.0 (compatible; MSIE 7.0; Windows NT 5.1; GTB6; .NET CLR 2.0.50727)",
20 "language" => "fr,fr-FR;q=0.5"
21 )
22 );
23 foreach ($urls as $url) {
24 echo "URL: $url<br>";
25 foreach ($browsers as $test_name => $browser) {
26 $ch = curl_init();
27 // 设置 url
28 curl_setopt($ch, CURLOPT_URL, $url);
29 // 设置浏览器的特定header
30 curl_setopt($ch, CURLOPT_HTTPHEADER, array(
31 "User-Agent: {$browser[‘user_agent‘]}",
32 "Accept-Language: {$browser[‘language‘]}"
33 ));
34 // 页面内容我们并不需要
35 curl_setopt($ch, CURLOPT_NOBODY, 1);
36 // 只需返回HTTP header
37 curl_setopt($ch, CURLOPT_HEADER, 1);
38 // 返回结果，而不是输出它
39 curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
40 $output = curl_exec($ch);
41 curl_close($ch);
42 // 有重定向的HTTP头信息吗?
43 if (preg_match("!Location: (.*)!", $output, $matches)) {
44 echo "$test_name: redirects to $matches[1]<br>";
45 } else {
46 echo "$test_name: no redirection<br>";
47 }
48 }
49 echo "<br>";
50 }
结果如下：
时间： 2024-11-13 10:44:28