PHP Curl的简单使用

本文写给刚入PHP坑不久的新手们，作为工具文档，方便用时查阅。

CURL是一个非常强大的开源库，它支持很多种协议，例如，HTTP、HTTPS、FTP、TELENT等。日常开发中，我们经常会需要用到curl向其他系统api访问。

使用

要想使用CURL，大致需要如下流程：

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

参见如下示例：

<?php
$ch = curl_init();
 
curl_setopt($ch,CURLOPT_URL,"http://www.baidu.com");
curl_setopt($ch,CURLOPT_RETURNTRANSFER,1);
 
$output = curl_exec($ch);
if($output === FALSE ){
  echo "error:".curl_error($ch);
}
 
curl_close($ch);

echo $output;

在上面的代码中，我们使用curl_init函数来初始化curl句柄，然后多次调用curl_setopt函数来设置多个选项，随后我们调用curl_exec函数执行发送HTTP请求并从远端接收相应数据，最终我们调用curl_close关闭curl句柄进行资源释放。

运行这段代码，我们可以看到控制台下，会输出百度的页面信息。

对于选项部分：

• CURLOPT_URL——设置请求的url及其使用的协议；
• CURLOPT_RETURNTRANSFER——设置为1，表示返回的响应数据不会被从标准输出输出，而是作为返回值传递给output变量；否则，返回内容会被直接输出到标准输出，而返回值是错误号；

以上我们就完成了一个简单的CURL使用。

---

下面我们看看如何设置GET和POST请求：

Get请求

其实我们上面的例子就是get请求，如果需要用到请求参数，可以直接在设置CURLOPT_URL选项时带上请求参数。如下增加了一个hi参数，其值为hello：

curl_setopt($ch,CURLOPT_URL,"http://www.baidu.com?hi=hello");

Post请求

对于POST请求，我们对最开始的例子做一些修改即可，代码如下：

curl_setopt($ch,CURLOPT_URL,"http://127.0.0.1/");
curl_setopt($ch, CURLOPT_POSTFIELDS, 'hello=world');
curl_setopt($ch, CURLOPT_POST, true);

首先，我们将CURLOPT_URL选项的url改为本地环回地址的80端口。

其次，我们加入了CURLOPT_POSTFIELDS来设置post请求中参数字段。

最后，我们设置CURLOPT_POST选项为true，表示我们将发送一个POST类型请求。

curl_setopt函数的第二个参数种类非常多，可以参考php官方站点中curl_getinfo函数的opt参数内容，在需要时进行设置。

下面，我们在本地启用nc来监听80端口，这样可以看到curl发来的请求，以验证结果：

curl_setopt函数的第二个参数种类非常多，可以参考php官方站点中curl_getinfo函数的opt参数内容，在需要时进行设置。

$ nc -l 80
POST / HTTP/1.1
Host: 127.0.0.1
Accept: */*
Content-Length: 11
Content-Type: application/x-www-form-urlencoded
 
hello=world

可以看到，nc中收到PHP发来的请求是POST请求，且我们的POST参数在请求体中，并且请求头部也加入了content-相关字段指定数据大小和类型等。

下面，我们再来看看curl还能够给我们哪些有用信息。

获取请求响应的相关信息

利用curl_getinfo函数，我们可以获取更多的与请求和响应相关的信息。只需要在curl_exec之后执行如下调用：

$info = curl_getinfo($ch);

我们可以看下info都包含些什么，以前面的例子为例，我们去掉最后的echo，然后在curl_exec后加入：

$info = curl_getinfo($ch);
foreach ($info as $k => $v) {
    echo $k.": ".$v."\n";
}

输出信息如下：

url: http://www.baidu.com/      #网络地址
content_type: text/html         #响应数据类型
http_code: 200                  #http响应码
header_size: 750                #响应头大小
request_size: 52                #请求大小
filetime: -1                    #文件创建的时间
ssl_verify_result: 0            #SSL验证结果
redirect_count: 0               #跳转计数
total_time: 0.028716            #总耗时
namelookup_time: 0.004372       #DNS查询耗时
connect_time: 0.019615          #等待连接耗时
pretransfer_time: 0.019732      #传输前准备耗时
size_upload: 0                  #上传数据大小
size_download: 14613            #下载数据大小
speed_download: 508880          #下载速度
speed_upload: 0                 #上传速度
download_content_length: 14613  #下载内容长度
upload_content_length: -1       #上传内容长度
starttransfer_time: 0.027137    #直到首字节传输开始的耗时
redirect_time: 0                #重定向耗时
redirect_url:                   #重定向url
primary_ip: 119.75.216.20       #DNS解析后首选地址
certinfo: Array                 #TLS的证书链
primary_port: 80                #远端端口
local_ip: 192.168.1.xxx         #本地ip
local_port: 51210               #本地端口

这里，码哥对字段做了标注。可以看到，不仅可以获取基本的响应信息，还可以获取公网地址、网速、耗时等信息。

以上就是curl的简单使用。