Guzzle PHP 7.0 Documentation

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

摘要

Guzzle 是一个 PHP HTTP 客户端，简化了 HTTP 请求的发送和与 Web 服务的集成。它提供了构建查询字符串、POST 请求、流式上传和下载、使用 HTTP Cookie 等功能。Guzzle 支持同步和异步请求，使用 PSR-7 接口，抽象了底层 HTTP 传输，使其不依赖特定环境或传输方式。Guzzle 还提供了中间件系统以增强客户端行为。安装推荐使用 Composer，Guzzle 不再强制依赖 cURL，但并发请求仍需 cURL。

AI总结

**Guzzle PHP 7.0 Documentation 总结**

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

**关键信息：**

1. **主要功能：**
- 构建查询字符串、POST 请求、流式上传和下载、使用 HTTP Cookie、上传 JSON 数据等。
- 支持同步和异步请求，使用相同的接口。
- 使用 PSR-7 接口，兼容其他 PSR-7 库。
- 不依赖于特定的 HTTP 传输（如 cURL、PHP 流、套接字等），代码具有环境无关性。
- 通过中间件系统扩展和组合客户端行为。

2. **安装与要求：**
- 要求 PHP 5.5.0 及以上版本。
- 推荐使用 Composer 安装：`composer require guzzlehttp/guzzle:^7.0`。
- 无需 cURL 即可发送请求，但并发请求仍需要 cURL。

3. **请求与响应：**
- 支持 GET、POST 等请求方法，可通过 `request` 方法发送请求。
- 响应对象包含状态码、头部信息和响应体。
- 异步请求通过 `sendAsync` 方法实现，支持 Promise 模式。

4. **流处理：**
- 支持从字符串、迭代器、资源等创建流。
- 提供流元数据访问和自定义流装饰器（如 `AppendStream`、`BufferStream` 等）。

5. **请求选项：**
- `decode_content`：控制是否自动解码响应体（如 gzip、deflate）。
- `delay`：设置请求发送前的延迟时间。
- `progress`：定义传输进度的回调函数。
- `stream`：设置为 `true` 以流式传输响应，而不是一次性下载。

6. **SSL 与认证：**
- 支持 SSL 密钥和证书配置。
- 提供基本认证、摘要认证和 NTLM 认证。

**总结：**
Guzzle 是一个功能强大且灵活的 PHP HTTP 客户端，适用于各种 HTTP 请求场景。它通过 PSR-7 标准、中间件系统和流处理等功能，简化了 HTTP 请求的发送和处理，同时提供了丰富的配置选项来满足不同需求。