PHP 中的cURL库 - i'm jackey

概述

在设计之初， cURL （Client URL Library ）是一种作为使用 URL 语法传输数据的命令行工具。通过 cURL 库，我们可以在 PHP 脚本中自由地使用某种协议来获取或者提交数据，比如获取 HTTP 请求数据。简单的来说，cURL 是客户端向服务器请求资源的工具。

curl的优势

在 PHP 中，想要获取某个 URL 的内容其实很简单，有多种实现方法，比如使用file_get_contents() 函数：

Source code

<?php
$content = file_get_contents("https://ijackey.com");
var_dump($content);

虽然 file_get_contents() 函数使用起来很方便，但是不够灵活，也没法进行错误处理。在一些复杂的请求中，不能够设置请求头、 Cookie 、代理、认证等相关信息，更不能向某个服务器提交表单数据，上传文件。

cURl 库不但支持丰富的网络协议，而且提供了设置各种 URL 请求参数的方法，功能强大。 cURL 的使用场景有很多，比如访问网页资源，获取 WebService 接口数据、下载FTP 服务器文件。

curl命令行常见用法

1.获取页面内容
当我们不加任何选项使用 curl 时，默认会发送 GET 请求来获取链接内容到标准输出。

curl http://www.baidu.com

2.显示 HTTP 头
如果我们只想要显示 HTTP 头，而不显示文件内容，可以使用 -I 选项：

curl -I http://www.baidu.com

输出为：

HTTP/1.1 200 OK
Server: nginx/1.10.3
Date: Thu, 11 May 2017 08:24:45 GMT
Content-Type: text/html; charset=utf-8
Content-Length: 24206
Connection: keep-alive
X-Powered-By: Express
Cache-Control: public, max-age=0
ETag: W/"5e8e-Yw5ZdnVVly9/aEnMX7fVXQ"
Vary: Accept-Encoding

也可以同时显示 HTTP 头和文件内容，使用 -i 选项：

curl -i http://www.baidu.com

输出为：

HTTP/1.1 200 OK
Server: nginx/1.10.3
Date: Thu, 11 May 2017 08:25:46 GMT
Content-Type: text/html; charset=utf-8
Content-Length: 24206
Connection: keep-alive
X-Powered-By: Express
Cache-Control: public, max-age=0
ETag: W/"5e8e-Yw5ZdnVVly9/aEnMX7fVXQ"
Vary: Accept-Encoding
<!DOCTYPE html>
<html lang="en">
......
</html>

3.将链接保存到文件
我们可以使用 > 符号将输出重定向到本地文件中。

curl http://www.codebelief.com > index.html

也可以通过 curl 自带的 -o/-O 选项将内容保存到文件中。

-o（小写的 o）：结果会被保存到命令行中提供的文件名
-O（大写的 O）：URL 中的文件名会被用作保存输出的文件名
curl -o index.html http://www.codebelief.com
curl -O http://www.codebelief.com/page/2/

4.同时下载多个文件
我们可以使用 -o 或 -O 选项来同时指定多个链接，按照以下格式编写命令：

curl -O http://www.codebelief.com/page/2/ -O http://www.codebelief.com/page/3/

或者：

curl -o page1.html http://www.codebelief.com/page/1/ -o page2.html http://www.codebelief.com/page/2/

5.使用 -A 自定义 User-Agent
我们可以使用 -A 来自定义用户代理，例如下面的命令将伪装成安卓火狐浏览器对网页进行请求：

curl -A “Mozilla/5.0 (Android; Mobile; rv:35.0) Gecko/35.0 Firefox/35.0” http://www.baidu.com

6.使用 -H 自定义 header
当我们需要传递特定的 header 的时候，可以仿照以下命令来写：

curl -H “Referer: www.example.com” -H “User-Agent: Custom-User-Agent” http://www.baidu.com

可以看到，当我们使用 -H 来自定义 User-Agent 时，需要使用 “User-Agent:xxx” 的格式。
我们能够直接在 header 中传递 Cookie，格式与上面的例子一样：

curl -H “Cookie: JSESSIONID=D0112A5063D938586B659EF8F939BE24” http://www.example.com

另一种方式会在下面介绍。

7.使用 -c 保存 Cookie
当我们使用 cURL 访问页面的时候，默认是不会保存 Cookie 的。有些情况下我们希望保存 Cookie 以便下次访问时使用。例如登陆了某个网站，我们希望再次访问该网站时保持登陆的状态，这时就可以现将登陆时的 Cookie 保存起来，下次访问时再读取。
-c 后面跟上要保存的文件名。

curl -c "cookie-example" http://www.baidu.com

8.使用 -b 读取 Cookie

curl -b “cookie-example” http://www.example.com

即 -b 后面既可以是 Cookie 字符串，也可以是保存了 Cookie 的文件名。

9.使用 -d 发送 POST 请求
我们以登陆网页为例来进行说明使用 cURL 发送 POST 请求的方法。假设有一个登录页面www.example.com/login，只需要提交用户名和密码便可登录。我们可以使用 cURL 来完成这一 POST 请求，
-d 用于指定发送的数据，-X 用于指定发送数据的方式：

curl -d “userName=tom&passwd=123456” -X POST http://www.example.com/login

在使用 -d 的情况下，如果省略 -X，则默认为 POST 方式：

curl -d “userName=tom&passwd=123456” http://www.example.com/login

10.强制使用 GET 方式
发送数据时，不仅可以使用 POST 方式，也可以使用 GET 方式，例如：

curl -d “somedata” -X GET http://www.example.com/api

或者使用 -G 选项：

curl -d “somedata” -G http://www.example.com/api

11.带 Cookie 登录
当然，如果我们再次访问该网站，仍然会变成未登录的状态。我们可以用之前提到的方法保存 Cookie，在每次访问网站时都带上该 Cookie 以保持登录状态。

curl -c “cookie-login” -d “userName=tom&passwd=123456” http://www.example.com/login

再次访问该网站时，使用以下命令：

curl -b “cookie-login” http://www.example.com/login

这样，就能保持访问的是登录后的页面了。

curl库的使用

基本步骤

要使用 cURL 来发送 URL 请求，步骤大体分为以下四步：

初始化 cURL 会话;
设置请求选项;
执行 cURL 会话;
关闭 cURL 会话;

Source code

// 1. 初始化 cURL 会话
$ch = curl_init();
// 2. 设置请求选项
curl_setopt($ch, CURLOPT_URL, "https://segmentfault.com");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, TRUE); # 获取的信息以字符串返
回，而不是直接输出
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, 0); # 禁止 cURL 验证对等证
书，从而支持 HTTPS 访问
// 3. 执行 cURL 会话
$response = curl_exec($ch);
var_dump($response);
// 4. 关闭 cURL 会话
curl_close($ch);

cURL 主要通过 curl_setopt() 函数设置请求选项，具体的每个选项说明请见
https://secure.php.net/manual/zh/function.curl-setopt.php

错误处理

通过 curl_error() 函数可以查看 cURL 会话错误详情，而 curl_getinfo() 函数可以查看响应信息。因此，通过这两个函数我们可以实现一个简单的错误处理程序，比如我们现在访问一个不存在的 URL 地址：

Source code

<?php
// 1. 初始化 cURL 会话
$ch = curl_init();
// 2. 设置请求选项
curl_setopt($ch, CURLOPT_URL, "https://segmentfault.com/test.php");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1); # 获取的信息以字符串返回，而不是直接输出
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, 0); # 禁止 cURL 验证对等证书，从而支持 HTTPS 访问
// 3. 执行 cURL 会话
$response = curl_exec($ch);
if ($response === FALSE) {
    echo "cURL connert error: " . curl_error($ch);
    exit;
}
$info = curl_getinfo($ch);
if ($info['http_code'] == 404) {
    echo 'HTTP 404';
    exit;
}
var_dump($response);
// 4. 关闭 cURL 会话
curl_close($ch);

常见案例

POST请求

Source code

<?php
function curl_post($url, $data)
{
    $ch = curl_init();
    curl_setopt_array($ch, [
        CURLOPT_URL => $url, 
        CURLOPT_RETURNTRANSFER => 1, # 获取的信息以字符串返回
        CURLOPT_POST => 1, # 发送 POST 请求
        CURLOPT_POSTFIELDS => $data, # POST 请求数据
    ]);
    $response = curl_exec($ch);
    curl_close($ch);
    return $response;
}
 
$url = 'http://localhost/test.php';
$data = ['id' => 1, 'username' => 'jochen'];
echo curl_post($url, $data);

cURL 封装库

curl class (https://github.com/php-curl-class/php-curl-class)是一个编写得很好的 cURL 封装库，它可以非常方便地发送 HTTP 请求并与任何类型的 Web API 集成。PHP Curl Class 封装库适用于 PHP 5.3，5.4，5.5，5.6，7.0，7.1 和 HHVM。这个库是众所周知的，并提供了一个非常简单的语法：

Source code

<?php
require __DIR__ . '/vendor/autoload.php';
 
use \Curl\Curl;
 
$curl = new Curl();
$curl->get('https://www.example.com/');
if ($curl->error) {
    echo 'Error: ' . $curl->errorCode . ': ' . $curl->errorMessage . "\n";
} else {
    echo 'Response:' . "\n";
    var_dump($curl->response);
}

概述

curl的优势

curl命令行常见用法

curl库的使用

基本步骤

错误处理

常见案例

POST请求

cURL 封装库

发表回复 取消回复

发表回复取消回复