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头部信息。
  4. 参数查看：http://www.php.net/manual/zh/function.curl-setopt.php

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请求数据即可秀。

 

常用curl错误码

CURLE_OK（0）

一切都很好。像往常一样继续。

CURLE_UNSUPPORTED_PROTOCOL（1）

您传递给libcurl的URL使用了此libcurl不支持的协议。支持可能是您没有使用的编译时选项，它可能是拼写错误的协议字符串，或者只是协议libcurl没有代码。

CURLE_FAILED_INIT（2）

很早的初始化代码失败了。这可能是内部错误或问题，或者是在初始时无法完成某些基本操作的资源问题。

CURLE_URL_MALFORMAT（3）

URL格式不正确。

CURLE_NOT_BUILT_IN（4）

由于构建时决定，未在此libcurl中找到所请求的功能，协议或选项。这意味着在构建libcurl时未启用或显式禁用某个功能或选项，并且为了使其运行，您必须获得重建的libcurl。

CURLE_COULDNT_RESOLVE_PROXY（5）

无法解析代理。无法解析给定的代理主机。

CURLE_COULDNT_RESOLVE_HOST（6）

无法解析主机。给定的远程主机未解析。

CURLE_COULDNT_CONNECT（7）

无法连接（）到主机或代理。

CURLE_FTP_WEIRD_SERVER_REPLY（8）

服务器发送的数据libcurl无法解析。此错误代码不仅用于FTP，而且自7.51.0起别名为CURLE_WEIRD_SERVER_REPLY。

CURLE_REMOTE_ACCESS_DENIED（9）

我们被拒绝访问URL中给出的资源。对于FTP，尝试更改到远程目录时会发生这种情况。

CURLE_FTP_ACCEPT_FAILED（10）

在使用活动FTP会话时等待服务器连接回来时，通过控制连接或类似方式发送错误代码。

CURLE_FTP_WEIRD_PASS_REPLY（11）

在将FTP密码发送到服务器之后，libcurl希望得到适当的回复。此错误代码表示返回了意外的代码。

CURLE_FTP_ACCEPT_TIMEOUT（12）

在等待服务器连接的活动FTP会话期间，CURLOPT_ACCEPTTIMEOUT_MS（或内部默认值）超时已到期。

CURLE_FTP_WEIRD_PASV_REPLY（13）

libcurl无法从服务器获得合理的结果作为对PASV或EPSV命令的响应。服务器存在缺陷。

CURLE_FTP_WEIRD_227_FORMAT（14）

FTP服务器返回227行作为对PASV命令的响应。如果libcurl无法解析该行，则返回此返回码。

CURLE_FTP_CANT_GET_HOST（15）

查找用于新连接的主机的内部故障。

CURLE_HTTP2（16）

在HTTP2框架层中检测到问题。这有点通用，可能是几个问题中的一个，请参阅错误缓冲区了解详细信息。

CURLE_FTP_COULDNT_SET_TYPE（17）

尝试将传输模式设置为二进制或ASCII时收到错误。

CURLE_PARTIAL_FILE（18）

文件传输比预期更短或更长。当服务器首次报告预期的传输大小，然后传递与先前给定大小不匹配的数据时，会发生这种情况。

CURLE_FTP_COULDNT_RETR_FILE（19）

这可能是对'RETR'命令的奇怪回复，也可能是零字节传输完成。

CURLE_QUOTE_ERROR（21）

向远程服务器发送自定义“QUOTE”命令时，其中一个命令返回的错误代码为400或更高（对于FTP）或以其他方式表示命令未成功完成。

CURLE_HTTP_RETURNED_ERROR（22）

如果CURLOPT_FAILONERROR设置为TRUE且HTTP服务器返回> = 400的错误代码，则返回此值。

CURLE_WRITE_ERROR（23）

将接收的数据写入本地文件时发生错误，或者从写回调将错误返回到libcurl。

CURLE_UPLOAD_FAILED（25）

启动上传失败。对于FTP，服务器通常拒绝STOR命令。错误缓冲区通常包含服务器对此的解释。

CURLE_READ_ERROR（26）

读取本地文件或读取回调返回的错误时出现问题。

CURLE_OUT_OF_MEMORY（27）

内存分配请求失败。这是严重的坏事，如果发生这种情况，事情会严重搞乱。

CURLE_OPERATION_TIMEDOUT（28）

操作超时。根据条件达到规定的超时时间。

CURLE_FTP_PORT_FAILED（30）

FTP PORT命令返回错误。当您没有为libcurl指定足够好的地址时，通常会发生这种情况。请参阅CURLOPT_FTPPORT。

CURLE_FTP_COULDNT_USE_REST（31）

FTP REST命令返回错误。如果服务器是理智的，这应该永远不会发生。

CURLE_RANGE_ERROR（33）

服务器不支持或接受范围请求。

CURLE_HTTP_POST_ERROR（34）

这是一个奇怪的错误，主要是由于内部混乱造成的。

CURLE_SSL_CONNECT_ERROR（35）

在SSL / TLS握手中某处出现问题。你真的想要错误缓冲区并在那里读取消息，因为它更精确地指出了问题。可以是证书（文件格式，路径，权限），密码等。

CURLE_BAD_DOWNLOAD_RESUME（36）

无法恢复下载，因为指定的偏移量超出了文件边界。

CURLE_FILE_COULDNT_READ_FILE（37）

无法打开使用FILE：//给出的文件。很可能是因为文件路径无法识别现有文件。你检查过文件权限了吗？

CURLE_LDAP_CANNOT_BIND（38）

LDAP无法绑定。LDAP绑定操作失败。

CURLE_LDAP_SEARCH_FAILED（39）

LDAP搜索失败。

CURLE_FUNCTION_NOT_FOUND（41）

功能未找到。找不到所需的zlib函数。

CURLE_ABORTED_BY_CALLBACK（42）

被回调中止。回调“abort”返回libcurl。

CURLE_BAD_FUNCTION_ARGUMENT（43）

内部错误。使用错误参数调用函数。

CURLE_INTERFACE_FAILED（45）

接口错误。无法使用指定的传出接口。使用CURLOPT_INTERFACE设置用于传出连接的源IP地址的接口。

CURLE_TOO_MANY_REDIRECTS（47）

重定向太多。在执行重定向后，libcurl会达到最大值。使用CURLOPT_MAXREDIRS设置限制。

CURLE_UNKNOWN_OPTION（48）

传递给libcurl的选项无法识别/已知。请参阅相应的文档。这很可能是使用libcurl的程序中的一个问题。错误缓冲区可能包含有关其所涉及的确切选项的更具体信息。

CURLE_TELNET_OPTION_SYNTAX（49）

telnet选项字符串是非法格式化的。

CURLE_PEER_FAILED_VERIFICATION（51）

远程服务器的SSL证书或SSH md5指纹被认为不正常。

CURLE_GOT_NOTHING（52）

没有从服务器返回任何内容，在这种情况下，什么都没有被认为是错误。

CURLE_SSL_ENGINE_NOTFOUND（53）

找不到指定的加密引擎。

CURLE_SSL_ENGINE_SETFAILED（54）

将所选SSL加密引擎设置为默认值失败！

CURLE_SEND_ERROR（55）

发送网络数据失败。

CURLE_RECV_ERROR（56）

接收网络数据失败。

CURLE_SSL_CERTPROBLEM（58）

本地客户端证书的问题。

CURLE_SSL_CIPHER（59）

无法使用指定的密码。

CURLE_SSL_CACERT（60）

无法使用已知的CA证书对对等证书进行身份验证。

CURLE_BAD_CONTENT_ENCODING（61）

无法识别的传输编码。

CURLE_LDAP_INVALID_URL（62）

无效的LDAP URL。

CURLE_FILESIZE_EXCEEDED（63）

超出最大文件大小。

CURLE_USE_SSL_FAILED（64）

请求的FTP SSL级别失败。

CURLE_SEND_FAIL_REWIND（65）

在执行发送操作时，curl必须将数据倒带以重新传输，但倒带操作失败。

CURLE_SSL_ENGINE_INITFAILED（66）

启动SSL引擎失败。

CURLE_LOGIN_DENIED（67）

远程服务器拒绝curl登录（在7.13.1中添加）

CURLE_TFTP_NOTFOUND（68）

在TFTP服务器上找不到文件。

CURLE_TFTP_PERM（69）

TFTP服务器上的权限问题。

CURLE_REMOTE_DISK_FULL（70）

服务器上的磁盘空间不足。

CURLE_TFTP_ILLEGAL（71）

非法的TFTP操作。

CURLE_TFTP_UNKNOWNID（72）

未知的TFTP传输ID。

CURLE_REMOTE_FILE_EXISTS（73）

文件已存在且不会被覆盖。

CURLE_TFTP_NOSUCHUSER（74）

正常运行的TFTP服务器永远不应该返回此错误。

CURLE_CONV_FAILED（75）

字符转换失败。

CURLE_CONV_REQD（76）

呼叫者必须注册转换回调。

CURLE_SSL_CACERT_BADFILE（77）

读取SSL CA证书时出现问题（路径？访问权限？）

CURLE_REMOTE_FILE_NOT_FOUND（78）

URL中引用的资源不存在。

CURLE_SSH（79）

SSH会话期间发生了未指定的错误。

CURLE_SSL_SHUTDOWN_FAILED（80）

无法关闭SSL连接。

CURLE_AGAIN（81）

套接字尚未准备好发送/接收等待，直到它准备就绪并再试一次。此返回代码仅从curl_easy_recv和curl_easy_send返回（在7.18.2中添加）

CURLE_SSL_CRL_BADFILE（82）

无法加载CRL文件（在7.19.0中添加）

CURLE_SSL_ISSUER_ERROR（83）

发行人检查失败（在7.19.0中添加）

CURLE_FTP_PRET_FAILED（84）

FTP服务器根本不理解PRET命令或不支持给定的参数。使用CURLOPT_CUSTOMREQUEST时要小心，在PASV之前也会使用PRET CMD发送自定义LIST命令。（在7.20.0中添加）

CURLE_RTSP_CSEQ_ERROR（85）

RTSP CSeq数字不匹配。

CURLE_RTSP_SESSION_ERROR（86）

RTSP会话标识符不匹配。

CURLE_FTP_BAD_FILE_LIST（87）

无法解析FTP文件列表（在FTP通配符下载期间）。

CURLE_CHUNK_FAILED（88）

块回调报告错误。

CURLE_NO_CONNECTION_AVAILABLE（89）

（仅供内部使用，libcurl永远不会返回）没有可用的连接，会话将排队。（在7.30.0中添加）

CURLE_SSL_PINNEDPUBKEYNOTMATCH（90）

无法匹配CURLOPT_PINNEDPUBLICKEY指定的固定密钥。

CURLE_SSL_INVALIDCERTSTATUS（91）

当询问CURLOPT_SSL_VERIFYSTATUS时，状态返回失败。

CURLE_HTTP2_STREAM（92）

HTTP / 2成帧层中的流错误。

CURLE_RECURSIVE_API_CALL（93）

从回调内部调用了API函数。

CURLE_OBSOLETE *

永远不会返回这些错误代码。它们用于旧的libcurl版本，目前尚未使用。