本文写给刚入PHP坑不久的新手们,作为工具文档,方便用时查阅。
CURL是一个非常强大的开源库,它支持很多种协议,例如,HTTP、HTTPS、FTP、TELENT等。日常开发中,我们经常会需要用到curl向其他系统api访问。
要想使用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请求,如果需要用到请求参数,可以直接在设置CURLOPT_URL选项时带上请求参数。如下增加了一个hi参数,其值为hello:
curl_setopt($ch,CURLOPT_URL,"http://www.baidu.com?hi=hello");
对于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 #本地端口
这里,码哥对字段做了标注。可以看到,不仅可以获取基本的响应信息,还可以获取公网地址、网速、耗时等信息。