PHP使用CURL详解

CURL是一个很是强大的开源库，支持不少协议，包括HTTP、FTP、TELNET等，咱们使用它来发送HTTP请求。它给我 们带来的好处是能够经过灵活的选项设置不一样的HTTP协议参数，而且支持HTTPS。CURL能够根据URL前缀是“HTTP” 仍是“HTTPS”自动选择是否加密发送内容。

使用CURL发送请求的基本流程

使用CURL的PHP扩展完成一个HTTP请求的发送通常有如下几个步骤：

1. 初始化链接句柄；
2. 设置CURL选项；
3. 执行并获取结果；
4. 释放VURL链接句柄。

下面的程序片断是使用CURL发送HTTP的典型过程

// 1. 初始化
 $ch = curl_init();
 // 2. 设置选项，包括URL
 curl_setopt($ch,CURLOPT_URL,"http://www.devdo.net");
 curl_setopt($ch,CURLOPT_RETURNTRANSFER,1);
 curl_setopt($ch,CURLOPT_HEADER,0);
 // 3. 执行并获取HTML文档内容
 $output = curl_exec($ch);
 if($output === FALSE ){
 echo "CURL Error:".curl_error($ch);
 }
 // 4. 释放curl句柄
 curl_close($ch);

上述代码中使用到了四个函数

• curl_init() 和 curl_close() 分别是初始化CURL链接和关闭CURL链接，都比较简单。
• curl_exec() 执行CURL请求，若是没有错误发生，该函数的返回是对应URL返回的数据，以字符串表示满意；若是发生错误，该函数返回 FALSE。须要注意的是，判断输出是否为FALSE用的是全等号，这是为了区分返回空串和出错的状况。
• CURL函数库里最重要的函数是curl_setopt(),它能够经过设定CURL函数库定义的选项来定制HTTP请求。上述代码片断中使用了三个重要的选项：
  1. CURLOPT_URL 指定请求的URL；
  2. CURLOPT_RETURNTRANSFER 设置为1表示稍后执行的curl_exec函数的返回是URL的返回字符串，而不是把返回字符串定向到标准输出并返回TRUE；
  3. CURLLOPT_HEADER设置为0表示不返回HTTP头部信息。

CURL的选项还有不少，能够到PHP的官方网站（http://www.php.net/manual/en/function.curl-setopt.php）上查看CURL支持的全部选项列表。

获取CURL请求的输出信息

在curl_exec()函数执行以后，可使用curl_getinfo()函数获取CURL请求输出的相关信息，示例代码以下：

curl_exec($ch);
$info = curl_getinfo($sh);
echo ' 获取 '.$info['url'].'耗时'.$info['total_time'].'秒';

上述代码中curl_getinfo返回的是一个关联数组，包含如下数据：

• 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_uplpad:上传数据的大小。
• size_download:下载数据的大小。
• speed_download:下载速度。
• speed_upload:上传速度。
• download_content_length:下载内容的长度。
• upload_content_length:上传内容的长度。
• starttransfer_time:开始传输的时间表。
• redirect_time:重定向耗时。

curl_getinfo()函数还有一个可选择参数$opt,经过这个参数能够设置一些常量，对应到上术这个字段，若是设置了第二个参数，那么返回的只有指定的信息。例如设置$opt为CURLINFO_TOTAL_TIME，则curl_getinfo()函数只返回total_time,即总传输消耗的时间，在只须要关注某些传输信息时，设置$opt参数颇有意义。

使用CURL发送GET请求

如何使用CURL来发送GET请求，发送GET请求的关键是拼装格式正确的URL。请求地址和GET数据由一个“?”分割,而后GET变量的名称和值用“=”分隔，各个GET名称和值由“&”链接。PHP为咱们提供了一个函数专门用来拼装GET请求和数据部分——http_build_query,该函数接受一个关联数组，返回由该关联数据描述的GET请求字符串。使用这个函数，结合CURL发送HTTP请求的通常流程，咱们封闭了一个发送GET请求的函数——doCurlGetRequest,具体代码以下：

**
 *@desc 封闭curl的调用接口，get的请求方式。
*/
function doCurlGetRequest($url,$data,$timeout = 5){
 if($curl == "" || $timeout <= 0){
 return false;
 }
 $url = $url.'?'.http_bulid_query($data);
 $con = curl_init((string)$url);
 curl_setopt($con, CURLOPT_HEADER, false);
 curl_setopt($con, CURLOPT_RETURNTRANSFER,true);
 curl_setopt($con, CURLOPT_TIMEOUT, (int)$timeout);
 
 return curl_exec($con);
}

这个函数把使用http_build_query 拼装好的带GET参数的URL传给curl_init函数，而后使用CURL发送HTTP请求。

使用CURL发送POST请求

可使用CURL提供的选项CURLOPT_POSTFIELDS，设置该选项为POST字符串数据就能够把请求放在正文中。一样咱们实现了一个发送POST请求的函数——doCurlPostRequest，代码以下：

/**
** @desc 封装 curl 的调用接口，post的请求方式
**/
function doCurlPostRequest($url,$requestString,$timeout = 5){
 if($url == '' || $requestString == '' || $timeout <=0){
 return false;
 }
 $con = curl_init((string)$url);
 curl_setopt($con, CURLOPT_HEADER, false);
 curl_setopt($con, CURLOPT_POSTFIELDS, $requestString);
 curl_setopt($con, CURLOPT_POST,true);
 curl_setopt($con, CURLOPT_RETURNTRANSFER,true);
 curl_setopt($con, CURLOPT_TIMEOUT,(int)$timeout);
 return curl_exec($con); 
}

上面代码中除了设置CURLOPT_POSTFIELDS外，咱们还设置了CURL_POST为true,标识这个请求是一个POST请求。在POST请求中也是能够传输GET数据的，只须要在URL中拼装GET请求数据便可秀。

 

原文地址：http://www.devdo.net/php-curl.html