Guzzle PHP 6.5 Documentation

• 语言: 英语
• 格式: .epub
• 来源: docs.guzzlephp.org

摘要

Guzzle 是一个 PHP HTTP 客户端，简化了 HTTP 请求的发送和与 Web 服务的集成。它提供了构建查询字符串、POST 请求、流式传输大文件、使用 HTTP Cookie 和上传 JSON 数据等功能，并支持同步和异步请求。Guzzle 使用 PSR-7 接口处理请求、响应和流，并抽象了底层的 HTTP 传输机制，使其不依赖于特定的传输方式（如 cURL 或 PHP 流）。Guzzle 的中间件系统允许扩展和组合客户端行为。安装 Guzzle 推荐使用 Composer，并且可以通过设置版本要求为 ~6.0@dev 来跟踪最新开发版本。Guzzle 遵循 MIT 许可证，并支持 PHP 5.5 及以上版本。贡献代码时需遵循 PSR-1、PSR-2、PSR-4 和 PSR-7 标准，并包含单元测试。Guzzle 支持自定义 HTTP 处理器，并提供了处理安全漏洞的机制。

AI总结

**Guzzle PHP 6.5 文档总结**

**核心观点：**
Guzzle 是一个 PHP HTTP 客户端，简化了 HTTP 请求的发送，并易于与 Web 服务集成。它支持同步和异步请求，使用 PSR-7 接口，抽象了底层 HTTP 传输，并提供了中间件系统来增强和组合客户端行为。

**关键信息：**

1. **主要功能：**
- 支持构建查询字符串、POST 请求、流式上传和下载、使用 HTTP Cookie、上传 JSON 数据等。
- 使用 PSR-7 接口，兼容其他 PSR-7 库。
- 抽象底层 HTTP 传输，代码不依赖 cURL、PHP 流、套接字或非阻塞事件循环。

2. **示例代码：**
- 发送同步请求：

     $client = new GuzzleHttp\Client();
     $res = $client->request('GET', 'https://api.github.com/user', ['auth' => ['user', 'pass']]);
     echo $res->getStatusCode(); // "200"

- 发送异步请求：

     $promise = $client->sendAsync($request)->then(function ($response) {
         echo 'I completed! ' . $response->getBody();
     });
     $promise->wait();

3. **安装与依赖：**
- 推荐使用 Composer 安装：

     { "require": { "guzzlehttp/guzzle": "~6.0" } }

- 需要 PHP 5.5.0 或更高版本。

4. **中间件系统：**
- 允许通过中间件增强客户端行为，默认中间件包括处理 HTTP 错误、重定向、Cookies 和准备请求体。

5. **安全与贡献：**
- 使用 MIT 许可证。
- 贡献需遵循 PSR-1, PSR-2, PSR-4, 和 PSR-7 标准，提交的 Pull Request 需包含单元测试。
- 发现安全漏洞可通过 [e-mail] 报告。

**总结：**
Guzzle 是一个功能强大且灵活的 PHP HTTP 客户端，适用于各种 HTTP 请求场景，支持同步和异步操作，使用 PSR-7 标准，并通过中间件系统提供高度可定制性。