PHP的HTTP客户端：Guzzle

什么是 Guzzle？

Guzzle 是一个功能强大且流行的 PHP 库，用于处理 HTTP 请求。它提供了一个便捷的接口，用于发送 GET、POST、PUT、DELETE 等请求、处理响应以及管理会话。Guzzle 被认为是 PHP 社区中处理 HTTP 的事实标准。

为什么需要 Guzzle？

与内置的 PHP 函数（如 file_get_contents() 或 curl）不同，Guzzle 提供了面向对象的方法、自动 cookie 管理、流支持、异步请求以及便捷的错误处理。该库非常适合与 REST API 集成、网页抓取、文件上传以及处理 OAuth。

安装

通过 Composer 进行安装：

composer require guzzlehttp/guzzle

请确保您已安装 PHP 8.1 或更高版本（适用于最新版本）。

主要功能

发送请求： GET、POST、PUT、DELETE、PATCH 等方法。
流式数据传输： 处理大文件而无需加载到内存。
异步请求： 使用 Promises 并行发送多个请求。
中间件： 拦截和修改请求/响应（日志记录、缓存、身份验证）。
错误处理： 针对不同 HTTP 状态码的详细异常。
Cookie 会话： 自动保存和发送 cookies。

代码示例

require 'vendor/autoload.php';

use GuzzleHttp\\Client;

$client = new Client([    'base_uri' => 'https://api.example.com',    'timeout'  => 10.0,]);

// 带参数的 GET 请求$response = $client->request('GET', '/users', [    'query' => ['page' => 1, 'limit' => 10]]);

echo $response->getStatusCode(); // 200echo $response->getBody(); // JSON 响应

// 带 JSON 的 POST 请求$response = $client->post('/users', [    'json' => [        'name' => 'John',        'email' => 'john@example.com'    ]]);

// 异步请求$promise = $client->getAsync('/data');$promise->then(    function ($response) {        echo '完成: ' . $response->getStatusCode();    },    function ($exception) {        echo '错误: ' . $exception->getMessage();    });$promise->wait();